Method: purchases.subscriptions.cancel

Kündigt den Kauf eines Abos durch einen Nutzer. Das Abo bleibt bis zum Ende der Ablaufzeit gültig. Eine neuere Version ist unter purchases.subscriptionsv2.cancel verfügbar, die eine bessere Unterstützung von Clientbibliotheken bietet.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
packageName

string

Der Paketname der Anwendung, für die dieses Abo gekauft wurde (z. B. „com.some.thing“).
subscriptionId

string

Hinweis: Seit dem 21. Mai 2025 ist „subscriptionId“ nicht mehr erforderlich und wird für Abos mit Add‑ons nicht empfohlen. Die ID des gekauften Abos (z. B. „monthly001“).
token

string

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "cancellationType": enum (CancellationType)
}
Felder
cancellationType

enum (CancellationType)

Optional. Die Art der Kündigung für das gekaufte Abo. Dieses Feld wird nur in der HTTP-Anfrage unterstützt. Sie ist nicht in Clientbibliotheken verfügbar. Nutzer von Clientbibliotheken können stattdessen purchases.subscriptionsv2.cancel verwenden.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Beispiel

Hier ein Beispiel für eine Anfrage:

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"

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

CancellationType

Die vom Entwickler beantragte Art der Kündigung.

Enums
CANCELLATION_TYPE_UNSPECIFIED Kündigungstyp nicht angegeben.
USER_REQUESTED_STOP_RENEWALS Der Nutzer hat die Kündigung beantragt und das Abo kann wiederhergestellt werden. Dadurch wird nur die nächste Verlängerung des Abos verhindert. Bei einem Abo mit Ratenzahlung müssen Nutzer den Mindestlaufzeitraum einhalten. Weitere Informationen zu Verlängerungen und Zahlungen finden Sie unter https://developer.android.com/google/play/billing/subscriptions#installments.
DEVELOPER_REQUESTED_STOP_PAYMENTS Die Kündigung wurde vom Entwickler angefordert und das Abo kann nicht wiederhergestellt werden. Dadurch wird die nächste Zahlung für das Abo gestoppt. Bei einem Abo mit Ratenzahlung müssen Nutzer die nächste Zahlung nicht leisten und den Mindestlaufzeit nicht abschließen. Weitere Informationen zu Verlängerungen und Zahlungen finden Sie unter https://developer.android.com/google/play/billing/subscriptions#installments. Dies ist das Standardverhalten, wenn kein Kündigungstyp angegeben ist.