المورد: الاشتراك
نموذج JSON للاشتراك.
تمثيل JSON |
---|
{ "customerId": string, "subscriptionId": string, "skuId": string, "creationTime": string, "kind": string, "seats": { object ( |
الحقول | |
---|---|
customerId |
سيتم دائمًا عرض هذه السمة في الرد باعتباره المعرّف الفريد الذي أنشأته Google. في الطلب، يمكن أن يكون هذا الموقع هو النطاق الأساسي أو المعرّف الفريد الذي أنشأته Google. |
subscriptionId |
|
skuId |
خاصية مطلوبة. |
creationTime |
السمة |
kind |
لتعريف المورد باعتباره اشتراكًا. القيمة: |
seats |
هذه الخاصية مطلوبة. عدد تراخيص مقاعد المستخدمين وحدودها في الخطة |
renewalSettings |
إعدادات التجديد لخطة الاشتراك السنوي للمزيد من المعلومات التفصيلية، يمكنك الاطّلاع على خيارات التجديد في مركز مساعدة المشرفين. |
purchaseOrderId |
هذه سمة اختيارية. إنّ معلومات طلب الشراء هذه (PO) مخصّصة للمورّدين لاستخدامها في تتبّع استخدام شركتهم. في حال تقديم قيمة |
status |
هذه سمة اختيارية. |
resourceUiUrl |
عنوان URL يؤدي إلى صفحة اشتراكات العميل في وحدة تحكم المشرف. يتم إنشاء عنوان URL للقراءة فقط بواسطة خدمة واجهة برمجة التطبيقات. يتم استخدام هذه الطريقة في حال كان تطبيق العميل يتطلّب من العميل إكمال مهمة باستخدام صفحة "الاشتراكات" في "وحدة تحكُّم المشرف". |
billingMethod |
حقل للقراءة فقط يعرض طريقة الفوترة الحالية لاشتراك. |
suspensionReasons[] |
حقل للقراءة فقط يتضمّن تعدادًا لجميع أسباب التعليق الحالية للاشتراك. يمكن أن يكون للاشتراك عدة أسباب متداخلة متزامنة. ويكون الاشتراك
|
customerDomain |
اسم النطاق الأساسي للعميل |
dealCode |
الرمز الذي أصدرته Google (100 حرف كحد أقصى) للأسعار المخفّضة على خطط الاشتراك. يجب تضمين رمز الصفقة في طلبات |
skuName |
الاسم المعروض الخارجي للقراءة فقط لرمز التخزين التعريفي (SKU) الخاص بالمنتج المُخصَّص للعميل في الاشتراك. تخضع أسماء رموز التخزين التعريفية للتغيير وفقًا لتقدير Google الخاص. بالنسبة إلى المنتجات ورموز التخزين التعريفية المتوفّرة في هذا الإصدار من واجهة برمجة التطبيقات، يمكنك الاطّلاع على معرّفات المنتجات ورموز التخزين التعريفية. |
plan |
السمة |
plan.planName |
السمة
|
plan.isCommitmentPlan |
تحدّد القيمة المنطقية للخاصية
|
plan.commitmentInterval |
في هذا الإصدار من واجهة برمجة التطبيقات، تبلغ مهلة خطة الاشتراك السنوية سنة واحدة. |
plan.commitmentInterval.startTime |
خطة اشتراك سنوية تبلغ |
plan.commitmentInterval.endTime |
خطة اشتراك سنوية تبلغ |
trialSettings |
يمكن أن يكون الاشتراك السنوي في G Suite وخطط الدفع المرنة في فترة تجريبية مجانية لمدة 30 يومًا. لمزيد من المعلومات، يُرجى الاطّلاع على مفاهيم واجهة برمجة التطبيقات. |
trialSettings.isInTrial |
يحدِّد ما إذا كانت خطة الاشتراك في فترة تجريبية مجانية لمدة 30 يومًا أم لا:
|
trialSettings.trialEndTime |
التاريخ الذي تنتهي فيه الفترة التجريبية. تكون القيمة بالمللي ثانية باستخدام تنسيق حقبة UNIX. يُرجى الاطّلاع على مثال لمحوّل النهاية. |
transferInfo |
المعلومات ذات الصلة بالقراءة فقط لنقل الاشتراك. لمزيد من المعلومات، يُرجى الاطِّلاع على استرداد الاشتراكات القابلة للنقل لعميل. |
transferInfo.transferabilityExpirationTime |
الوقت الذي ستنتهي فيه صلاحية الرمز المميّز للنقل أو نية النقل. الوقت بالمللي ثانية باستخدام تنسيق UNIX Epoch. |
transferInfo.minimumTransferableSeats |
تمثّل هذه السمة الحدّ الأدنى لعدد المقاعد المُدرجة في طلب نقل المنتج عند إدراج اشتراك. على سبيل المثال، إذا كان لدى العميل 20 مستخدمًا، لا يمكن للمورّد تقديم طلب نقل يبلغ 15 مقعدًا. الحد الأدنى هو 20 مقعدًا. |
transferInfo.currentLegacySkuId |
|
عدد المقاعد
نموذج JSON لمقاعد الاشتراك.
تمثيل JSON |
---|
{ "numberOfSeats": integer, "maximumNumberOfSeats": integer, "licensedNumberOfSeats": integer, "kind": string } |
الحقول | |
---|---|
numberOfSeats |
هذا الموقع مطلوب ويقتصر على الاشتراكات التي تشمل خطط |
maximumNumberOfSeats |
هذا الموقع مطلوب ويقتصر على الاشتراكات التي تشمل خطط |
licensedNumberOfSeats |
حقل للقراءة فقط يحتوي على العدد الحالي للمستخدمين الذين تم منحهم ترخيص للمنتج المحدد في |
kind |
يحدّد المورد على أنه إعداد مقعد اشتراك. القيمة: |
إعدادات التجديد
نموذج JSON لإعدادات تجديد الاشتراك
تمثيل JSON |
---|
{ "renewalType": string, "kind": string } |
الحقول | |
---|---|
renewalType |
إعدادات التجديد لخطة الاشتراك السنوي للمزيد من المعلومات التفصيلية، يمكنك الاطّلاع على خيارات التجديد في مركز مساعدة المشرفين. عند تجديد الاشتراك، يجب استخدام |
kind |
تحدّد المورد على أنه إعداد تجديد اشتراك. القيمة: |
الطُرق |
|
---|---|
|
تفعيل اشتراك تم تعليقه سابقًا من قبل المورد. |
|
يتم تعديل خطة اشتراك. |
|
يعدّل إعدادات تجديد ترخيص المستخدم. |
|
لتعديل إعدادات ترخيص المستخدم. |
|
إلغاء اشتراك أو تعليقه أو نقله إلى مباشر. |
|
الحصول على اشتراك معيّن. |
|
إنشاء اشتراك أو نقله. |
|
قوائم الاشتراكات التي يديرها المورّد. |
|
نقل الاشتراك التجريبي المجاني لمدة 30 يومًا إلى اشتراك خدمة مدفوعة فورًا. |
|
يعلّق هذا الاشتراك اشتراكًا نشطًا. |