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