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‏ subscriptions.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 للحصول على السعر المخفَّض. هذه السمة اختيارية. إذا سبق أن تمت إضافة رمز صفقة إلى اشتراك، يمكن ترك هذا الحقل فارغًا وسيظل السعر المخفَّض الحالي ساريًا (إذا لم يكن فارغًا، يجب تقديم رمز الصفقة المتوفّر حاليًا في الاشتراك فقط). إذا لم تتم إضافة رمز صفقة إلى اشتراك وتركت هذا الحقل فارغًا، سيتم تطبيق الأسعار العادية.