Method: purchases.subscriptions.cancel

Annullare l'acquisto di un abbonamento da parte di un utente. L'abbonamento rimane valido fino alla scadenza.

Richiesta HTTP

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

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 l'abbonamento 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 
{
  "cancellationType": enum (CancellationType)
}
Campi
cancellationType

enum (CancellationType)

Facoltativo. Il tipo di annullamento dell'abbonamento acquistato. Tieni presente che questo campo è supportato solo nella richiesta HTTP. Non è disponibile nelle librerie client.

Corpo della risposta

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

Esempio

Di seguito è riportata una richiesta di esempio:

curl -X POST \
  -H "Accept: application/json" \
  "https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/subscriptions/monthly.premium.plan/tokens/EXAMPLE_TOKEN_STRING_12345:cancel"

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

CancellationType

Il tipo di annullamento richiesto dallo sviluppatore.

Enum
CANCELLATION_TYPE_UNSPECIFIED Tipo di annullamento non specificato.
USER_REQUESTED_STOP_RENEWALS Annullamento richiesto dall'utente e l'abbonamento può essere ripristinato. Viene interrotto solo il prossimo rinnovo dell'abbonamento. Per un abbonamento a rate, gli utenti devono comunque completare il periodo di impegno. Per ulteriori dettagli su rinnovi e pagamenti, consulta la pagina https://developer.android.com/google/play/billing/subscriptions#installments
DEVELOPER_REQUESTED_STOP_PAYMENTS Annullamento richiesto dallo sviluppatore e l'abbonamento non può essere ripristinato. Viene interrotto il prossimo pagamento dell'abbonamento. Per un abbonamento a rate, gli utenti non dovranno pagare il prossimo pagamento e completare il periodo di impegno. Per maggiori dettagli su rinnovi e pagamenti, consulta la pagina https://developer.android.com/google/play/billing/subscriptions#installments. Questo è il comportamento predefinito quando non viene specificato alcun tipo di annullamento.