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

ملاحظة: اعتبارًا من 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

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