Method: purchases.subscriptions.cancel

Wycofano: zamiast tego użyj purchases.subscriptionsv2.cancel. Anuluje zakup subskrypcji użytkownika. Subskrypcja pozostaje ważna do czasu jej wygaśnięcia. Nowsza wersja jest dostępna w purchases.subscriptionsv2.cancel, aby zapewnić lepszą obsługę biblioteki klienta.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
packageName

string

Nazwa pakietu aplikacji, w której zakupiono tę subskrypcję (np. „com.some.thing”).
subscriptionId

string

Uwaga: od 21 maja 2025 r. parametr subscriptionId nie jest wymagany i nie jest zalecany w przypadku subskrypcji z dodatkami. Identyfikator zakupionej subskrypcji (np. „monthly001”).
token

string

Token przekazany na urządzenie użytkownika podczas zakupu subskrypcji.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "cancellationType": enum (CancellationType)
}
Pola
cancellationType

enum (CancellationType)

Opcjonalnie. Typ anulowania zakupionej subskrypcji. Pamiętaj, że to pole jest obsługiwane tylko w żądaniu HTTP. Nie jest dostępne w bibliotekach klienta. Użytkownicy biblioteki klienta mogą zamiast tego użyć purchases.subscriptionsv2.cancel.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie pusta.

Przykład

Oto przykładowe żądanie:

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"

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

CancellationType

Typ anulowania żądany przez dewelopera.

Wartości w polu enum
CANCELLATION_TYPE_UNSPECIFIED Typ anulowania nieokreślony.
USER_REQUESTED_STOP_RENEWALS Anulowanie na prośbę użytkownika. Subskrypcję można przywrócić. Powoduje tylko zatrzymanie następnego odnowienia subskrypcji. W przypadku subskrypcji ratalnej użytkownicy nadal muszą dokończyć okres zobowiązania. Więcej informacji o odnowieniach i płatnościach znajdziesz na stronie https://developer.android.com/google/play/billing/subscriptions#installments.
DEVELOPER_REQUESTED_STOP_PAYMENTS Anulowanie na prośbę dewelopera. Subskrypcji nie można przywrócić. Powoduje zatrzymanie następnej płatności za subskrypcję. W przypadku subskrypcji ratalnej użytkownicy nie będą musieli dokonać następnej płatności i dokończyć okresu zobowiązania. Więcej informacji o odnowieniach i płatnościach znajdziesz na stronie https://developer.android.com/google/play/billing/subscriptions#installments. Jest to domyślne zachowanie, gdy nie określono typu anulowania.