Method: purchases.subscriptions.cancel

Kündigt den Abokauf eines Nutzers. Das Abo bleibt bis zum Ende der Ablaufzeit gültig.

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.beispiel.app“).
subscriptionId

string

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

string

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 
{
  "cancellationType": enum (CancellationType)
}
Felder
cancellationType

enum (CancellationType)

Optional. Die Art der Kündigung des gekauften Abos. Dieses Feld wird nur in der HTTP-Anfrage unterstützt. Sie ist nicht in Clientbibliotheken verfügbar.

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 angeforderte Art der Kündigung.

Enums
CANCELLATION_TYPE_UNSPECIFIED Kündigungstyp nicht angegeben.
USER_REQUESTED_STOP_RENEWALS Kündigung durch den Nutzer beantragt und das Abo kann wiederhergestellt werden. Dadurch wird nur die nächste Verlängerung des Abos verhindert. Bei einem Ratenabo müssen Nutzer die Mindestlaufzeit noch abschließen. 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 beantragt und das Abo kann nicht wiederhergestellt werden. Die nächste Zahlung für das Abo wird verhindert. Bei einem Ratenabo müssen Nutzer die nächste Zahlung nicht leisten und die Mindestlaufzeit nicht einhalten. 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.