Method: purchases.subscriptions.cancel

خرید اشتراک کاربر را لغو می کند. اشتراک تا زمان انقضا اعتبار دارد.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
packageName

string

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

subscriptionId

string

توجه: از 21 مه 2025، subscriptionId مورد نیاز نیست، و برای اشتراک با افزونه ها توصیه نمی شود. شناسه اشتراک خریداری شده (به عنوان مثال، 'monthly001').

token

string

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

درخواست بدن

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

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

enum ( CancellationType )

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

بدن پاسخگو

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

نمونه

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

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

نوع لغو

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

Enums
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 مراجعه کنید این رفتار پیش‌فرض زمانی است که هیچ نوع لغو مشخص نشده باشد.