Mit der Reports API können Sie Berichte erstellen, die Ihnen zusammenfassende Informationen zur Bereitstellung von verwalteten ChromeOS-Geräten und Chrome-Browsern liefern.
Kurzübersicht der API-Methoden
URLs sind relativ zu https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Beschreibung | Relative URL | HTTP-Methode | Zulässige Anfrageparameter |
|---|---|---|---|
| Anzahl der Chrome-Browser in Ihrer Domain, die Aufmerksamkeit erfordern | /reports:countChromeBrowsersNeedingAttention | NEUIGKEITEN | Optional: orgUnitId |
| Anzahl der Chrome-Geräte in Ihrer Domain, die das automatische Ablaufdatum erreichen | /reports:countChromeDevicesReachingAutoExpirationDate | NEUIGKEITEN | Optional: orgUnitId, minAueDate, maxAueDate |
| Anzahl der Chrome-Geräte in Ihrer Domain, die Aufmerksamkeit erfordern | /reports:countChromeDevicesThatNeedAttention | NEUIGKEITEN | Optional: orgUnitId, readMask |
| Anzahl der Chrome-Hardwareflottengeräte in Ihrer Domain | /reports:countChromeHardwareFleetDevices | NEUIGKEITEN | Optional: orgUnitId, readMask |
| Anzahl der Chrome-Versionen, die in Profilen in Ihrer Domain bereitgestellt werden | /reports:countChromeProfileVersions | NEUIGKEITEN | Optional: orgUnitId, filter, pageSize, pageToken |
| Anzahl der Chrome-Versionen, die auf Geräten in Ihrer Domain bereitgestellt werden | /reports:countChromeVersions | NEUIGKEITEN | Optional: orgUnitId, filter, pageSize, pageToken |
| Anzahl der gemeldeten Apps, die auf Ihren Geräten und in Ihren Browsern installiert sind | /reports:countInstalledApps | NEUIGKEITEN | Optional: orgUnitId, filter, pageSize, pageToken, orderBy |
| Zusammenfassung der Druckaufträge für jeden Drucker in Ihrer Domain | /reports:countPrintJobsByPrinter | NEUIGKEITEN | Optional: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Zusammenfassung der Druckaufträge für jeden Nutzer in Ihrer Domain | /reports:countPrintJobsByUser | NEUIGKEITEN | Optional: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Detaillierter Bericht zu Druckaufträgen in Ihrer Domain | /reports:enumeratePrintJobs | NEUIGKEITEN | Optional: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Liste der Geräte, auf denen eine bestimmte App installiert ist | /reports:findInstalledAppDevices | NEUIGKEITEN | Optional: orgUnitId, filter, pageSize, pageToken, orderBy |
| Liste der Profile, auf denen eine bestimmte App installiert ist | /reports:findInstalledAppProfiles | NEUIGKEITEN | Optional: orgUnitId, filter, pageSize, pageToken, orderBy |
| Anzahl der Chrome-Absturzereignisse | /reports:countChromeCrashEvents | NEUIGKEITEN | Optional: orgUnitId, filter, orderBy |
Codebeispiele für Beispielanfragen und ‑antworten
Admin-Berechtigungen
Die Reports API berücksichtigt die Delegierung von Administratorrollen. Je nachdem, welche Berichte der Administrator erstellen möchte, sind unterschiedliche Administratorberechtigungen erforderlich.
| Methode | Erforderliche Administratorberechtigungen |
|---|---|
| countChromeBrowsersNeedingAttention | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zu Chrome-Statistiken ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zu Chrome-Statistiken ansehen“ |
| countChromeDevicesReachingAutoExpirationDate | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zu Chrome-Statistiken ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zu Chrome-Statistiken ansehen“ |
| countChromeDevicesThatNeedAttention | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zu Chrome-Statistiken ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zu Chrome-Statistiken ansehen“ |
| countChromeHardwareFleetDevices | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zu Chrome-Statistiken ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zu Chrome-Statistiken ansehen“ |
| countChromeProfileVersions | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zu Chrome-Versionen ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zu Chrome-Versionen ansehen“ |
| countChromeVersions | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zu Chrome-Versionen ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zu Chrome-Versionen ansehen“ |
| countInstalledApps | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zur Liste der Erweiterungen ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zur Liste der Erweiterungen ansehen“ |
| countPrintJobsByPrinter | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zu Chrome-Druckern ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zu Chrome-Druckern ansehen“ |
| countPrintJobsByUser | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zu Chrome-Druckern ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zu Chrome-Druckern ansehen“ |
| enumeratePrintJobs | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zu Chrome-Druckern ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zu Chrome-Druckern ansehen“ |
| findInstalledAppDevices | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zur Liste der Erweiterungen ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zur Liste der Erweiterungen ansehen“ |
| findInstalledAppProfiles | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zur Liste der Erweiterungen ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zur Liste der Erweiterungen ansehen“ |
| countChromeCrashEvents | „Dienste“ > „Chrome-Verwaltung“ > „Bericht zu Chrome-Abstürzen ansehen“
oder „Dienste“ > „ChromeOS“ > „Einstellungen“ > „Bericht zu Chrome-Abstürzen ansehen“ |
Administratorrollen und ‑berechtigungen verwalten Sie in der Admin-Konsole unter „Administratorrollen“.
API-Bereiche
Für die Reports API ist der folgende OAuth-Bereich erforderlich:
https://www.googleapis.com/auth/chrome.management.reports.readonly
Weitere Informationen finden Sie in der Authentifizierungsübersicht.