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