- בקשת HTTP
- פרמטרים של נתיבים
- גוף הבקשה
- גוף התשובה
- היקפי הרשאות
- AnnualSubscriptionInfo
- LicenseCounts
- PerpetualLicenseInfo
- כדאי לנסות!
אחזור מידע מצטבר על מינויים ורישיונות של לקוח מסוים כמשאב יחיד. הערה: הנתונים מצולמים במכשירי ChromeOS, ולכן יכול להיות עיכוב של עד 10 שניות במספרים המדויקים.
בקשת HTTP
GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}
כתובת ה-URL כתובה בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
name |
חובה. שם המשאב של פרטי המינוי של הלקוח שרוצים לאחזר. פורמט: customers/{customer}/subscriptionInfo |
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
מקור מידע יחיד שמייצג את המינוי ואת פרטי הרישיון של לקוח מסוים.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
| ייצוג JSON |
|---|
{ "name": string, "chromeEnterpriseUpgradeAnnual": { object ( |
| שדות | |
|---|---|
name |
מזהה. שם המשאב של פרטי המינוי של הלקוח. הפורמט: customers/{customer}/subscriptionInfo |
chromeEnterpriseUpgradeAnnual |
פלט בלבד. פרטים על מק"ט שנתי של שדרוג ל-Chrome Enterprise. |
kioskSignageUpgradeAnnual |
פלט בלבד. פרטים על מק "ט שנתי של שדרוג של מכשירים לחתימה דיגיטלית ומכשירים במצב קיוסק. |
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 |
פלט בלבד. מספר השדרוגים הקבועים העצמאיים שנרשמו בעבר ואחר כך בוטלה ההרשמה שלהם בגלל סיבות שקשורות ל-RMA, לאחריות או לתיקון. הם זמינים לשימוש חוזר רק במכשירים מאותו מודל. רישיונות שזמינים באופן מותנה הם קבוצת משנה של סך הרישיונות שהוקצו. |