- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات الأذونات
- AnnualSubscriptionInfo
- LicenseCounts
- PerpetualLicenseInfo
- جرِّبه الآن
تعرض هذه الطريقة معلومات مجمّعة عن الاشتراكات والتراخيص لعميل معيّن كمورد فردي. ملاحظة: بما أنّ البيانات يتم أخذ لقطة منها لأجهزة ChromeOS، يمكن أن يتأخر ظهور الأرقام الدقيقة لمدة تصل إلى 10 ثوانٍ.
طلب HTTP
GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
مَعلمات المسار
| المعلمات | |
|---|---|
name |
الحقل مطلوب. اسم المورِد الخاص بمعلومات اشتراك العميل المطلوب استردادها. التنسيق: customers/{customer}/subscriptionInfo |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
مورد فردي يمثّل معلومات الاشتراك والترخيص لعميل معيّن.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
|---|
{ "name": string, "chromeEnterpriseUpgradeAnnual": { object ( |
| الحقول | |
|---|---|
name |
المعرّف. اسم مورد معلومات اشتراك العميل، بالتنسيق: customers/{customer}/subscriptionInfo |
chromeEnterpriseUpgradeAnnual |
النتائج فقط. تفاصيل حول رمز التخزين التعريفي السنوي لـ "ترقية Chrome Enterprise" |
kioskSignageUpgradeAnnual |
النتائج فقط. تفاصيل حول رمز التخزين التعريفي السنوي لـ "ترقية Kiosk & Signage" |
chromePerpetualUpgrade |
النتائج فقط. تفاصيل حول رمز التخزين التعريفي الدائم لـ "ترقية Chrome Enterprise" أو "ترقية Chrome Education" |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.subscriptions.readonly
AnnualSubscriptionInfo
معلومات حول الاشتراكات/التراخيص المتكررة سنويًا
| تمثيل JSON |
|---|
{
"counts": {
object ( |
| الحقول | |
|---|---|
counts |
النتائج فقط. عدد التراخيص لهذا الاشتراك |
subscriptionEndTime |
النتائج فقط. التاريخ الذي تنتهي فيه مدة الاشتراك الحالية. يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
LicenseCounts
عدد الموارد لنوع ترخيص معيّن
| تمثيل JSON |
|---|
{ "totalPurchasedCount": string, "assignedCount": string, "unassignedCount": string } |
| الحقول | |
|---|---|
totalPurchasedCount |
النتائج فقط. إجمالي عدد التراخيص التي تم شراؤها |
assignedCount |
النتائج فقط. إجمالي عدد التراخيص المخصّصة حاليًا للمستخدمين أو الأجهزة |
unassignedCount |
النتائج فقط. إجمالي عدد التراخيص المتاحة للتخصيص |
PerpetualLicenseInfo
معلومات حول التراخيص الدائمة
| تمثيل JSON |
|---|
{
"counts": {
object ( |
| الحقول | |
|---|---|
counts |
النتائج فقط. عدد التراخيص لرمز التخزين التعريفي الدائم |
retiredCount |
النتائج فقط. عدد الترقيات الدائمة التي تم شراؤها ولكن لم تعُد متاحة للتسجيل وهي ترقيات دائمة تم تسجيلها على جهاز تمت إزالته ولا يمكن نقل الترقية أو إعادة استخدامها على جهاز آخر. التراخيص التي تمت إزالتها هي مجموعة فرعية من إجمالي التراخيص المخصّصة. |
conditionallyAvailableCount |
النتائج فقط. عدد الترقيات الدائمة المستقلة التي سبق تسجيلها ثم إلغاء تسجيلها لاحقًا لأسباب متعلّقة بإذن إعادة السلع أو الضمان أو الإصلاح، والتي لا يمكن إعادة استخدامها إلا على جهاز من الطراز نفسه التراخيص المتوفّرة بشروط هي مجموعة فرعية من إجمالي التراخيص المخصّصة. |