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

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

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

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

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

لا يمكن للعملاء الذين لديهم customerType = 'team' شراء إصدارَي Google Workspace Essentials وGoogle Workspace 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 يومًا.

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

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

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