KappS Base de connaissances · Blog

Notifications développeur en temps réel Google Play en 2026

Blog Tutoriel

Les notifications développeur en temps réel (RTDN) sont le moyen par lequel Google Play informe votre backend qu’un événement s’est produit sur un achat. Il n’y a ni tableau de bord de webhooks ni clé API par application : Play publie un message dans un topic Cloud Pub/Sub au sein de votre propre projet Google Cloud, et votre serveur le reçoit soit par push HTTPS, soit par pull. Si vos opérations de revenus reposent encore sur des tâches planifiées qui interrogent l’API Developer, RTDN est la mise à niveau à faire — la documentation de Google précise qu’une utilisation inefficace de l’API Play Developer « peut entraîner des restrictions de quota d’API ».

Ce tutoriel suit l’ordre réel de votre travail : créer le sujet, accorder les droits de publication Play, choisir push ou pull, activer les notifications dans Play Console, puis décoder la charge utile et agir en conséquence. Chaque nom de champ, type de notification et étape de console ci-dessous provient des deux pages officielles de Google, citées à la fin.

Ce qu’est RTDN, en une ligne : un message à chaque changement d’état d’achat — environ 1 Ko par notification, environ 2 Ko par publication plus pull — et une obligation permanente d’appeler ensuite l’Google Play Developer API, car la notification « ne vous donne pas d’informations complètes sur l’achat ».

Étape 1 — Créez le topic Pub/Sub dans votre propre projet GCP

RTDN se configure par application Android, mais la couche de messagerie vous appartient. Il vous faut un projet Google Cloud avec l'API Cloud Pub/Sub activée, et un topic sur lequel Play publiera. Vous pouvez réutiliser le projet que vous utilisez déjà pour l'API Play Developer ou en créer un distinct : pour plusieurs applications, vous devez utiliser le même projet Google Cloud pour l'API Play Developer, mais chaque application peut publier vers son propre projet.

Dimensionnez avant de construire. La partie données d'une notification représente environ 1 Ko par requête, et chaque publication suivie d'un pull constitue une requête distincte — environ 2 Ko par notification. Le volume mensuel dépend de vos cycles de facturation et du comportement des utilisateurs, mais prévoyez au moins une notification par utilisateur et par cycle de facturation, puis vérifiez la tarification et les quotas Pub/Sub pour ce chiffre.

Étape 2 — Donnez à Google Play l’autorisation de publier

Un tout nouveau sujet rejette silencieusement les publications Play tant que vous n’avez pas accordé l’accès, et c’est l’étape que tout le monde oublie. Dans la console Cloud Google : sélectionnez le projet, ouvrez Pub/Sub, trouvez votre sujet, ouvrez le détail de ses autorisations, puis ajoutez le compte de service

google-play-developer-notifications@system.gserviceaccount.com

et accordez-lui le rôle Pub/Sub Publisher. Enregistrez pour terminer la configuration du topic. Une subtilité en entreprise : si la configuration de partage restreint au domaine de votre organisation bloque l’attribution, vous devez ajouter une exception pour ce compte de service Google Play avant que Play puisse publier quoi que ce soit.

Étape 3 — choisir push ou pull pour l’abonnement

Un topic n’est pas une boîte aux lettres que l’on peut lire ; il vous faut un abonnement qui y soit rattaché. Un abonnement push fait envoyer par Cloud Pub/Sub des requêtes HTTPS à votre backend sécurisé. Un abonnement pull exige que votre backend initie des requêtes vers Pub/Sub et récupère les messages. Recommandation de Google pour les RTDN : en cas de doute, utilisez le push, « car il est généralement plus simple à implémenter » ; le pull est couramment utilisé pour optimiser l’utilisation des ressources lorsqu’un grand nombre de messages est traité.

Deux règles opérationnelles découlent de ce choix. Pour le pull, accusez réception de chaque message récupéré, sinon Pub/Sub continuera de le redélivrer. Pour le push, un code de réponse réussi de votre endpoint fait office d’accusé de réception — un endpoint lent ou défaillant entraîne une livraison répétée.

Étape 4 — activez RTDN dans Play Console et envoyez un test

  1. Ouvrez le Google Play Console, sélectionnez votre application et allez dans Monétiser → Configuration de la monétisation.
  2. Dans la section Notifications développeur en temps réel en haut de cette page, cochez Activer les notifications en temps réel.
  3. Dans le champ Nom du sujet, saisissez le nom complet du sujet au format projects/{project_id}/topics/{topic_name}.
  4. Cliquez sur Envoyer un message de test. Pour le pull, ouvrez l’abonnement dans Cloud Console, cliquez sur Afficher les messages et tirez ; puis accusez réception. Pour le push, vérifiez que le message de test a atteint votre point de terminaison.
  5. Choisissez la portée des notifications. Abonnements et tous les achats annulés ne vous donne que les événements d’abonnement et d’achat annulé. Toutes les notifications pour les abonnements et les produits ponctuels envoie aussi les événements d’achat de produits ponctuels comme ONE_TIME_PRODUCT_PURCHASED et ONE_TIME_PRODUCT_CANCELED.
  6. Cliquez sur Enregistrer les modifications.

Lorsque la publication de test échoue, la console affiche une erreur et il n’existe que deux causes réalistes : le nom du topic est erroné, ou google-play-developer-notifications@system.gserviceaccount.com ne dispose pas du rôle Pub/Sub Publisher sur le topic. Corrigez l’autorisation, pas l’application.

Ce que contient réellement un message

Chaque publication sur le topic a la même enveloppe : une map attributes, un champ data encodé en base64, un messageId et le chemin subscription. Décodez data et vous obtenez un DeveloperNotification portant quatre informations — version, packageName, eventTimeMillis — plus exactement un champ de charge utile. Ces champs de charge utile sont mutuellement exclusifs : subscriptionNotification, oneTimeProductNotification, voidedPurchaseNotification ou testNotification.

messageId est un identifiant unique pour la notification, et le guide de référence recommande de vérifier cette unicité afin de ne pas traiter de notifications en double ni effectuer d’appels redondants à l’API backend — ce qui gaspille précisément le quota d’API que RTDN existe pour protéger.

Types de notifications d’abonnement

Une subscriptionNotification porte un entier notificationType, un purchaseToken et sa propre version. L’ensemble actuel :

  • 1 — SUBSCRIPTION_RECOVERED : récupéré après une suspension de compte, ou repris après une pause.
  • 2 — SUBSCRIPTION_RENEWED : un abonnement actif a été renouvelé.
  • 3 — SUBSCRIPTION_CANCELED : annulé volontairement ou involontairement ; pour une annulation volontaire, il est envoyé lorsque l'utilisateur annule.
  • 4 — SUBSCRIPTION_PURCHASED : un nouvel abonnement a été acheté.
  • 5 — SUBSCRIPTION_ON_HOLD : passage en suspension de compte, si vous l'avez activée.
  • 6 — SUBSCRIPTION_IN_GRACE_PERIOD : entrée en délai de grâce, si vous l'avez activé.
  • 7 — SUBSCRIPTION_RESTARTED : l’utilisateur a rétabli un abonnement annulé depuis Play → Compte → Abonnements avant son expiration.
  • 9 — SUBSCRIPTION_DEFERRED : la période de récurrence a été prolongée.
  • 10 — SUBSCRIPTION_PAUSED / 11 — SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED : abonnement en pause, ou calendrier de pause modifié.
  • 12 — SUBSCRIPTION_REVOKED : révoqué avant l’heure d’expiration.
  • 13 — SUBSCRIPTION_EXPIRED : l’abonnement a expiré.
  • 17 — SUBSCRIPTION_ITEMS_CHANGED : un élément d'un lot d'abonnements a changé.
  • 18 — SUBSCRIPTION_CANCELLATION_SCHEDULED : annulation programmée pour la fin d’une période d’engagement par versements.
  • 19 — SUBSCRIPTION_PRICE_CHANGE_UPDATED : les détails du changement de prix d'un élément d'abonnement ont été mis à jour.
  • 20 — SUBSCRIPTION_PENDING_PURCHASE_CANCELED : une transaction d'abonnement en attente a été annulée.
  • 22 — SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED : la période de consentement à l’augmentation de prix a commencé, ou l’utilisateur a consenti ; envoyé uniquement dans les régions où l’augmentation de prix est requise.

Le type 8 (SUBSCRIPTION_PRICE_CHANGE_CONFIRMED) est marqué comme déprécié dans la référence, donc ne bâtissez pas de nouvelle logique dessus. Notez aussi que ces numéros ne forment pas un cycle de vie que vous pouvez déduire — l'événement vous dit que l'état a changé, jamais l'état résultant.

Notifications de produits ponctuels

Envoyé uniquement si vous avez sélectionné le périmètre élargi. Une oneTimeProductNotification ajoute un champ sku au jeton, avec deux types : 1 — ONE_TIME_PRODUCT_PURCHASED (un produit ponctuel a été acheté avec succès) et 2 — ONE_TIME_PRODUCT_CANCELED (un achat ponctuel en attente a été annulé par l’utilisateur). Les deux cas nécessitent toujours un appel à l’API Developer, car une notification d’achat ne dit rien sur le fait que vous avez déjà consommé ou reconnu le produit.

Achats annulés et le champ refundType

Une voidedPurchaseNotification est la RTDN à laquelle les équipes revenus accordent le plus d’importance, et en 2026 elle transporte bien plus qu’un jeton. La charge utile contient purchaseToken, orderId, productType et refundType. productType vaut 1 pour un abonnement ou 2 pour un achat ponctuel. refundType vaut 1 — REFUND_TYPE_FULL_REFUND ou 2 — REFUND_TYPE_QUANTITY_BASED_PARTIAL_REFUND, ce dernier ne s’appliquant qu’aux achats en plusieurs quantités, qui peuvent être partiellement annulés plusieurs fois ; une fois la quantité totale restante remboursée, le type est signalé comme un remboursement intégral.

Le guide de référence précise clairement que, pour identifier l’achat et la commande à ajuster au niveau des droits, la notification elle-même suffit — et que l’Google Play API Voided Purchases en est le complément en mode pull, renvoyant les données d’achats annulés pour une plage d’horodatages. Pour les remboursements partiels portant sur plusieurs quantités, le champ refundableQuantity de purchases.productsv2 indique combien de produits achetés ne sont pas encore annulés. Cela s’articule directement avec les changements de comptabilisation des contestations et remboursements abordés dans le guide des remboursements et contestations Play 2026.

Règles côté serveur pour un pipeline correct

  • Traitez la notification comme une question, pas comme une réponse. Appelez l’API Developer après chaque RTDN pour obtenir le statut complet avant d’accorder, de prolonger ou de révoquer un droit.
  • Dédupliquez sur messageId. Pub/Sub livre au moins une fois ; un traitement en double signifie des appels API en double et des transitions d’état en double.
  • Accusez toujours réception, puis traitez. Pull : accusez réception des messages tirés. Push : renvoyez un code de succès. Si le traitement dépasse l’accusé de réception, acceptez la redélivrance et rendez le gestionnaire idempotent.
  • Prévoyez plusieurs événements par utilisateur. Un seul purchaseToken peut générer des notifications purchased, cancelled puis expired pour le même abonné — le gestionnaire doit pouvoir s'exécuter de façon répétée sans risque.
  • Ne faites pas d’interrogation répétée pour compenser. Interroger l’API Developer en parallèle des RTDN est le mode de défaillance qui déclenche des restrictions de quota.

Vérification de votre configuration

Le Envoyer un message de test de la console est la preuve de bout en bout la plus rapide : si vous avez un abonnement associé, vous devriez le recevoir. Un corps testNotification ne contient qu’un champ version, c’est donc une charge utile sûre à tester dans la suite de tests de votre gestionnaire. Sans backend pour l’instant, utilisez la ligne de commande gcloud pour extraire le message de l’abonnement — et pensez à l’acquitter. Un pipeline sain se manifeste par un flux d’événements dont le packageName correspond à votre app et dont le eventTimeMillis suit l’activité des abonnés en direct.

Une note de planification : le travail RTDN côté serveur coïncide avec l’échéance de la Billing Library côté client. Toutes les nouvelles applications et mises à jour doivent utiliser la Billing Library version 8 ou ultérieure, avec une voie d’extension jusqu’au 1er novembre 2026 — et la vérification serveur qui consomme les RTDN doit être prête en même temps.

Vous gérez des comptes développeur à grande échelle ? Nous prenons en charge le volet opérationnel.

Cliquez pour choisir un fichier · clic droit → Coller, ou appuyez sur Ctrl/⌘+V pour coller une capture d’écran

Vous pouvez aussi glisser un fichier sur cette zone.

Nous répondons à l’e-mail que vous indiquez. Vos données restent chez KappS.

✔ Soumis

Nous avons bien reçu votre message et vous répondrons sous 24 heures.


← Retour à la modification