Besuchen Sie die Chrome Management Reports API für eine Übersicht über API-Funktionen.
In allen unten aufgeführten Anfragen werden die folgenden Variablen verwendet:
$TOKEN– OAuth 2-Token$CUSTOMER– ID des Kunden oder Literal-my_customer$ORG_UNIT_ID: ID einer bestimmten Organisationseinheit, für die Sie eine Anfrage generieren möchten.
Anzahl der aktiven Chrome-Versionen im Zeitraum
Um zu sehen, welche Chrome-Versionen in einem bestimmten Zeitraum aktiv waren,
Verwenden Sie den Wert last_active_date im Parameter filter. Sie können festlegen,
Paginierung der Ergebnisse mit den Parametern pageSize und pageToken.
Anfrage
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"
Antwort
{
"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
}
Verteilung der App-Installationen mit verschiedenen Berechtigungen zählen
Um die Anzahl der Geräte anzuzeigen, auf denen eine bestimmte App mit einem bestimmten
Anzahl der Berechtigungen verwenden Sie den Wert number_of_permissions in der
filter-Parameter. Sie können die Paginierung der Ergebnisse mithilfe der
pageSize- und pageToken-Parameter.
Weitere Filterparameter finden Sie in der reference beschrieben.
Anfrage
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countInstalledApps?filter=number_of_permissions>6"
Antwort
{
"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"
]
},
]
}
Geräte zählen, auf denen eine App installiert ist
Das vorherige Beispiel zeigt eine App, die auf zwei Geräten installiert wurde.
Um zu sehen, auf welchen Geräten diese App installiert ist, verwende die
findInstalledAppDevices.
Sie können die Paginierung der Ergebnisse mit pageSize und pageToken steuern.
Parameter.
Anfrage
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findInstalledAppDevices?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"
Antwort
{
"totalSize": 2,
"devices": [
{
"machine": "MACHINEA-A",
"deviceId": "b472473e-fe50-4c6e-9ac3-03fe0d0753ce"
},
{
"machine": "MACHINE-B",
"deviceId": "a5f49e54-b07b-409f-bc5c-aaf27c483249"
}
]
}
Follow-up-Anfrage
Mit der im vorherigen Beispiel zurückgegebenen Geräte-ID zu dem Gerät, auf dem die App installiert ist, mithilfe der Admin SDK Directory API für Chrome-Browser.