Method: purchases.subscriptions.acknowledge

Conferma l'acquisto di un abbonamento.

Richiesta HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledge

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
packageName

string

Il nome del pacchetto dell'applicazione per cui è stato acquistato questo abbonamento (ad esempio "com.some.thing").
subscriptionId

string

Nota: dal 21 maggio 2025, subscriptionId non è obbligatorio e non è consigliato per gli abbonamenti con componenti aggiuntivi. L'ID abbonamento acquistato (ad esempio "mensile001").
token

string

Il token fornito al dispositivo dell'utente al momento dell'acquisto dell'abbonamento.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "developerPayload": string,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
Campi
developerPayload

string

Payload da allegare all'acquisto.
externalAccountIds

object (ExternalAccountIds)

Facoltativo. Identificatore dell'account utente nella tua app.

Corpo della risposta

In caso di esito positivo, il corpo della risposta è vuoto.

Esempio

Di seguito è riportata una richiesta di esempio:

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly_premium_001/tokens/abcDEF123ghiJKL456mnoPQR789:acknowledge' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "developerPayload": "AppSpecificInfo-UserID-12345"
  }'

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/androidpublisher

ExternalAccountIds

Identificatore dell'account utente nella tua app.

Rappresentazione JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
Campi
obfuscatedAccountId

string

Facoltativo. Specifica una stringa offuscata facoltativa associata in modo univoco all'account utente dell'acquirente nella tua app.

Se trasmetti questo valore, Google Play può utilizzarlo per rilevare attività irregolari. Non utilizzare questo campo per archiviare informazioni che consentono l'identificazione personale (PII), ad esempio email in testo normale. Il tentativo di memorizzare informazioni personali in questo campo comporterà il blocco degli acquisti. Google Play consiglia di utilizzare la crittografia o un hash unidirezionale per generare un identificatore offuscato da inviare a Google Play.

Questo identificatore è limitato a 64 caratteri.

Questo campo può essere impostato solo per gli acquisti di riabbonamento. Consulta https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid per impostare questo campo per gli acquisti effettuati utilizzando il flusso di fatturazione in-app standard.
obfuscatedProfileId

string

Facoltativo. Specifica una stringa offuscata facoltativa associata in modo univoco al profilo utente dell'acquirente nella tua app.

Se trasmetti questo valore, Google Play può utilizzarlo per rilevare attività irregolari. Non utilizzare questo campo per archiviare informazioni che consentono l'identificazione personale (PII), ad esempio email in testo normale. Il tentativo di memorizzare informazioni personali in questo campo comporterà il blocco degli acquisti. Google Play consiglia di utilizzare la crittografia o un hash unidirezionale per generare un identificatore offuscato da inviare a Google Play.

Questo identificatore è limitato a 64 caratteri.

Questo campo può essere impostato solo per gli acquisti di riabbonamento. Consulta https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid per impostare questo campo per gli acquisti effettuati utilizzando il flusso di fatturazione in-app standard.