Mit der Reports API können Sie Berichte erstellen, die zusammengefasste Informationen zur Bereitstellung Ihres verwalteten ChromeOS-Geräts bzw. Ihres Chrome-Browsers enthalten.
Kurzer Überblick über API-Methoden
URLs beziehen sich auf https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Beschreibung | Relative URL | HTTP-Methode | Zulässige Anfrageparameter |
|---|---|---|---|
| Anzahl der Chrome-Browser in Ihrer Domain zählen, die Ihre Aufmerksamkeit erfordern | /reports:countChromeBrowsersNeedingAttention | GET | Optional: orgUnitId |
| Chrome-Geräte in Ihrer Domain zählen, bei denen das automatische Ablaufdatum erreicht wird | /reports:countChromedevicesReachingAutoExpirationDate | GET | Optional: orgUnitId, minAueDate, maxAueDate |
| Anzahl der Chrome-Geräte in Ihrer Domain zählen, die überprüft werden müssen | /reports:countChromeDevicesThatNeedAttention | GET | Optional: orgUnitId, readMask |
| Anzahl der Chrome-Hardwaregeräte in Ihrer Domain zählen | /reports:countChromeHardwareFleetGeräte | GET | Optional: orgUnitId, readMask |
| Anzahl der Chrome-Versionen bestimmen, die auf Geräten in Ihrer Domain bereitgestellt wurden | /reports:countChromeVersions | GET | Optional: orgUnitId, filter, pageSize, pageToken |
| Die gemeldeten Apps zählen, die auf deinen Geräten und in deinen Browsern installiert sind | /reports:countinstalledApps | GET | Optional: orgUnitId, filter, pageSize, pageToken, orderBy |
| Zusammenfassung der von allen Druckern in Ihrer Domain durchgeführten Druckvorgänge abrufen | /reports:countPrintJobsByPrinter | GET | Optional: printOrgUnitId, filter, pageSize, pageToken, orderBy |
| Zusammenfassung der Druckvorgänge der einzelnen Nutzer in Ihrer Domain abrufen | /reports:countPrintJobsByUser | GET | Optional: printOrgUnitId, filter, pageSize, pageToken, orderBy |
| Detaillierten Bericht zu Druckaufträgen in Ihrer Domain abrufen | /reports:enumeratePrintJobs | GET | Optional: printOrgUnitId, filter, pageSize, pageToken, orderBy |
| Geräte auflisten, auf denen eine bestimmte App installiert ist | /reports:findinstalledAppdevices | GET | Optional: orgUnitId, filter, pageSize, pageToken, orderBy |
| Anzahl der Chrome-Absturzereignisse abrufen | /reports:countChromeCrashEvents | GET | Optional: orgUnitId, filter, orderBy |
Codebeispiele für Beispielanfragen und -antworten
Administratorberechtigungen
Die Reports API unterstützt die Delegierung von Administratorrollen. Je nachdem, welche Berichte der Administrator erstellen möchte, sind unterschiedliche Administratorberechtigungen erforderlich.
| Methode | Administratorberechtigungen erforderlich |
|---|---|
| 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“ |
| countChromeVersions | „Dienste -> Chrome-Verwaltung -> Bericht zu Chrome-Versionen ansehen“
oder „Dienste -> ChromeOS -> Einstellungen -> Chrome-Versionsbericht ansehen“ |
| countInstalledApps | „Dienste -> Chrome-Verwaltung -> Bericht „Liste der Erweiterungen“ ansehen“
oder „Dienste -> ChromeOS -> Einstellungen -> Bericht „Liste der Erweiterungen ansehen“ |
| countPrintJobsByPrinter | „Dienste -> Chrome-Verwaltung -> Chrome-Druckerbericht ansehen“
oder „Dienste -> ChromeOS -> Einstellungen -> Chrome-Druckerbericht ansehen“ |
| countPrintJobsByUser | „Dienste -> Chrome-Verwaltung -> Chrome-Druckerbericht ansehen“
oder „Dienste -> ChromeOS -> Einstellungen -> Chrome-Druckerbericht ansehen“ |
| enumeratePrintJobs | „Dienste -> Chrome-Verwaltung -> Chrome-Druckerbericht ansehen“
oder „Dienste -> ChromeOS -> Einstellungen -> Chrome-Druckerbericht ansehen“ |
| findInstalledAppDevices | „Dienste -> Chrome-Verwaltung -> Bericht „Liste der Erweiterungen“ ansehen“
oder „Dienste -> ChromeOS -> Einstellungen -> Bericht „Liste der Erweiterungen ansehen“ |
| countChromeCrashEvents | „Dienste -> Chrome-Verwaltung -> Chrome-Absturzbericht ansehen“
oder „Dienste -> ChromeOS -> Einstellungen -> Chrome-Absturzbericht ansehen“ |
Administratorrollen und ‐berechtigungen können Sie unter „Admin-Konsole“ > „Administratorrollen“ verwalten.
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.