Guide de référence des notifications en temps réel pour les développeurs

Cette rubrique liste et décrit les types de notifications en temps réel pour les développeurs que Google Play peut envoyer.

Encodage

Chaque publication effectuée sur un sujet Cloud Pub/Sub ne contient qu'un seul champ de données encodé en base64.

{
  "message": {
    "attributes": {
      "key": "value"
    },
    "data": "eyAidmVyc2lvbiI6IHN0cmluZywgInBhY2thZ2VOYW1lIjogc3RyaW5nLCAiZXZlbnRUaW1lTWlsbGlzIjogbG9uZywgIm9uZVRpbWVQcm9kdWN0Tm90aWZpY2F0aW9uIjogT25lVGltZVByb2R1Y3ROb3RpZmljYXRpb24sICJzdWJzY3JpcHRpb25Ob3RpZmljYXRpb24iOiBTdWJzY3JpcHRpb25Ob3RpZmljYXRpb24sICJ0ZXN0Tm90aWZpY2F0aW9uIjogVGVzdE5vdGlmaWNhdGlvbiB9",
    "messageId": "136969346945"
  },
  "subscription": "projects/myproject/subscriptions/mysubscription"
}

Après avoir décodé le champ de données encodé en base64, DeveloperNotification contient les champs suivants :

{
  "version": string,
  "packageName": string,
  "eventTimeMillis": long,
  "oneTimeProductNotification": OneTimeProductNotification,
  "subscriptionNotification": SubscriptionNotification,
  "voidedPurchaseNotification": VoidedPurchaseNotification,
  "testNotification": TestNotification
}

Ces champs sont décrits dans le tableau suivant.

Nom de la propriété Valeur Description
version string Version de cette notification. Dans un premier temps, la version correspond à "1.0". Cette version est différente des autres champs de version.
packageName string Nom de package de l'application auquel cette notification se rapporte (par exemple, "com.exemple.XXX").
eventTimeMillis long Horodatage de l'événement (en millisecondes à partir de la date initiale de référence du système d'exploitation).
subscriptionNotification SubscriptionNotification Si ce champ est présent, cette notification est liée à un abonnement. Ce champ contient des informations supplémentaires sur l'abonnement. Notez que les champs oneTimeProductNotification, voidedPurchaseNotification et testNotification s'excluent mutuellement.
oneTimeProductNotification OneTimeProductNotification Si ce champ est présent, cette notification est associée à un achat ponctuel, et ce champ contient des informations supplémentaires concernant l'achat. Notez que les champs subscriptionNotification, voidedPurchaseNotification et testNotification s'excluent mutuellement.
voidedPurchaseNotification VoidedPurchaseNotification Si ce champ est présent, cette notification est liée à un achat annulé, et ce champ contient des informations supplémentaires la concernant. Notez que les champs oneTimeProductNotification, subscriptionNotification et testNotification s'excluent mutuellement.
testNotification TestNotification Si ce champ est présent, cette notification est liée à une publication test. Elle n'est envoyée que via la Google Play Console. Notez que les champs oneTimeProductNotification, subscriptionNotification et voidedPurchaseNotification s'excluent mutuellement.

SubscriptionNotification

SubscriptionNotification contient les champs suivants :

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string,
  "subscriptionId": string
}
Nom de la propriété Valeur Description
version string Version de cette notification. Dans un premier temps, la version correspond à "1.0". Cette version est différente des autres champs de version.
notificationType int Le type de notification d'un abonnemment peut avoir les valeurs suivantes :
  • (1) SUBSCRIPTION_RECOVERED : l'abonnement a été récupéré suite à un blocage de compte.
  • (2) SUBSCRIPTION_RENEWED : un abonnement actif a été renouvelé.
  • (3) SUBSCRIPTION_CANCELED : un abonnement a été résilié volontairement ou involontairement. Pour une résiliation volontaire, cette notification est envoyée au moment de la résiliation.
  • (4) SUBSCRIPTION_PURCHASED : un nouvel abonnement a été souscrit.
  • (5) SUBSCRIPTION_ON_HOLD : un abonnement vient de passer à l'état "blocage de compte" (le cas échéant).
  • (6) SUBSCRIPTION_IN_GRACE_PERIOD : l'abonnement est passé en période de grâce (le cas échéant).
  • (7) SUBSCRIPTION_RESTARTED : l'utilisateur a restauré son abonnement depuis Play > Compte > Abonnements. L'abonnement a été résilié, mais n'a pas encore expiré lorsque l'utilisateur effectue une restauration. Pour en savoir plus, consultez la section Restaurations.
  • (8) SUBSCRIPTION_PRICE_CHANGE_CONFIRMED : l'utilisateur a confirmé le changement de prix de son abonnement.
  • (9) SUBSCRIPTION_DEFERRED : La durée de récurrence d'un abonnement a été prolongée.
  • (10) SUBSCRIPTION_PAUSED : un abonnement a été suspendu.
  • (11) SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED : la planification de la suspension de l'abonnement a été modifiée.
  • (12) SUBSCRIPTION_REVOKED : l'utilisateur a révoqué un abonnement avant la date d'expiration.
  • (13) SUBSCRIPTION_EXPIRED : un abonnement a expiré.
purchaseToken string Jeton fourni à l'appareil de l'utilisateur lors de la souscription de l'abonnement.
subscriptionId string ID produit de l'abonnement acheté (par exemple, "mensuel001").

Exemple

Voici un exemple de notification concernant un nouvel abonnement :

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503349566168",
  "subscriptionNotification":
  {
    "version":"1.0",
    "notificationType":4,
    "purchaseToken":"PURCHASE_TOKEN",
    "subscriptionId":"monthly001"
  }
}

OneTimeProductNotification

OneTimeProductNotification contient les champs suivants :

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string,
  "sku": string
}
Nom de la propriété Valeur Description
version string Version de cette notification. Dans un premier temps, la version correspond à "1.0". Cette version est différente des autres champs de version.
notificationType int Type de notification. Les valeurs suivantes sont possibles :
  • (1) ONE_TIME_PRODUCT_PURCHASED : un produit ponctuel a bien été acheté par un utilisateur.
  • (2) ONE_TIME_PRODUCT_CANCELED : un achat ponctuel en attente a été annulé par l'utilisateur.
purchaseToken string Jeton fourni à l'appareil de l'utilisateur lors de l'achat.
sku string ID du produit ponctuel acheté (par exemple, "épée_001")

Exemple

Voici un exemple de notification concernant un nouvel achat ponctuel :

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503349566168",
  "oneTimeProductNotification":
  {
    "version":"1.0",
    "notificationType":1,
    "purchaseToken":"PURCHASE_TOKEN",
    "sku":"my.sku"
  }
}

VoidedPurchaseNotification

VoidedPurchaseNotification contient les champs suivants :

Nom de la propriété

Valeur

Description

purchaseToken

string

Jeton associé à l'achat annulé. Ces informations sont fournies au développeur lorsqu'un nouvel achat est effectué.

orderId

string

ID de commande unique associé à la transaction annulée. Pour les achats uniques, il s'agit du seul ID de commande généré pour l'achat. Pour les abonnements à renouvellement automatique, un nouvel ID de commande est généré pour chaque transaction de renouvellement.

productType

int

Le productType d'un achat annulé peut avoir les valeurs suivantes :

  • (1) PRODUCT_TYPE_SUBSCRIPTION : un achat d'abonnement a été annulé.
  • (2) PRODUCT_TYPE_ONE_TIME : un achat unique a été annulé.

refundType

int

Le refundType d'un achat annulé peut avoir les valeurs suivantes :

  • (1) REFUND_TYPE_FULL_REFUND : l'achat a été totalement annulé.
  • (2) REFUND_TYPE_QUANTITY_BASED_PARTIAL_REFUND : l'achat a été partiellement annulé par un remboursement partiel basé sur la quantité, applicable uniquement aux achats de quantités multiples. Un achat peut être partiellement annulé plusieurs fois.

Notez que lorsque la quantité totale restante d'un achat de quantités multiples est remboursée, la valeur de refundType sera de REFUND_TYPE_FULL_REFUND.

Exemple

Voici un exemple de notification concernant un nouvel achat annulé :

{
  "version":"1.0",
  "packageName":"com.some.app",
  "eventTimeMillis":"1503349566168",
  "voidedPurchaseNotification":
  {
    "purchaseToken":"PURCHASE_TOKEN",
    "orderId":"GS.0000-0000-0000",
    "productType":1
    "refundType":1
  }
}

Utiliser VoidedPurchaseNotification

Lorsque votre client RTDN reçoit une notification VoidedPurchaseNotification, tenez compte des informations suivantes :

  • packageName : identifie l'application.
  • eventTimeMillis : informe le développeur de l'heure à laquelle le changement d'état s'est produit.
  • purchaseToken : jeton fourni à l'appareil de l'utilisateur lors de l'achat du produit.
  • orderId : identifie la commande associée à la transaction annulée.
  • productType : indique si l'achat annulé était un achat via une application ou un abonnement.
  • refundType: indique le type de remboursement ayant annulé l'achat.

S'il vous suffit de trouver le bon achat et la bonne commande pour l'ajustement des droits d'accès, vous disposez de toutes les informations dont vous avez besoin à ce stade. Pour savoir comment obtenir des informations supplémentaires sur l'achat annulé, consultez l'API Voided Purchases de Google Play, un modèle pull qui fournit des données supplémentaires pour les achats annulés entre un horodatage donné.

Pour les achats de quantités multiples partiellement annulés, le champ refundableQuantity fourni par purchases.products contient le nombre de produits achetés restants qui n'ont pas été annulés.

TestNotification

TestNotification contient les champs suivants :

{
  "version": string
}
Nom de la propriété Valeur Description
version string Version de cette notification. Dans un premier temps, la version correspond à "1.0". Cette version est différente des autres champs de version.

Exemple

Voici un exemple de notification test :

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503350156918",
  "testNotification":
  {
    "version":"1.0"
  }
}