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

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

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

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

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

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

إنشاء اشتراك

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

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لمعرّف وحدة التخزين التعريفية (SKU) الذي يملكه العميل فعليًا على أنّه transferInfo.currentLegacySkuId. للحصول على قائمة كاملة بـ skuIds والمنتجات التي تستخدمها هذه الخطط، يُرجى الاطّلاع على المنتجات ورموز التخزين التعريفية.

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