סקירה כללית על תכונות ה-API זמינה ב-Chrome Management Reports API.
כל הבקשות שמוצגות למטה משתמשות במשתנים הבאים:
$TOKEN– אסימון OAuth 2$CUSTOMER– מספר הלקוח או מספר הלקוחmy_customer$ORG_UNIT_ID– מזהה של יחידה ארגונית ספציפית שעבורה רוצים ליצור בקשה.
ספירת גרסאות Chrome הפעילות בטווח התאריכים
כדי לראות אילו גרסאות של Chrome היו פעילות לאורך פרק זמן מסוים, צריך להשתמש בערך last_active_date בפרמטר filter. אפשר לשלוט בעימוד של התוצאות באמצעות הפרמטרים pageSize ו-pageToken.
בקשה
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countChromeVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"
תשובה
{
"browserVersions": [
{
"count": "1",
"version": "85.0.4183.83",
"system": "SYSTEM_MAC",
"channel": "STABLE"
},
{
"count": "1",
"version": "85.0.4183.102",
"system": "SYSTEM_WINDOWS",
"channel": "STABLE"
},
{
"count": "13697",
"version": "71.0.3578.96",
"system": "SYSTEM_MAC",
"channel": "STABLE"
},
{
"count": "1",
"version": "87.0.4280.40",
"system": "SYSTEM_MAC",
"channel": "BETA"
},
{
"count": "1",
"version": "88.0.4314.0",
"system": "SYSTEM_MAC",
"channel": "CANARY"
},
{
"count": "1718"
},
],
"totalSize": 5
}
ספירת התפלגות של התקנות אפליקציה עם מספר הרשאות
כדי להציג את מספר המכשירים שבהם הותקנה אפליקציה מסוימת עם מספר הרשאות נתון, צריך להשתמש בערך number_of_permissions בפרמטר filter. אפשר לשלוט בעימוד התוצאות באמצעות הפרמטרים pageSize ו-pageToken.
לפרמטרים נוספים של סינון, עיינו בחומר העזר.
בקשה
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countInstalledApps?filter=number_of_permissions>6"
תשובה
{
"totalSize": 1,
"installedApps": [
{
"browserDeviceCount": "2",
"appSource": "CHROME_WEBSTORE",
"displayName": "Secure Shell App",
"description": "Terminal emulator and SSH and SFTP client.",
"appType": "APP",
"appInstallType": "ADMIN",
"appId": "pnhechapfaindjhompbnflcldabbghjo",
"homepageUri": "https://chrome.google.com/webstore/detail/pnhechapfaindjhompbnflcldabbghjo",
"permissions": [
"clipboardRead",
"clipboardWrite",
"crashReportPrivate",
"idle",
"metricsPrivate",
"notifications",
"storage",
"unlimitedStorage"
]
},
]
}
ספירת מכשירים שמותקנת בהם אפליקציה מותקנת
בדוגמה הקודמת הוצגה אפליקציה שהותקנה בשני מכשירים.
כדי להציג את המכשירים שבהם הותקנה האפליקציה הזו, אפשר להשתמש בשיטה findInstalledAppDevices בהתאמה אישית.
ניתן לשלוט בעימוד של התוצאות באמצעות הפרמטרים pageSize ו-pageToken.
בקשה
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findInstalledAppDevices?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"
תשובה
{
"totalSize": 2,
"devices": [
{
"machine": "MACHINEA-A",
"deviceId": "b472473e-fe50-4c6e-9ac3-03fe0d0753ce"
},
{
"machine": "MACHINE-B",
"deviceId": "a5f49e54-b07b-409f-bc5c-aaf27c483249"
}
]
}
בקשת מעקב
בהתאם למזהה המכשיר שהוחזר בדוגמה הקודמת, בעזרת Admin SDK Directory API לדפדפני Chrome אתם יכולים לקבל מידע נוסף על המכשיר שבו האפליקציה הותקנה.