Interfejs Reports API umożliwia generowanie raportów zawierających zbiorcze informacje o wdrożeniu zarządzanych urządzeń z ChromeOS i przeglądarek Chrome.
Szybki przegląd metod interfejsu API
Adresy URL są względne względem https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Opis | Względny URL | Metoda HTTP | Dozwolone parametry żądania |
|---|---|---|---|
| Liczba przeglądarek Chrome wymagających uwagi w Twojej domenie | /reports:countChromeBrowsersNeedingAttention | SPRAWDŹ | Opcjonalnie: orgUnitId |
| Liczba urządzeń z Chrome, które w Twojej domenie zbliżają się do daty automatycznego wygaśnięcia | /reports:countChromeDevicesReachingAutoExpirationDate | SPRAWDŹ | Opcjonalnie: orgUnitId, minAueDate, maxAueDate |
| Liczba urządzeń z Chrome wymagających uwagi w Twojej domenie | /reports:countChromeDevicesThatNeedAttention | SPRAWDŹ | Opcjonalnie: orgUnitId, readMask |
| Liczba urządzeń z Chrome w Twojej domenie | /reports:countChromeHardwareFleetDevices | SPRAWDŹ | Opcjonalnie: orgUnitId, readMask |
| Liczba wersji Chrome wdrożonych w profilach w Twojej domenie | /reports:countChromeProfileVersions | SPRAWDŹ | Opcjonalnie: orgUnitId, filter, pageSize, pageToken |
| Liczba wersji Chrome wdrożonych na urządzeniach w Twojej domenie | /reports:countChromeVersions | SPRAWDŹ | Opcjonalnie: orgUnitId, filter, pageSize, pageToken |
| Liczba zgłoszonych aplikacji zainstalowanych na urządzeniach i w przeglądarkach | /reports:countInstalledApps | SPRAWDŹ | Opcjonalnie: orgUnitId, filter, pageSize, pageToken, orderBy |
| Podsumowanie drukowania na każdej drukarce w Twojej domenie | /reports:countPrintJobsByPrinter | SPRAWDŹ | Opcjonalnie: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Podsumowanie drukowania przez każdego użytkownika w Twojej domenie | /reports:countPrintJobsByUser | SPRAWDŹ | Opcjonalnie: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Szczegółowy raport o zadaniach drukowania w Twojej domenie | /reports:enumeratePrintJobs | SPRAWDŹ | Opcjonalnie: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Lista urządzeń, na których jest zainstalowana określona aplikacja | /reports:findInstalledAppDevices | SPRAWDŹ | Opcjonalnie: orgUnitId, filter, pageSize, pageToken, orderBy |
| Lista profili, na których jest zainstalowana określona aplikacja | /reports:findInstalledAppProfiles | SPRAWDŹ | Opcjonalnie: orgUnitId, filter, pageSize, pageToken, orderBy |
| Liczba zdarzeń awarii Chrome | /reports:countChromeCrashEvents | SPRAWDŹ | Opcjonalnie: orgUnitId, filter, orderBy |
| Znajdowanie raportów o wykorzystaniu SaaS w Twojej domenie | /reports:findSaasUsage | SPRAWDŹ | Opcjonalnie: filter, pageSize, pageToken, orderBy |
| Znajdowanie raportów o wykorzystaniu SaaS w Twojej domenie pogrupowanych według przeglądarek | /reports:findSaasUsageBrowsers | SPRAWDŹ | Wymagane: app; Opcjonalnie: filter, pageSize, pageToken, orderBy |
| Znajdowanie raportów o wykorzystaniu SaaS w Twojej domenie pogrupowanych według profili | /reports:findSaasUsageProfiles | SPRAWDŹ | Wymagane: app; Opcjonalnie: filter, pageSize, pageToken, orderBy |
Przykładowe żądania i odpowiedzi znajdziesz w przykładowych fragmentach kodu.
Uprawnienia administratora
Interfejs Reports API uwzględnia delegowanie ról administratora. W zależności od tego, jakie raporty chce wygenerować administrator, wymagane są różne uprawnienia administratora.
| Metoda | Wymagane uprawnienia administratora |
|---|---|
| countChromeBrowsersNeedingAttention | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport statystyk Chrome”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport statystyk Chrome” |
| countChromeDevicesReachingAutoExpirationDate | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport statystyk Chrome”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport statystyk Chrome” |
| countChromeDevicesThatNeedAttention | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport statystyk Chrome”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport statystyk Chrome” |
| countChromeHardwareFleetDevices | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport statystyk Chrome”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport statystyk Chrome” |
| countChromeProfileVersions | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport wersji Chrome”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport wersji Chrome” |
| countChromeVersions | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport wersji Chrome”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport wersji Chrome” |
| countInstalledApps | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport listy rozszerzeń”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport listy rozszerzeń” |
| countPrintJobsByPrinter | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport drukarek Chrome”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport drukarek Chrome” |
| countPrintJobsByUser | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport drukarek Chrome”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport drukarek Chrome” |
| enumeratePrintJobs | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport drukarek Chrome”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport drukarek Chrome” |
| findInstalledAppDevices | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport listy rozszerzeń”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport listy rozszerzeń” |
| findInstalledAppProfiles | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport listy rozszerzeń”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport listy rozszerzeń” |
| countChromeCrashEvents | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport awarii Chrome”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport awarii Chrome” |
| findSaasUsage | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport wykorzystania SaaS”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport wykorzystania SaaS” |
| findSaasUsageBrowsers | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport wykorzystania SaaS”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport wykorzystania SaaS” |
| findSaasUsageProfiles | „Usługi -> Zarządzanie urządzeniami z Chrome -> Wyświetl raport wykorzystania SaaS”
lub „Usługi -> ChromeOS -> Ustawienia -> Wyświetl raport wykorzystania SaaS” |
Aby zarządzać rolami i uprawnieniami administratora, otwórz „Konsola administracyjna -> Role administratora”.
Zakresy interfejsu API
Interfejs Reports API wymaga tego zakresu OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
Więcej informacji znajdziesz w artykule Omówienie uwierzytelniania.