Guía de referencia de las notificaciones para desarrolladores en tiempo real

En este tema, se enumeran y describen los tipos de notificaciones para desarrolladores en tiempo real que puedes recibir de Google Play.

Codificación

Cada publicación realizada en un tema de Cloud Pub/Sub incluye un campo de datos único con codificación base64.

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

Una vez que se decodifica el campo de datos con codificación base64, el objeto DeveloperNotification incluye los siguientes campos:

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

Estos campos se describen en la siguiente tabla.

SubscriptionNotification

Un objeto SubscriptionNotification incluye los siguientes campos:

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string,
  "subscriptionId": string
}

Ejemplo

Este es un ejemplo de una notificación por la compra de una suscripción nueva:

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

OneTimeProductNotification

Un objeto OneTimeProductNotification incluye los siguientes campos:

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string,
  "sku": string
}

Ejemplo

A continuación, se incluye un ejemplo de una notificación por una nueva compra única:

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

VoidedPurchaseNotification

Un objeto VoidedPurchaseNotification incluye los siguientes campos:

Ejemplo

Este es un ejemplo de una notificación por la compra de una suscripción que se anuló nueva:

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

Cómo consumir VoidedPurchaseNotification

Cuando tu cliente de RTDN recibe un VoidedPurchaseNotification, ten en cuenta la siguiente información:

• packageName: Identifica la app.
• eventTimeMillis: Informa al desarrollador sobre la hora en que ocurrió el cambio de estado.
• purchaseToken: Es el token que se envió al dispositivo del usuario cuando se compró la suscripción.
• orderId: Identifica el pedido asociado con la transacción anulada.
• productType: Indica si la compra anulada fue una compra directa desde la aplicación o una suscripción.

Si todo lo que necesitas hacer para los ajustes de derechos es ubicar la compra y el pedido correctos, entonces tienes toda la información que necesitas en este punto. Si quieres obtener más información sobre la compra anulada, consulta la API de Voided Purchases de Google Play, que es un modelo de extracción que proporciona datos adicionales para las compras anuladas entre una marca de tiempo determinada.

TestNotification

Un objeto TestNotification incluye los siguientes campos:

{
  "version": string
}

Ejemplo

Este es un ejemplo de una notificación de prueba:

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