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 بنية تحويل الترميز إلى gRPC.

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

المعلمات
packageName

string

اسم حزمة التطبيق الذي تم شراء هذا الاشتراك من أجله (مثلاً "com.some.thing")
subscriptionId

string

ملاحظة: اعتبارًا من 21 مايو 2025، لن يكون subscriptionId مطلوبًا، ولا يُنصح باستخدامه للاشتراك مع الإضافات. رقم تعريف الاشتراك الذي تم شراؤه (مثلاً "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

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