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

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

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

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

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