استرداد & تحديث اشتراك

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

استرداد اشتراك

لاسترداد اشتراك تم طلبه أو نقله بنجاح، استخدِم GETطلب HTTP التالي.

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID

غيِّر القيم في السلسلة على الشكل التالي:

  • CUSTOMER_ID: إما اسم النطاق الأساسي للعميل أو المعرّف الفريد للعميل.
  • ‫SUBSCRIPTION_ID: معرّف الاشتراك الذي يمثّل معرّفًا فريدًا لكل عميل. يمكنك استرداد هذه القيمة باستخدام طريقة استرداد جميع اشتراكات المورّدين.

لا تتضمّن هذه العملية أيّ مَعلمات في محتوى الطلب.

يعرض الردّ الناجح رمز الحالة200 في HTTP وإعدادات الاشتراك. في المثال التالي للاستجابة، تكون قيمة سمة isInTrial هي false ولكن لا تتوفّر قيمة لسمة trialEndTime، ما يعني أنّ هذا العميل لم يسبق له الاستفادة من فترة تجريبية مجانية لمدة 30 يومًا من خلال هذه الخطة.

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "billingMethod": "ONLINE",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "RENEW_CURRENT_USERS_MONTHLY_PAY"
  },
  "purchaseOrderId": "example.com_annual_1",
  "status": "ACTIVE",
  "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
  "skuName": "Google Workspace Business Standard"
}

استرداد جميع الاشتراكات لعميل

لاسترداد جميع اشتراكات عملاء المورّدين المحدّدين التي تم طلبها أو نقلها بنجاح، استخدِم طلب HTTP GET التالي مع تضمين رمز التفويض:

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID value&pageToken=START_DATE&maxResults=MAX_NUMBER

غيِّر القيم في السلسلة على الشكل التالي:

  • CUSTOMER_ID: إما اسم النطاق الأساسي للعميل أو المعرّف الفريد للعميل.
  • START_DATE: تاريخ البدء بالتنسيق YYYY-MM-DD
  • MAX_NUMBER: الحد الأقصى لعدد النتائج المعروضة في صفحة الاستجابة

لا تتضمّن هذه العملية أيّ مَعلمات في محتوى الطلب.

يعرض الاستجابة الناجحة رمز حالة HTTP 200 وقائمة باشتراكات العميل وإعداداته. قد تتضمّن قائمة الاشتراكات منتجات غير مُدارة في هذا الإصدار من Reseller API.

إذا لم تكن تدير هذا العميل، يتم عرض خطأ 403 "Forbidden".

استرداد جميع الاشتراكات القابلة للنقل للعميل

لاسترداد جميع اشتراكات العميل التي يمكن نقلها إلى إدارة المورّد، استخدِم طلب HTTP التالي GET وأضِف الرمز المميّز للتفويض. يجب إدخال القيمة customerId، وهي المعرّف الفريد للعميل الذي يتم عرضه عند استرداد حساب عميل تمت إعادة بيعه. customerAuthToken هو رمز مميّز للنقل يقدّمه العميل ويخصّ معرّف المورِّد. بعد أن ينشئ العميل هذا الرمز، تكون صلاحيته سارية لمدة 30 يومًا. لمزيد من المعلومات عن كيفية إنشاء العملاء للرمز المميّز، يُرجى الاطّلاع على مقالة نقل حسابك على Google Workspace إلى مورِّد.

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID&customerAuthToken=AUTH_TOKEN&pageToken=START_DATE&maxResults=MAX_NUMBER

غيِّر القيم في السلسلة على الشكل التالي:

  • CUSTOMER_ID: إما اسم النطاق الأساسي للعميل أو المعرّف الفريد للعميل.
  • AUTH_TOKEN: رمز مميّز للنقل يقدّمه العميل ويخصّ معرّف المورّد بعد أن ينشئ العميل رمز التفعيل، تصبح صلاحيته سارية لمدة 30 يومًا. لمزيد من المعلومات عن كيفية توليد العملاء للرمز المميّز، يُرجى الاطّلاع على مقالة نقل حسابك على Google Workspace إلى مورِّد. إذا لم تكن هذه القيمة صالحة أو انتهت صلاحيتها، يعرض ردّ واجهة برمجة التطبيقات خطأ 403 "Forbidden".
  • START_DATE: تاريخ البدء بالتنسيق YYYY-MM-DD
  • MAX_NUMBER: الحد الأقصى لعدد النتائج المعروضة في صفحة الاستجابة

لا تتضمّن هذه العملية أيّ مَعلمات في محتوى الطلب.

يعرض الاستجابة الناجحة رمز حالة HTTP 200 وقائمة بالاشتراكات التي يمكن نقلها للعميل مع تاريخ انتهاء صلاحية رمز نقل الاشتراك والحد الأدنى لعدد المقاعد المطلوبة في طلب النقل. قد يكون للعميل اشتراكات إضافية غير قابلة للنقل.

{
  "kind": "reseller#subscriptions",
  "subscriptions": [
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-6543",
      "subscriptionId": "432",
      "skuId": "1010020028",
      "billingMethod": "ONLINE",
      "creationTime": "1331647980142",
      "plan": {
        "planName": "ANNUAL",
        "isCommitmentPlan": true,
        "commitmentInterval": {
          "startTime": "1331647980142",
          "endTime": "1363183980142"
        }
      },
      "seats": {
        "kind": "subscriptions#seats",
        "numberOfSeats": 10,
        "maximumNumberOfSeats": 500,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "transferInfo": {
        "transferabilityExpirationTime": "1333183980142",
        "minimumTransferableSeats": "20"
      },
      "purchaseOrderId": "PO_890",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-6543",
      "subscriptionId": "140",
      "skuId": "1010020028",
      "creationTime": "1329389322728",
      "plan": {
        "planName": "FLEXIBLE",
        "isCommitmentPlan": false
      },
      "seats": {
        "kind": "subscriptions#seats",
        "maximumNumberOfSeats": 50
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false,
        "trialEndTime": "1331877480016"
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "transferInfo": {
        "transferabilityExpirationTime": "1333183780159",
        "minimumTransferableSeats": "10"
      },
      "purchaseOrderId": "",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
  ],
  "nextPageToken": "token"
}

إذا كنت تخطّط لنقل هذه الاشتراكات باستخدام عملية المعالجة المُجمّعة، عليك نقل جميع الاشتراكات. يؤدي نقل كل اشتراك واحد تلو الآخر إلى حدوث خطأ. بالإضافة إلى ذلك، لا تنقل عملية النقل المجمّع سوى الاشتراكات التي تحمل الحالة ACTIVE. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة نقل اشتراك.

استرداد جميع اشتراكات المورّدين

لاسترداد جميع اشتراكات المورّد التي تم طلبها أو نقلها بنجاح، استخدِم طلب HTTP التالي GET وأضِف رمز التفويض. 

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=PREFIX &pageToken=TOKEN&maxResults=MAX_NUMBER

غيِّر القيم في السلسلة على الشكل التالي:

  • PREFIX: بداية اسم العميل الذي تبحث عن اشتراكاته.
  • ‫TOKEN: رمز مميّز يحدِّد صفحة معيّنة من النتائج التي يجب أن يعرضها الخادم.
  • MAX_NUMBER: الحد الأقصى لعدد النتائج المعروضة في صفحة الاستجابة

يمكن أن تستخدِم هذه العملية نطاق الوصول للقراءة فقط في OAuth. ‫ customerNamePrefix وpageToken وmaxResults هي سلاسل طلبات بحث اختيارية.

يستردّ المثال التالي جميع اشتراكات المورّد التي تخصّ العملاء الذين يبدأ اسمهم بـ "exam":

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=exam

{
  "kind": "reseller#subscriptions",
  "subscriptions": [
    {
      "kind": "subscriptions#subscription",
      "customerId": "C0123456",
      "subscriptionId": "123",
      "skuId": "1010020028",
      "creationTime": "1331647980142",
      "billingMethod": "ONLINE",
      "plan": {
        "planName": "ANNUAL",
        "isCommitmentPlan": true,
        "commitmentInterval": {
          "startTime": "1331647980142",
          "endTime": "1363183980142"
        }
      },
      "seats": {
        "kind": "subscriptions#seats",
        "numberOfSeats": 10,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "purchaseOrderId": "PO_135",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-5678",
      "subscriptionId": "1404686",
      "skuId": "1010020028",
      "billingMethod": "ONLINE",
      "creationTime": "1329389322728",
      "plan": {
        "planName": "FLEXIBLE",
        "isCommitmentPlan": false
      },
      "seats": {
        "kind": "subscriptions#seats",
        "maximumNumberOfSeats": 50,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false,
        "trialEndTime": "1331877480016"
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "AUTO_RENEW"
      },
      "purchaseOrderId": "",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
  ],
  "nextPageToken": "token"
}

تعديل خطة اشتراك

يختلف تحديث خطط Google Workspace حسب الخطة. قبل تعديل خطة، يجب مراعاة ما يلي:

  • عند إنشاء اشتراك وكان العميل مؤهلاً، يمكن أن تكون خطة الاشتراك هي فترة تجريبية لمدة 30 يومًا. يمكن أن تكون كل من خطتَي الدفع المرنة والسنوية بالالتزام بفترة تجريبية مجانية لمدة 30 يومًا. أثناء الفترة التجريبية، يمكنك تغيير خطة دفع الاشتراك إلى خطة التزام مرنة أو سنوية حسب الحاجة. ولكن بعد انتهاء الفترة التجريبية وأصبحت الخطة نشطة، يتم تعديل الخطة وفقًا للقواعد نفسها التي تنطبق على الخطط النشطة للاشتراكات الأخرى. لنقل اشتراك تجريبي إلى خطة نشطة على الفور، ابدأ خدمة مدفوعة من اشتراك في فترة تجريبية مجانية لمدة 30 يومًا. لمزيد من المعلومات عن الفترة التجريبية التي تبلغ 30 يومًا وقواعد أهلية العملاء، يُرجى الاطّلاع على مركز مساعدة الإدارة.

  • يمكنك تعديل خطة مرنة إلى خطة التزام سنوية.

  • لا يمكنك تعديل خطة التزام سنوية.

  • لا تتوافق بعض الخطط مع بعض المنتجات. لمزيد من المعلومات حول المنتجات التي تستخدم هذه الخطط، يُرجى الاطّلاع على المنتجات ورموز التخزين التعريفية.

لتعديل خطة اشتراك في فترة تجريبية لمدة 30 يومًا أو خطة مرنة إلى خطة سنوية ملتزمة، استخدِم طلب POST HTTP التالي:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changePlan

غيِّر القيم في السلسلة على الشكل التالي:

  • CUSTOMER_ID: إما اسم النطاق الأساسي للعميل أو المعرّف الفريد للعميل.
  • ‫SUBSCRIPTION_ID: معرّف الاشتراك الذي يمثّل معرّفًا فريدًا لكل عميل. يمكنك استرداد هذه القيمة باستخدام طريقة استرداد جميع اشتراكات المورّدين.

يعدّل المثال التالي الاشتراك باستخدام subscriptionId مع قيمة 123. قيمة العمود customerId هي C0123456.

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changePlan

يحتوي نص الطلب على ما يلي:

{
  "kind": "reseller#changePlanRequest",
  "planName": "ANNUAL_MONTHLY_PAY",
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  "purchaseOrderId": "123_March2012"
}

يعرض الردّ الناجح رمز حالة HTTP 201 ويعرض إعدادات خطة الاشتراك المعدَّلة:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "purchaseOrderId": "123_March2012",
  "status": "ACTIVE",
  "skuName": "Google Workspace Business Standard"
}

تعديل عدد المقاعد في اشتراك

يختلف تعديل اشتراك الخطة السنوية عن تعديل اشتراك الخطة المرنة في Google Workspace، وذلك لأنّه يستخدم سمات اشتراك مختلفة.

تعديل عدد مقاعد اشتراك في خطة سنوية

لتعديل إعدادات ترخيص المستخدم لاشتراك في خطة سنوية، استخدِم طلب HTTP التالي POST:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeSeats

غيِّر القيم في السلسلة على الشكل التالي:

  • CUSTOMER_ID: إما اسم النطاق الأساسي للعميل أو المعرّف الفريد للعميل.
  • ‫SUBSCRIPTION_ID: معرّف الاشتراك الذي يمثّل معرّفًا فريدًا لكل عميل. يمكنك استرداد هذه القيمة باستخدام طريقة استرداد جميع اشتراكات المورّدين.

يعدّل المثال التالي الاشتراك باستخدام 123 subscriptionId. قيمة customerId هي C0123456. يختلف نص الطلب حسب نوع الخطة:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changeSeats

يستخدم اشتراك خطة الاشتراك السنوي في Google Workspace نص الطلب هذا لتعديل عدد تراخيص المستخدمين. قيمة numberOfSeats هي إجمالي. على سبيل المثال، إذا كان لديك في السابق 10 تراخيص مستخدمين وكان لديك سفارش العميل لـ 5 تراخيص جديدة، يكون العدد الإجمالي في نص الطلب لـ numberOfSeats هو 15، كما هو موضّح في المثال التالي:

{
    "kind": "subscriptions#seats",
    "numberOfSeats": 15
}

تعديل عدد المقاعد لاشتراك في خطة مرنة

يستخدم اشتراك الخطة المرنة في Google Workspace نص الطلب لتعديل تراخيص المستخدمين. قيمة maximumNumberOfSeats هي إجمالي الترخيصات الحالية والتراخيص الجديدة. هذا هو الحد الأقصى لعدد تراخيص المستخدمين التي يمكن للحساب توفيرها.

{
  "kind": "subscriptions#seats",
  "maximumNumberOfSeats": 15
}

يعرض الردّ الناجح رمز الحالة HTTP 201 وإعدادات ترخيص الاشتراك المعدَّلة:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "FLEXIBLE",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 15,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "skuName": "Google Workspace Business Standard"
}

تعديل إعدادات تجديد اشتراك

لتعديل إعدادات تجديد اشتراك الدفع السنوي، استخدِم طلب HTTP POST التالي:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeRenewalSettings

غيِّر القيم في السلسلة على الشكل التالي:

  • CUSTOMER_ID: إما اسم النطاق الأساسي للعميل أو المعرّف الفريد للعميل.
  • ‫SUBSCRIPTION_ID: معرّف الاشتراك الذي يمثّل معرّفًا فريدًا لكل عميل. يمكنك استرداد هذه القيمة باستخدام طريقة استرداد جميع اشتراكات المورّدين.

في ما يلي مثال على نص الطلب:

{
  "kind": "subscriptions#renewalSettings",
  "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
}

يمكن أن تكون قيمة السمة renewalType أيًّا ممّا يلي:

  • AUTO_RENEW_YEARLY_PAY: في نهاية الفاصل الزمني لخطة الاشتراك السنوية، يتم تجديد خطة الاشتراك تلقائيًا كخطة ANNUAL_YEARLY_PAY مع numberOfSeats نفسه.
  • AUTO_RENEW_MONTHLY_PAY: في نهاية الفاصل الزمني لخطة الالتزام السنوية، يتم تجديد خطة الاشتراكات تلقائيًا كخطة ANNUAL_MONTHLY_PAY باستخدام numberOfSeats نفسه.
  • RENEW_CURRENT_USERS_YEARLY_PAY: في نهاية الفاصل الزمني لأحد خطط الاشتراك السنوي، يمكنك تجديد خطة الاشتراك على أنّها ANNUAL_YEARLY_PAY، ولكن استخدِم إجمالي عدد تراخيص المستخدمين النشطين الحاليين. هذا هو الإعداد default لخطط الاشتراك السنوي النشطة (الدفع سنويًا).
  • RENEW_CURRENT_USERS_MONTHLY_PAY: في نهاية الفاصل الزمني لأحد خطط الاشتراك السنوي، يمكنك تجديد خطة الاشتراك على أنّها ANNUAL_MONTHLY_PAY، ولكن استخدِم إجمالي عدد تراخيص المستخدمين النشطين الحاليين. هذا هو الإعداد default لخطط الاشتراك السنوي النشطة (الدفع شهريًا).
  • RENEW_ON_PROPOSED_OFFER: في نهاية الفاصل الزمني لخطة الالتزام الحالية، يتم التجديد وفقًا لآخر اقتراح للتجديد مع تحديد عدد المقاعد على أنّه عدد تراخيص المستخدمين النشطين الحاليين أو التزام العرض المقترَح، أيهما أكبر.
  • SWITCH_TO_PAY_AS_YOU_GO: في نهاية الفاصل الزمني لخطة الاشتراك السنوي، يمكنك تغيير خطة الاشتراك السنوي إلى خطة مرنة.
  • CANCEL: في نهاية فاصل الخطة السنوية، يتم تعليق الاشتراك. للتعرّف على كيفية رفع التعليق، يُرجى الاطّلاع على مركز مساعدة المشرف.

يعرض الردّ الناجح رمز الحالة HTTP 201 وإعدادات تجديد الاشتراك المعدَّلة:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 15,
    "licensedNumberOfSeats": 15
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "skuName": "Google Workspace Business Standard"
}

بدء الخدمة المدفوعة من اشتراك في فترة تجريبية مجانية

لنقل اشتراك في فترة تجريبية مجانية لمدة 30 يومًا إلى اشتراك في خدمة مدفوعة، في حال سبق إعداد خطة دفع للاشتراك في الفترة التجريبية، استخدِم طلب HTTP التالي POST. 

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/startPaidService

غيِّر القيم في السلسلة على الشكل التالي:

  • CUSTOMER_ID: إما اسم النطاق الأساسي للعميل أو المعرّف الفريد للعميل.
  • ‫SUBSCRIPTION_ID: معرّف الاشتراك الذي يمثّل معرّفًا فريدًا لكل عميل. يمكنك استرداد هذه القيمة باستخدام طريقة استرداد جميع اشتراكات المورّدين.

يتضمّن المثال التالي C0123456 كقيمة customerId وقيمة subscriptionId‏ 123:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/startPaidService

لا تتضمّن هذه العملية أيّ مَعلمات في محتوى الطلب.

تعرِض الاستجابة الناجحة رمز الحالة HTTP 201 وإعدادات الاشتراك المعدَّلة:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 15,
    "licensedNumberOfSeats": 15
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "skuName": "Google Workspace Business Standard"
}

ترقية اشتراك أو الرجوع إلى إصدار سابق منه

لا يمكنك الرجوع إلى خطة أقل كلفة من الخطط السنوية في منتصف مدة الخطة، ولا يمكنك تحديد موعد لذلك باستخدام إعدادات التجديد. ننصحك بضبط إعدادات التجديد للتبديل إلى FLEXIBLE ثم الرجوع إلى الإصدار الأقدم بعد انتهاء مدة التجديد.

لترقية اشتراك أو الرجوع إلى إصدار سابق منه، أنشئ اشتراكًا جديدًا بالskuId الذي تريد الترقية إليه أو الرجوع إليه.

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

غيِّر القيم في السلسلة على الشكل التالي:

  • CUSTOMER_ID: إما اسم النطاق الأساسي للعميل أو المعرّف الفريد للعميل.

تؤدي هذه المكالمة إلى إنهاء الاشتراك السابق وإنشاء اشتراك جديد.

يمكنك العثور على مزيد من المعلومات حول عمليات الترقية والخفض في صفحة "المنتجات والرموز التعريفية للمنتجات".