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