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

لمزيد من المعلومات، راجِع دليل التفويض.