Method: subscriptions.changePlan

لتعديل خطة اشتراك يمكنك استخدام هذه الطريقة لتعديل خطة اشتراك تجريبي لمدة 30 يومًا أو خطة مرنة لخطة اشتراك سنوي تتطلب الدفع شهريًا أو سنويًا.

تختلف طريقة تعديل الخطة حسب الخطة والمنتجات. لمزيد من المعلومات، يُرجى الاطّلاع على الوصف في صفحة إدارة الاشتراكات.

طلب HTTP

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

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

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

المَعلمات
customerId

string

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

string

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

نص الطلب

يحتوي نص الطلب على مثال ChangePlanRequest.

نص الاستجابة

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

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

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

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

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

ChangePlanRequest

نموذج JSON لطلب الحصول على موارد الصفحة (rpc) للاشتراكات.changePlan

تمثيل JSON 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
الحقول
kind

string

تحدد المورد كطلب لخطة تغيير الاشتراك. القيمة: subscriptions#changePlanRequest
planName

string

يجب إدخال السمة planName. هذا هو اسم خطة دفع الاشتراك. لمزيد من المعلومات حول خطط الدفع في Google، راجع مفاهيم واجهة برمجة التطبيقات.

القيم المحتمَلة هي:

  • ANNUAL_MONTHLY_PAY - خطة الاشتراك السنوية بنظام دفعات شهرية
  • ANNUAL_YEARLY_PAY - خطة الاشتراك السنوي مع دفعات سنوية
  • FLEXIBLE - الخطة المرنة
  • TRIAL - خطة التجربة المجانية لمدة 30 يومًا

seats

object (Seats)

هذه سمة مطلوبة. قيمة ترخيص المستخدمين هي عدد تراخيص تراخيص المستخدمين.
purchaseOrderId

string

هذه السمة اختيارية. إنّ معلومات طلب الشراء هذه مخصّصة للمورّدين لاستخدامها في تتبُّع شركتهم. وفي حال إضافة قيمة purchaseOrderId، ستظهر في ردود واجهة برمجة التطبيقات وستظهر في الفاتورة. تقبل السمة ما يصل إلى 80 حرفًا من أحرف النص العادي.
dealCode

string

رمز صادر عن Google (100 حرف كحدٍ أقصى) للحصول على سعر مخفَّض على خطط الاشتراك. يجب تضمين رمز الصفقة في طلب "changePlan" للحصول على سعر مخفَّض. هذه السمة اختيارية. في حال سبق أن أضفت رمز صفقة إلى اشتراك، قد يتم ترك هذا الموقع فارغًا وسيظل السعر المخفّض الحالي ساريًا (إذا لم يكن فارغًا، قدِّم رمز الصفقة المتوفّر في الاشتراك فقط). في حال لم تتم إضافة رمز صفقة إلى اشتراك من قبل وترك هذا الموقع فارغًا، سيتم تطبيق الأسعار العادية.