Method: customers.getSubscriptionInfo

تعرض هذه الطريقة معلومات مجمّعة عن الاشتراكات والتراخيص لعميل معيّن كمورد فردي. ملاحظة: بما أنّ البيانات يتم أخذ لقطة منها لأجهزة ChromeOS، يمكن أن يتأخر ظهور الأرقام الدقيقة لمدة تصل إلى 10 ثوانٍ.

طلب HTTP

GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
name

string

الحقل مطلوب. اسم المورِد الخاص بمعلومات اشتراك العميل المطلوب استردادها. التنسيق: customers/{customer}/subscriptionInfo

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

مورد فردي يمثّل معلومات الاشتراك والترخيص لعميل معيّن.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "name": string,
  "chromeEnterpriseUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
الحقول
name

string

المعرّف. اسم مورد معلومات اشتراك العميل، بالتنسيق: customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

النتائج فقط. تفاصيل حول رمز التخزين التعريفي السنوي لـ "ترقية Chrome Enterprise"

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

النتائج فقط. تفاصيل حول رمز التخزين التعريفي السنوي لـ "ترقية Kiosk & Signage"

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

النتائج فقط. تفاصيل حول رمز التخزين التعريفي الدائم لـ "ترقية Chrome Enterprise" أو "ترقية Chrome Education"

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/chrome.management.subscriptions.readonly

AnnualSubscriptionInfo

معلومات حول الاشتراكات/التراخيص المتكررة سنويًا

تمثيل JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
الحقول
counts

object (LicenseCounts)

النتائج فقط. عدد التراخيص لهذا الاشتراك

subscriptionEndTime

string (Timestamp format)

النتائج فقط. التاريخ الذي تنتهي فيه مدة الاشتراك الحالية.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

LicenseCounts

عدد الموارد لنوع ترخيص معيّن

تمثيل JSON
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
الحقول
totalPurchasedCount

string (int64 format)

النتائج فقط. إجمالي عدد التراخيص التي تم شراؤها

assignedCount

string (int64 format)

النتائج فقط. إجمالي عدد التراخيص المخصّصة حاليًا للمستخدمين أو الأجهزة

unassignedCount

string (int64 format)

النتائج فقط. إجمالي عدد التراخيص المتاحة للتخصيص

PerpetualLicenseInfo

معلومات حول التراخيص الدائمة

تمثيل JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
الحقول
counts

object (LicenseCounts)

النتائج فقط. عدد التراخيص لرمز التخزين التعريفي الدائم

retiredCount

string (int64 format)

النتائج فقط. عدد الترقيات الدائمة التي تم شراؤها ولكن لم تعُد متاحة للتسجيل وهي ترقيات دائمة تم تسجيلها على جهاز تمت إزالته ولا يمكن نقل الترقية أو إعادة استخدامها على جهاز آخر. التراخيص التي تمت إزالتها هي مجموعة فرعية من إجمالي التراخيص المخصّصة.

conditionallyAvailableCount

string (int64 format)

النتائج فقط. عدد الترقيات الدائمة المستقلة التي سبق تسجيلها ثم إلغاء تسجيلها لاحقًا لأسباب متعلّقة بإذن إعادة السلع أو الضمان أو الإصلاح، والتي لا يمكن إعادة استخدامها إلا على جهاز من الطراز نفسه التراخيص المتوفّرة بشروط هي مجموعة فرعية من إجمالي التراخيص المخصّصة.