Method: subscriptions.suspend

تعليق اشتراك نشط

يمكنك استخدام هذه الطريقة لتعليق اشتراك مدفوع حاليًا في حالة ACTIVE.

  • بالنسبة إلى اشتراكات FLEXIBLE، يتم إيقاف الفوترة مؤقتًا.
  • بالنسبة إلى اشتراكات ANNUAL_MONTHLY_PAY أو ANNUAL_YEARLY_PAY:
    • لا يؤدي تعليق الاشتراك إلى تغيير تاريخ التجديد الذي تم الالتزام به في الأصل.
    • لا يتم تجديد الاشتراك المعلّق.  في حال تفعيل الاشتراك بعد تاريخ التجديد الأصلي، سيتم إنشاء اشتراك سنوي جديد بدءًا من يوم التفعيل.

ننصحك بشدة بعدم تعليق الاشتراكات إلا لفترات قصيرة، لأنّ التعليق لمدة تزيد عن 60 يومًا قد يؤدي إلى إلغاء الاشتراك.

طلب HTTP

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/suspend

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

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

المعلمات
customerId

string

يمكن أن يكون هذا اسم النطاق الأساسي للعميل أو المعرّف الفريد للعميل. في حال تغيير اسم نطاق العميل، لا يمكن استخدام اسم النطاق القديم للوصول إلى العميل، ولكن يمكن استخدام المعرّف الفريد للعميل (كما تعرضه واجهة برمجة التطبيقات) في أي وقت. ننصحك بتخزين المعرّف الفريد في أنظمتك كلما أمكن ذلك.
subscriptionId

string

هذه سمة مطلوبة. subscriptionId هو معرّف الاشتراك وهو فريد لكل عميل. بما أنّ القيمة subscriptionId تتغيّر عند تعديل اشتراك، ننصحك بعدم استخدام هذا المعرّف كمفتاح للبيانات الثابتة. ويمكن العثور على subscriptionId باستخدام طريقة استرداد جميع اشتراكات المورّدين.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Subscription.

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

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

  • https://www.googleapis.com/auth/apps.order

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.