Method: customers.getSubscriptionInfo

אחזור מידע מצטבר על מינויים ורישיונות של לקוח מסוים כמשאב יחיד. הערה: הנתונים מצולמים במכשירי ChromeOS, ולכן יכול להיות עיכוב של עד 10 שניות במספרים המדויקים.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
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)

פלט בלבד. פרטים על מק "ט שנתי של שדרוג של מכשירים לחתימה דיגיטלית ומכשירים במצב קיוסק.

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)

פלט בלבד. מספר השדרוגים הקבועים העצמאיים שנרשמו בעבר ואחר כך בוטלה ההרשמה שלהם בגלל סיבות שקשורות ל-RMA, לאחריות או לתיקון. הם זמינים לשימוש חוזר רק במכשירים מאותו מודל. רישיונות שזמינים באופן מותנה הם קבוצת משנה של סך הרישיונות שהוקצו.