إنشاء اشتراك أو نقله

بعد طلب حساب عميل، يمكنك إنشاء عدد من الاشتراكات المختلفة:

  • اشتراك سنوي
  • اشتراك مرن
  • فترة تجريبية مجانية لمدة 30 يومًا
  • اشتراك بسعر مخفّض

لمزيد من المعلومات حول المنتجات التي تستخدمها هذه الاشتراكات، يُرجى الاطّلاع على المنتجات ورموز التخزين التعريفية:

إذا لم تطلب حساب هذا العميل، يمكنك نقل اشتراك

يمكن للعملاء الذين لديهم customerType = 'team' شراء اشتراك Essentials و إصدارات Enterprise Essentials من Google Workspace. إذا حاولت شراء لأي اشتراك من اشتراكات Google Workspace الأخرى، يمكنك خطأ—Customer is not eligible to purchase this subscription العملاء قد لا يتمكّن المستخدمون من معالجة اشتراكات Essentials أو الاشتراكات المستندة إلى الاستخدام. خطط الاشتراك السنوي وتتوفّر فيها خيارات محدودة للترقية والرجوع إلى إصدار سابق.

إنشاء اشتراك

لإنشاء اشتراك لحساب عميل تم إنشاؤه حديثًا، يمكنك استخدام طلب HTTP التالي POST وتضمين الرمز المميز للتفويض:

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

تمثّل السمة CUSTOMER_ID إما اسم النطاق الأساسي للعميل أو المعرّف الفريد الخاص به الذي تم إرجاعه عند استرداد حساب عميل توريد.

إنشاء خطة اشتراك سنوي

بالنسبة إلى اشتراكات خطة الاشتراك السنوي، لا تتطابق جميع رموز التخزين التعريفية مع إعدادات التجديد الافتراضية. ننصحك بتجاوز renewalSettings دائمًا. إنشاء المحتوى اشتراك سنوي يضم 10 مقاعد:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  renewalSettings: {
    "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

استبدِل ما يلي:

  • CUSTOMER_ID: إما النطاق الأساسي للعميل اسمك أو المعرّف الفريد للعميل.
  • SKU_ID: وحدة الاحتفاظ بالمخزون الفريدة (SKU) المُعرف. لمزيد من المعلومات، يُرجى مراجعة المنتجات معرّفات رموز التخزين التعريفية:
  • PURCHASE_ORDER_ID: طلب شراء اختياري رقم تعريف يمكنك استخدامه لتتبُّع الاستخدام.

تؤدي الاستجابة الناجحة إلى عرض حالة HTTP 200 وحالة الاشتراك الجديد. الإعدادات لخطة اشتراك سنوي يتم إرجاع ANNUAL_MONTHLY_PAY على أنّه ANNUAL في كل الردود من واجهة برمجة التطبيقات.

في ما يلي مثال على الرد على الخطة السنوية:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "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": "my_example.com_annual_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

إنشاء خطة مرنة

لإنشاء اشتراك مرن لحساب عميل تم إنشاؤه حديثًا، يُرجى استخدام طلب HTTP POST التالي وتضمين الرمز المميز للتفويض:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "FLEXIBLE"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

استبدِل ما يلي:

  • CUSTOMER_ID: إما النطاق الأساسي للعميل اسمك أو المعرّف الفريد للعميل.
  • SKU_ID: وحدة الاحتفاظ بالمخزون الفريدة (SKU) المُعرف. لمزيد من المعلومات، يُرجى مراجعة المنتجات معرّفات رموز التخزين التعريفية:
  • PURCHASE_ORDER_ID: طلب شراء اختياري رقم تعريف يمكنك استخدامه لتتبُّع الاستخدام.

فيما يلي مثال على استجابة الخطة المرنة:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "FLEXIBLE",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10,
    "licensedNumberOfSeats": 0
  },
  "trialSettings": {
    "isInTrial": false
  },
  "purchaseOrderId": "my_example_flex_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

إنشاء فترة تجريبية مجانية

لإنشاء اشتراك في إصدار تجريبي مجاني لمدة 30 يومًا لعميل تم إنشاؤه حديثًا عليك استخدام طلب HTTP POST التالي وتضمين التفويض الرمز المميز:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "TRIAL"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

استبدِل ما يلي:

  • CUSTOMER_ID: إما النطاق الأساسي للعميل اسمك أو المعرّف الفريد للعميل.
  • SKU_ID: وحدة الاحتفاظ بالمخزون الفريدة (SKU) المُعرف. لمزيد من المعلومات، يُرجى مراجعة المنتجات معرّفات رموز التخزين التعريفية:
  • PURCHASE_ORDER_ID: طلب شراء اختياري رقم تعريف يمكنك استخدامه لتتبُّع الاستخدام.

فيما يلي مثال على استجابة خطة تجريبية مجانية لمدة 30 يومًا:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "TRIAL",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10,
    "licensedNumberOfSeats": 0
  },
  "trialSettings": {
    "isInTrial": true,
    "trialEndTime": "1331648420142"
  },
  "purchaseOrderId": "my_example_trial_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

إنشاء اشتراك بسعر مخفَّض

قد توفّر Google رمز صفقة لإنشاء الاشتراكات بسعر مخفَّض. المعدل. لخصم اشتراك، عليك تقديم رمز الصفقة في مكالمة insert المتعلقة بالاشتراك. إذا تغير العميل من رمز التخزين التعريفي الأصلي، ستتم إزالة التخفيض.

لإنشاء اشتراك سنوي مخفّض تم إنشاؤه حديثًا، يُرجى اتّباع الخطوات التالية: حساب العميل، استخدِم طلب HTTP POST التالي وأضِف رمز التفويض المميز:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  renewalSettings: {
    "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID",
  "dealCode": "GOOGLE_CONTRACT_DEAL_CODE"
}

استبدِل ما يلي:

  • CUSTOMER_ID: إما النطاق الأساسي للعميل اسمك أو المعرّف الفريد للعميل.
  • SKU_ID: وحدة الاحتفاظ بالمخزون الفريدة (SKU) المُعرف. لمزيد من المعلومات، يُرجى مراجعة المنتجات معرّفات رموز التخزين التعريفية:
  • PURCHASE_ORDER_ID: طلب شراء اختياري رقم تعريف يمكنك استخدامه لتتبُّع الاستخدام.
  • GOOGLE_CONTRACT_DEAL_CODE: يتوفّر رمز خصم. من Google.

في ما يلي مثال على ردّ لخطة سنوية بخصم:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "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": "my_example.com_annual_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "dealCode": "GOOGLE_CONTRACT_DEAL_CODE",
  "skuName": "Google Workspace Business Standard"
}

نقل اشتراك

إذا لم تكن قد طلبت حساب العميل باستخدام طلب حساب عميل جديد استخدام الرمز المميز للنقل الخاص بالعميل عند إنشاء اشتراك هذا العميل.

لإنشاء اشتراك لحساب عميل لم تطلبه، استخدم طلب HTTP POST التالي:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE

استبدِل ما يلي:

  • CUSTOMER_ID: إما النطاق الأساسي للعميل اسمك أو المعرّف الفريد للعميل.
  • TOKEN_VALUE: رمز مميّز للنقل يوفّره العميل. بعد إنشاء العميل للرمز المميز، يكون صالحًا لمدة 30 يومًا.

لمزيد من المعلومات حول كيفية حصول العملاء على رمز مميّز للنقل، يمكنك الاطّلاع على مركز مساعدة Google Workspace

لنقل اشتراك عميل في خطة اشتراك سنوية، يجب استخدام طلب HTTP التالي POST وتضمين الرمز المميز للتفويض:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions?customerAuthToken=auth token
{
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

استبدِل ما يلي:

  • CUSTOMER_ID: إما النطاق الأساسي للعميل اسمك أو المعرّف الفريد للعميل.
  • SKU_ID: وحدة الاحتفاظ بالمخزون الفريدة (SKU) المُعرف. لمزيد من المعلومات، يُرجى مراجعة المنتجات معرّفات رموز التخزين التعريفية:
  • PURCHASE_ORDER_ID: طلب شراء اختياري رقم تعريف يمكنك استخدامه لتتبُّع الاستخدام.

الاستجابة الناجحة تعرض حالة HTTP 200 الرمز وإعدادات الاشتراك المنقول خطة الاشتراك السنوي:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "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": "example.com_annual_1",
  "status": "ACTIVE",
  "resourceUiUrl": "URL to customer's Admin console dashboard",
  "skuName": "Google Workspace Business Standard"
}

القيود المفروضة على النقل

في حال نقل اشتراك Google Workspace مع حساب Google Drive مرتبط به أو اشتراك Google Vault، استخدم عملية batch لنقل جميع الاشتراكات بالحالة ACTIVE. نقل كل منها يؤدي الاشتراك واحدًا تلو الآخر إلى حدوث خطأ.

لا يُسمح بنقل الاشتراكات المعلَّقة إلا إذا كان سبب التعليق PENDING_TOS_ACCEPTANCE أو TRIAL_ENDED أو RENEWAL_WITH_TYPE_CANCEL

عند نقل رمز تخزين تعريفي قديم، يعرض subscriptions.list الرمز skuId. لرمز التخزين التعريفي الذي يجب نقله. تمثل skuIdلرمز التخزين التعريفي الذي يتم إرجاع customervفي الواقع كـ transferInfo.currentLegacySkuId. بالنسبة إلى القائمة الكاملة لـ "skuIds" والمنتجات التي تستخدمها هذه الخطط، اطّلِع على المنتجات ورموز التخزين التعريفية:

لا يمكن استخدام عمليات النقل مع رموز صفقات الخصم.