Method: purchases.subscriptions.cancel

Annulla l'acquisto di un abbonamento di un utente. L'abbonamento rimane valido fino alla scadenza. La versione più recente è disponibile all'indirizzo purchases.subscriptionsv2.cancel per un migliore supporto della libreria client.

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: a partire 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 
{
  "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. Gli utenti della libreria client possono utilizzare purchases.subscriptionsv2.cancel.

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. Interrompe solo il rinnovo successivo dell'abbonamento. Per un abbonamento a rate, gli utenti devono comunque completare il periodo di impegno. Per maggiori 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. Il pagamento successivo dell'abbonamento viene interrotto. Per un abbonamento a rate, gli utenti non dovranno pagare la rata successiva e terminare il periodo di impegno. Per ulteriori 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.