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 effettuata in un argomento Cloud Pub/Sub contiene un singolo campo di dati con codifica base64.

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

Dopo aver decodificato il campo dati codificato in base64, DeveloperNotification contiene i seguenti campi:

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

Questi campi sono descritti nella tabella seguente.

Nome proprietà Valore Descrizione
versione stringa La versione di questa notifica. Inizialmente, questo valore è "1.0". Questa versione è diversa dagli altri campi della versione.
packageName stringa Il nome del pacchetto dell'applicazione a cui si riferisce questa notifica (ad esempio, `com.some.thing`).
eventTimeMillis lungo Il timestamp in cui si è verificato l'evento, in millisecondi dall'epoca.
subscriptionNotification SubscriptionNotification

Se questo campo è presente, la notifica è relativa a un abbonamento e questo campo contiene informazioni aggiuntive relative all'abbonamento.

Tieni presente che questo campo si esclude a vicenda con pendingRefundReviewNotification, oneTimeProductNotification, voidedPurchaseNotification e testNotification.
oneTimeProductNotification OneTimeProductNotification

Se questo campo è presente, la notifica è relativa a un acquisto una tantum e questo campo contiene informazioni aggiuntive relative all'acquisto.

Tieni presente che questo campo si esclude a vicenda con pendingRefundReviewNotification, 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 si esclude a vicenda con pendingRefundReviewNotification, oneTimeProductNotification, subscriptionNotification e testNotification.
pendingRefundReviewNotification PendingRefundReviewNotification

Se questo campo è presente, la notifica riguarda una richiesta di storno per la quale puoi suggerire una soluzione. Rispondi a questa notifica chiamando l'API `ReviewRefund`.

Tieni presente che questo campo si esclude a vicenda con subscriptionNotification, oneTimeProductNotification, voidedPurchaseNotification, e testNotification.
testNotification TestNotification

Se questo campo è presente, la notifica è correlata a una pubblicazione di test. Questi vengono inviati solo tramite la Google Play Developer Console.

Tieni presente che questo campo si esclude a vicenda con pendingRefundReviewNotification, 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, questo valore è "1.0". Questa versione è diversa dagli altri campi della versione.
notificationType int Il valore di notificationType per un abbonamento può essere uno dei seguenti:
  • (1) SUBSCRIPTION_RECOVERED - Un abbonamento è stato recuperato dalla sospensione dell'account o riattivato dopo la sospensione.
  • (2) SUBSCRIPTION_RENEWED: un abbonamento attivo è stato rinnovato.
  • (3) SUBSCRIPTION_CANCELED - Un abbonamento è stato annullato volontariamente o involontariamente. Per l'annullamento volontario, inviato quando l'utente annulla l'abbonamento.
  • (4) SUBSCRIPTION_PURCHASED: è stato acquistato un nuovo abbonamento.
  • (5) SUBSCRIPTION_ON_HOLD - A subscription has entered account hold (if enabled).
  • (6) SUBSCRIPTION_IN_GRACE_PERIOD - A subscription has entered grace period (if enabled).
  • (7) SUBSCRIPTION_RESTARTED - User has restored their subscription from Play > Account > Subscriptions. L'abbonamento è stato annullato, ma non era ancora scaduto quando l'utente lo ha ripristinato. Per saperne di più, consulta Ripristini.
  • (8) SUBSCRIPTION_PRICE_CHANGE_CONFIRMED (DEPRECATED) - A subscription price change has successfully been confirmed by the user.
  • (9) SUBSCRIPTION_DEFERRED - La ricorrenza di un abbonamento è stata estesa.
  • (10) SUBSCRIPTION_PAUSED - Un abbonamento è stato messo in pausa.
  • (11) SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED - A subscription pause schedule has been changed.
  • (12) SUBSCRIPTION_REVOKED - A subscription has been revoked from the user before the expiration time.
  • (13) SUBSCRIPTION_EXPIRED: un abbonamento è scaduto.
  • (17) SUBSCRIPTION_ITEMS_CHANGED - Un elemento in un pacchetto di abbonamento è stato modificato.
  • (18) SUBSCRIPTION_CANCELLATION_SCHEDULED - È stato programmato l'annullamento di un abbonamento a rate che diventerà effettivo al termine del periodo di impegno.
  • (19) SUBSCRIPTION_PRICE_CHANGE_UPDATED - A subscription item's price change details are updated.
  • (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 di prezzo di un abbonamento o l'utente ha fornito il consenso per l'aumento di prezzo. Questa notifica RTDN viene inviata solo per gli abbonamenti in una regione in cui è richiesto l'aumento graduale 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 correttamente 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 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 viene effettuato un nuovo acquisto.

orderId

string

L'ID ordine univoco associato alla transazione annullata. Per gli acquisti una tantum, 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 - È stato annullato un acquisto di abbonamento.
  • (2) PRODUCT_TYPE_ONE_TIME - Un 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 completamente annullato.
  • (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 con 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
  }
}

Utilizzo di VoidedPurchaseNotification

Quando il client RTDN riceve un VoidedPurchaseNotification, prendi nota delle seguenti informazioni:

  • packageName: identifica l'app.
  • eventTimeMillis: indica l'ora in cui è avvenuto il cambio di 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.

PendingRefundReviewNotification

Un PendingRefundReviewNotification viene inviato quando un utente richiede uno storno di addebito per un acquisto e la richiesta richiede la revisione dello sviluppatore. Quando ricevi questa notifica, devi valutare la richiesta e fornire un suggerimento di rimborso e una prova dell'utilizzo dell'acquisto entro 24 ore chiamando l'API ReviewRefund.

Un PendingRefundReviewNotification contiene i seguenti campi:

{
  "version": string,
  "pendingRefundToken": string,
  "orderId": string,
  "refundReason": int,
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
Nome proprietà Valore Descrizione
versione stringa La versione di questa notifica. Inizialmente, questo valore è "1.0". Questa versione è diversa dagli altri campi della versione.
pendingRefundToken stringa Un token univoco che identifica la richiesta di rimborso in attesa di revisione. Passa questo token quando chiami l'API ReviewRefund.
orderId stringa L'ID ordine dell'acquisto soggetto alla revisione del rimborso in attesa.
refundReason int Il motivo della richiesta di rimborso. Le revisioni in attesa supportano solo CHARGEBACK (7) come motivo del rimborso. Il codice deve gestire i nuovi motivi man mano che diventano disponibili.
obfuscatedAccountId stringa (Se applicabile) L'ID account utente offuscato specificato dallo sviluppatore fornito al momento dell'acquisto.
obfuscatedProfileId stringa (Se applicabile) L'ID profilo offuscato specificato dallo sviluppatore fornito al momento dell'acquisto.

Esempio

Ecco un esempio di notifica di revisione del rimborso in attesa:

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503350156918",
  "pendingRefundReviewNotification":
  {
    "version":"1.0",
    "pendingRefundToken":"example-token",
    "orderId":"GPA.1234-5678-9012-34567",
    "refundReason":7,
    "obfuscatedAccountId":"user-account-id",
    "obfuscatedProfileId":"user-profile-id"
  }
}

TestNotification

Un TestNotification contiene i seguenti campi:

{
  "version": string
}
Nome proprietà Valore Descrizione
versione stringa La versione di questa notifica. Inizialmente, questo valore è "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"
  }
}