Method: purchases.subscriptionsv2.revoke

subscriptionsv2.revoke un acquisto di abbonamento per l'utente.

Richiesta HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:revoke

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
packageName

string

Obbligatorio. Il pacchetto dell'applicazione per cui è stato acquistato l'abbonamento (ad esempio "com.some.thing").
token

string

Obbligatorio. 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 
{
  "revocationContext": {
    object (RevocationContext)
  }
}
Campi
revocationContext

object (RevocationContext)

Obbligatorio. Ulteriori dettagli sulla revoca dell'abbonamento.

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/subscriptionsv2/tokens/sample_purchase_token:revoke' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "revocationContext": {
      "proratedRefund": {}
    }
  }'

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

RevocationContext

Contesto di revoca dell'API purchases.subscriptionsv2.revoke.

Rappresentazione JSON 
{

  // Union field RefundType can be only one of the following:
  "fullRefund": {
    object (FullRefund)
  },
  "proratedRefund": {
    object (ProratedRefund)
  },
  "itemBasedRefund": {
    object (ItemBasedRefund)
  }
  // End of list of possible types for union field RefundType.
}
Campi
Campo unione RefundType. Determina il tipo di rimborso da concedere. È necessario specificare un tipo di rimborso nell'ambito di una richiesta valida. RefundType può essere solo uno dei seguenti:
fullRefund

object (FullRefund)

Facoltativo. Da utilizzare quando agli utenti deve essere rimborsato l'intero importo dell'ultimo addebito su ogni articolo dell'abbonamento.
proratedRefund

object (ProratedRefund)

Facoltativo. Viene utilizzato quando agli utenti deve essere rimborsato un importo proporzionale pagato per l'abbonamento in base al periodo di tempo rimanente dell'abbonamento.
itemBasedRefund

object (ItemBasedRefund)

Facoltativo. Da utilizzare quando è necessario rimborsare un articolo specifico in un abbonamento con articoli aggiuntivi.

FullRefund

Questo tipo non contiene campi.

Viene utilizzato per determinare se il tipo di rimborso in RevocationContext è un rimborso totale.

ProratedRefund

Questo tipo non contiene campi.

Utilizzato per determinare se il tipo di rimborso in RevocationContext è un rimborso proporzionale.

ItemBasedRefund

Utilizzato per determinare quale elemento specifico revocare in un abbonamento con più elementi.

Rappresentazione JSON 
{
  "productId": string
}
Campi
productId

string

Obbligatorio. Se l'abbonamento è un abbonamento con componenti aggiuntivi, l'ID prodotto dell'elemento dell'abbonamento da revocare.