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

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

• اشتراك في اشتراك سنوي
• اشتراك مرن
• فترة تجريبية مجانية لمدة 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 للاشتراك. إذا تغير العميل من رمز التخزين التعريفي الأصلي، ستتم إزالة الخصم.

لا تسري رموز الصفقات في الحالات التالية:

إنشاء خطط تجريبية

• لا يمكنك تقديم خصم على خطة تجريبية إلا عند الترقية إلى خطة مدفوعة من خلال تقديم رمز صفقة باستخدام مكالمة changePlan.

جارٍ نقل الاشتراكات

• تسري الأسعار العادية في حال نقل اشتراك بسعر مخفَّض.

لإنشاء اشتراك في اشتراك سنوي بسعر مخفّض لحساب عميل تم إنشاؤه حديثًا، استخدِم طلب 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رمز التخزين التعريفي الذي أرجعه العميل على أنّه transferInfo.currentLegacySkuId. للحصول على قائمة كاملة بـ skuIds والمنتجات التي تستخدمها هذه الخطط، يمكنك مراجعة المنتجات ورموز التخزين التعريفية.

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