Method: purchases.subscriptions.cancel

Kullanıcının abonelik satın alma işlemini iptal eder. Abonelik, geçerlilik süresi dolana kadar geçerli kalır. Daha iyi istemci kitaplığı desteği için purchases.subscriptionsv2.cancel adresinde daha yeni bir sürüm mevcuttur.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
packageName

string

Bu aboneliğin satın alındığı uygulamanın paket adı (örneğin, "com.some.thing").
subscriptionId

string

Not: 21 Mayıs 2025'ten itibaren subscriptionId gerekli değildir ve eklentili abonelikler için önerilmez. Satın alınan abonelik kimliği (örneğin, "monthly001").
token

string

Abonelik satın alındığında kullanıcının cihazına sağlanan jeton.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "cancellationType": enum (CancellationType)
}
Alanlar
cancellationType

enum (CancellationType)

İsteğe bağlı. Satın alınan aboneliğin iptal türü. Bu alanın yalnızca HTTP isteğinde desteklendiğini unutmayın. İstemci kitaplıklarında kullanılamaz. İstemci kitaplığı kullanıcıları bunun yerine purchases.subscriptionsv2.cancel yöntemini kullanabilir.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi boş olur.

Örnek

Aşağıda örnek bir istek verilmiştir:

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"

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

CancellationType

Geliştirici tarafından istenen iptal türü.

Sıralamalar
CANCELLATION_TYPE_UNSPECIFIED İptal türü belirtilmedi.
USER_REQUESTED_STOP_RENEWALS Kullanıcı tarafından iptal isteğinde bulunuldu ve abonelik geri yüklenebilir. Bu işlem yalnızca aboneliğin bir sonraki yenilenmesini durdurur. Taksitli aboneliklerde kullanıcıların taahhüt dönemini tamamlaması gerekir. Yenilemeler ve ödemeler hakkında daha fazla bilgi için https://developer.android.com/google/play/billing/subscriptions#installments adresine bakın.
DEVELOPER_REQUESTED_STOP_PAYMENTS Geliştirici tarafından iptal isteğinde bulunuldu ve abonelik geri yüklenemiyor. Aboneliğin bir sonraki ödemesi durdurulur. Taksitli aboneliklerde kullanıcıların bir sonraki ödemeyi yapması ve taahhüt dönemini tamamlaması gerekmez. Yenilemeler ve ödemeler hakkında daha fazla bilgi için https://developer.android.com/google/play/billing/subscriptions#installments adresini ziyaret edin. İptal türü belirtilmediğinde varsayılan davranış budur.