Guida di riferimento alle notifiche in tempo reale per lo sviluppatore

Questo documento elenca e descrive i tipi di notifiche in tempo reale per lo sviluppatore che puoi ricevere da Google Play.

Codifica

Ogni pubblicazione in un argomento di Cloud Pub/Sub contiene un singolo campo di dati con codifica in base64.

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

Dopo aver decodificato il campo di dati con codifica in base64, DeveloperNotification contiene i seguenti campi:

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

Questi campi sono descritti nella tabella seguente.

Nome proprietà Valore Descrizione
versione stringa La versione di questa notifica. Inizialmente, è "1.0". Questa versione è diversa dagli altri campi della versione.
packageName stringa Il nome del pacchetto dell'applicazione a cui si riferisce questa notifica a (ad esempio, `com.some.thing`).
eventTimeMillis lunghi Il timestamp in cui si è verificato l'evento, in millisecondi da l'epoca.
subscriptionNotification SubscriptionNotification Se questo campo è presente, la notifica è relativa a un abbonamento e contiene informazioni aggiuntive sull' abbonamento. Tieni presente che questo campo è mutuamente esclusivo con oneTimeProductNotification, voidedPurchaseNotification, e testNotification.
oneTimeProductNotification OneTimeProductNotification Se questo campo è presente, la notifica è relativa a un acquisto una tantum e contiene informazioni aggiuntive sull'acquisto. Tieni presente che questo campo è mutuamente esclusivo con subscriptionNotification, voidedPurchaseNotification, e testNotification.
voidedPurchaseNotification VoidedPurchaseNotification Se questo campo è presente, la notifica è relativa a un acquisto annullato e contiene informazioni aggiuntive relative all'acquisto annullato. Tieni presente che questo campo è mutuamente esclusivo con oneTimeProductNotification, subscriptionNotification e testNotification.
testNotification TestNotification Se questo campo è presente, la notifica è relativa a una pubblicazione di test. Questi vengono inviati solo tramite la Google Play Developer Console. Tieni presente che questo campo è mutuamente esclusivo con oneTimeProductNotification, subscriptionNotification, e voidedPurchaseNotification.

SubscriptionNotification

Un SubscriptionNotification contiene i seguenti campi:

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string
}
Nome proprietà Valore Descrizione
versione stringa La versione di questa notifica. Inizialmente, è "1.0". Questa versione è diversa dagli altri campi della versione.
notificationType int Il notificationType per un abbonamento può avere i seguenti valori:
  • SUBSCRIPTION_RECOVERED: un abbonamento è stato recuperato dalla sospensione dell'account o ripreso dalla pausa.
  • (2) SUBSCRIPTION_RENEWED: un abbonamento attivo è stato rinnovato.
  • (3) SUBSCRIPTION_CANCELED: un abbonamento è stato annullato volontariamente o involontariamente. Per l'annullamento volontario, viene inviato quando l'utente annulla.
  • (4) SUBSCRIPTION_PURCHASED: è stato acquistato un nuovo abbonamento.
  • (5) SUBSCRIPTION_ON_HOLD: un abbonamento è stato sospeso (se abilitato).
  • (6) SUBSCRIPTION_IN_GRACE_PERIOD: un abbonamento è entrato nel periodo di tolleranza (se abilitato).
  • (7) SUBSCRIPTION_RESTARTED: l'utente ha ripristinato il suo abbonamento da Play > Account > Abbonamenti. L'abbonamento è stato annullato, ma non era ancora scaduto quando l'utente lo ha ripristinato. Per ulteriori informazioni, vedi Ripristini.
  • (8) SUBSCRIPTION_PRICE_CHANGE_CONFIRMED (DEPRECATO): l'utente ha confermato correttamente una modifica del prezzo dell'abbonamento.
  • (9) SUBSCRIPTION_DEFERRED: il tempo di ricorrenza di un abbonamento è stato esteso.
  • (10) SUBSCRIPTION_PAUSED: un abbonamento è stato messo in pausa.
  • (11) SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED: la pianificazione della pausa dell'abbonamento è stata modificata.
  • (12) SUBSCRIPTION_REVOKED: l'abbonamento è stato revocato all'utente prima della scadenza.
  • (13) SUBSCRIPTION_EXPIRED: un abbonamento è scaduto.
  • (17) SUBSCRIPTION_ITEMS_CHANGED: un articolo in un pacchetto di abbonamento è stato modificato.
  • (18) SUBSCRIPTION_CANCELLATION_SCHEDULED: è stato pianificato l'annullamento di un abbonamento a rate che diventerà effettivo alla fine del periodo di impegno.
  • (19) SUBSCRIPTION_PRICE_CHANGE_UPDATED: i dettagli della modifica del prezzo di un articolo di abbonamento sono stati aggiornati.
  • (20) SUBSCRIPTION_PENDING_PURCHASE_CANCELED: una transazione in attesa di un abbonamento è stata annullata.
  • (22) SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED: è iniziato il periodo di consenso per l'aumento del prezzo di un abbonamento oppure l'utente ha fornito il consenso per l'aumento del prezzo. Questa RTDN viene inviata solo per gli abbonamenti in una regione in cui è richiesto l'aumento del prezzo.
purchaseToken stringa Il token fornito al dispositivo dell'utente al momento dell'acquisto dell'abbonamento.

Esempio

Ecco un esempio di notifica per l'acquisto di un nuovo abbonamento:

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

OneTimeProductNotification

Un OneTimeProductNotification contiene i seguenti campi:

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string,
  "sku": string
}
Nome proprietà Valore Descrizione
versione stringa La versione di questa notifica. Inizialmente, sarà "1.0". Questa versione è diversa dagli altri campi della versione.
notificationType int Il tipo di notifica. Può avere i seguenti valori:
  • (1) ONE_TIME_PRODUCT_PURCHASED: un prodotto a pagamento singolo è stato acquistato da un utente.
  • (2) ONE_TIME_PRODUCT_CANCELED: l'acquisto di un prodotto a pagamento singolo in sospeso è stato annullato dall'utente.
purchaseToken stringa Il token fornito al dispositivo dell'utente al momento dell'acquisto.
sku stringa L'ID prodotto del prodotto a pagamento singolo acquistato (ad esempio, "sword_001").

Esempio

Ecco un esempio di notifica per un nuovo acquisto una tantum:

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

VoidedPurchaseNotification

Un VoidedPurchaseNotification contiene i seguenti campi:

Nome proprietà

Valore

Descrizione

purchaseToken

string

Il token associato all'acquisto annullato. Queste informazioni vengono fornite allo sviluppatore quando si verifica un nuovo acquisto

orderId

string

L'ID ordine univoco associato alla transazione che è stato annullato. Per gli acquisti singoli, questo rappresenta l'unico ID ordine generato per l'acquisto. Per gli abbonamenti con rinnovo automatico, viene generato un nuovo ID ordine per ogni transazione di rinnovo.

productType

int

Il productType per un acquisto annullato può avere i seguenti valori:

  • (1) PRODUCT_TYPE_SUBSCRIPTION - L'acquisto di un abbonamento è stato annullato.
  • (2) PRODUCT_TYPE_ONE_TIME - L'acquisto una tantum è stato annullato.

refundType

int

Il refundType per un acquisto annullato può avere i seguenti valori:

  • (1) REFUND_TYPE_FULL_REFUND - L'acquisto è stato annullato completamente.
  • (2) REFUND_TYPE_QUANTITY_BASED_PARTIAL_REFUND - L'acquisto è stato annullato parzialmente da un rimborso parziale basato sulla quantità, applicabile solo agli acquisti di più quantità. Un acquisto può essere annullato parzialmente più volte.

Tieni presente che quando viene rimborsata la quantità totale rimanente di un acquisto di più quantità, il refundType sarà REFUND_TYPE_FULL_REFUND.

Esempio

Ecco un esempio di notifica per un nuovo acquisto annullato:

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

Utilizzare VoidedPurchaseNotification

Quando il client RTDN riceve un VoidedPurchaseNotification, tieni presente le seguenti informazioni:

  • packageName: identifica l'app.
  • eventTimeMillis: ti informa dell'ora in cui si è verificata la modifica dello stato.
  • purchaseToken: il token fornito al dispositivo dell'utente al momento dell'acquisto del prodotto.
  • orderId: identifica l'ordine associato alla transazione annullata.
  • productType: indica se l'acquisto annullato era un acquisto in-app o un abbonamento.
  • refundType: specifica il tipo di rimborso che ha annullato l'acquisto.

TestNotification

Un TestNotification contiene i seguenti campi:

{
  "version": string
}
Nome proprietà Valore Descrizione
versione stringa La versione di questa notifica. Inizialmente, è "1.0". Questa versione è diversa dagli altri campi della versione.

Esempio

Ecco un esempio di notifica di test:

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