Method: purchases.subscriptionsv2.revoke

subscriptionsv2.revoke a subscription purchase for the user.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
packageName

string

Erforderlich. Das Paket der Anwendung, für die dieses Abo gekauft wurde (z. B. „com.beispiel.app“).
token

string

Erforderlich. Das Token, das beim Kauf des Abos auf dem Gerät des Nutzers bereitgestellt wurde.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "revocationContext": {
    object (RevocationContext)
  }
}
Felder
revocationContext

object (RevocationContext)

Erforderlich. Weitere Informationen zum Widerruf des Abos.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Beispiel

Hier ein Beispiel für eine Anfrage:

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": {}
    }
  }'

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

RevocationContext

Widerrufskontext der API „purchases.subscriptionsv2.revoke“.

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld RefundType. Bestimmt die Art der Erstattung, die gewährt werden soll. Für eine gültige Anfrage muss ein Erstattungstyp angegeben werden. Für RefundType ist nur einer der folgenden Werte zulässig:
fullRefund

object (FullRefund)

Optional. Wird verwendet, wenn Nutzern der volle Betrag der letzten Abbuchung für jeden Artikel im Abo erstattet werden soll.
proratedRefund

object (ProratedRefund)

Optional. Wird verwendet, wenn Nutzern ein anteiliger Betrag für ihr Abo erstattet werden soll, der sich nach der verbleibenden Abolaufzeit richtet.
itemBasedRefund

object (ItemBasedRefund)

Optional. Wird verwendet, wenn ein bestimmter Artikel in einem Abo mit Add-on-Artikeln erstattet werden soll.

FullRefund

Dieser Typ hat keine Felder.

Wird verwendet, um zu bestimmen, ob es sich bei der Erstattungsart in „RevocationContext“ um eine volle Erstattung handelt.

ProratedRefund

Dieser Typ hat keine Felder.

Gibt an, ob es sich bei der Erstattung im Kontext „RevocationContext“ um eine anteilige Erstattung handelt.

ItemBasedRefund

Damit wird festgelegt, welches Element in einem Abo mit mehreren Elementen widerrufen werden soll.

JSON-Darstellung 
{
  "productId": string
}
Felder
productId

string

Erforderlich. Wenn es sich um ein Abo mit Add-ons handelt, die Produkt-ID des zu widerrufenden Aboelements.