Method: purchases.subscriptions.acknowledge
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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
} |
| Campi |
developerPayload |
string
Payload da associare all'acquisto.
|
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
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 2025-07-26 UTC."],[[["\u003cp\u003eAcknowledges a subscription purchase using the provided token, subscription ID, and package name.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eThe request can include an optional \u003ccode\u003edeveloperPayload\u003c/code\u003e in the JSON body.\u003c/p\u003e\n"],["\u003cp\u003eA successful acknowledgement results in an empty response body.\u003c/p\u003e\n"]]],["The core content outlines acknowledging a subscription purchase via a POST HTTP request to a specific URL. This requires three path parameters: `packageName`, `subscriptionId`, and `token`. The request body, represented in JSON, includes a single field, `developerPayload`, a string for attaching data to the purchase. Upon successful execution, the response body will be empty. The operation requires the `https://www.googleapis.com/auth/androidpublisher` authorization scope.\n"],null,["# Method: purchases.subscriptions.acknowledge\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nAcknowledges a subscription purchase.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledge`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` The package name of the application for which this subscription was purchased (for example, 'com.some.thing'). |\n| `subscriptionId` | `string` Note: Since May 21, 2025, subscriptionId is not required, and not recommended for subscription with add-ons. The purchased subscription ID (for example, 'monthly001'). |\n| `token` | `string` The token provided to the user's device when the subscription was purchased. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------|\n| ``` { \"developerPayload\": string } ``` |\n\n| Fields ||\n|--------------------|---------------------------------------------|\n| `developerPayload` | `string` Payload to attach to the purchase. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Sample\n\nThe following is a sample request: \n\n```json\ncurl -X POST \\\n 'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly_premium_001/tokens/abcDEF123ghiJKL456mnoPQR789:acknowledge' \\\n -H 'Accept: application/json' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"developerPayload\": \"AppSpecificInfo-UserID-12345\"\n }'\n```\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
