Method: purchases.subscriptions.cancel

إلغاء عملية شراء اشتراك أحد المستخدمين يظل الاشتراك صالحًا حتى وقت انتهاء صلاحيته.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
packageName

string

اسم حزمة التطبيق الذي تم شراء هذا الاشتراك له (على سبيل المثال، ‎"com.some.thing").
subscriptionId

string

معرّف الاشتراك الذي تم شراؤه (على سبيل المثال، "monthly001").
token

string

الرمز المميّز الذي تم تقديمه لجهاز المستخدم عند شراء الاشتراك

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "cancellationType": enum (CancellationType)
}
الحقول
cancellationType

enum (CancellationType)

اختيارية: نوع إلغاء الاشتراك الذي تم شراؤه

نص الاستجابة

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

CancellationType

نوع الإلغاء الذي طلبه المطوّر

عمليات التعداد
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. هذا هو السلوك التلقائي في حال عدم تحديد نوع الإلغاء.