Method: purchases.subscriptions.cancel

منسوخ شده: به جای آن از purchases.subscriptionsv2.cancel استفاده کنید. خرید اشتراک کاربر را لغو می‌کند. اشتراک تا زمان انقضا معتبر است. نسخه جدیدتر برای پشتیبانی بهتر از کتابخانه کلاینت در purchases.subscriptionsv2.cancel موجود است.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
packageName

string

نام بسته‌ی برنامه‌ای که این اشتراک برای آن خریداری شده است (برای مثال، 'com.some.thing').

subscriptionId

string

توجه: از ۲۱ مه ۲۰۲۵، شناسه اشتراک الزامی نیست و برای اشتراک با افزونه‌ها توصیه نمی‌شود. شناسه اشتراک خریداری شده (برای مثال، 'monthly001').

token

string

توکنی که هنگام خرید اشتراک به دستگاه کاربر ارائه شده است.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "cancellationType": enum (CancellationType)
}
فیلدها
cancellationType

enum ( CancellationType )

اختیاری. نوع لغو اشتراک خریداری شده. توجه داشته باشید که این فیلد فقط در درخواست HTTP پشتیبانی می‌شود. در کتابخانه‌های کلاینت موجود نیست. کاربران کتابخانه کلاینت می‌توانند به جای آن از purchases.subscriptionsv2.cancel استفاده کنند.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ خالی است.

نمونه

نمونه درخواست زیر:

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"

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

نوع لغو

نوع لغو درخواست شده توسط توسعه‌دهنده.

انوم‌ها
CANCELLATION_TYPE_UNSPECIFIED نوع لغو مشخص نشده است.
USER_REQUESTED_STOP_RENEWALS لغو اشتراک توسط کاربر درخواست شده و اشتراک قابل بازیابی است. این کار فقط تمدید بعدی اشتراک را متوقف می‌کند. برای اشتراک اقساطی، کاربران همچنان باید دوره تعهد را به پایان برسانند. برای جزئیات بیشتر در مورد تمدید و پرداخت‌ها، به https://developer.android.com/google/play/billing/subscriptions#installments مراجعه کنید.
DEVELOPER_REQUESTED_STOP_PAYMENTS لغو اشتراک توسط توسعه‌دهنده درخواست شده است و اشتراک قابل بازیابی نیست. این امر پرداخت بعدی اشتراک را متوقف می‌کند. برای اشتراک اقساطی، کاربران نیازی به پرداخت قسط بعدی و اتمام دوره تعهد ندارند. برای جزئیات بیشتر در مورد تمدید و پرداخت‌ها، به https://developer.android.com/google/play/billing/subscriptions#installments مراجعه کنید. این رفتار پیش‌فرض زمانی است که هیچ نوع لغوی مشخص نشده باشد.