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

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

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

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

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

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

إنشاء اشتراك

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

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"
}

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

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

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 يومًا لحساب عميل تم إنشاؤه حديثًا، استخدِم طلب POST HTTP التالي وأضِف رمز التفويض:

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 الاشتراك. إذا غيّر العميل رمز التخزين التعريفي (SKU) الأصلي، تتم إزالة الخصم.

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

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"
}

نقل اشتراك

إذا لم تطلب حساب العميل باستخدام عملية طلب حساب عميل جديد ، استخدِم الرمز المميّز لنقل بيانات العميل عند إنشاء اشتراك للعميل.

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

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

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

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

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

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

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: معرّف اختياري لطلب الشراء يمكنك استخدامه لتتبُّع الاستخدام.

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

{
  "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 والمنتجات التي تستخدم هذه الخطط، يُرجى الاطّلاع على المنتجات ورموز التخزين التعريفية.

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