API отчетов позволяет создавать отчеты, которые предоставляют совокупную информацию об управляемом устройстве ChromeOS или развертывании браузера Chrome.
Краткий обзор методов API
URL-адреса указаны относительно https://chromemanagement.googleapis.com/v1/customers/ $CUSTOMER
| Описание | Относительный URL | HTTP-метод | Разрешенные параметры запроса |
|---|---|---|---|
| Подсчитайте браузеры Chrome, требующие внимания в вашем домене | /reports:countChromeBrowsersNeedingAttention | ПОЛУЧАТЬ | Необязательно : orgUnitId. |
| Подсчитайте устройства Chrome, срок действия которых истекает автоматически в вашем домене. | /reports:countChromeDevicesReachingAutoExpirationDate | ПОЛУЧАТЬ | Необязательно : orgUnitId, minAueDate, maxAueDate. |
| Подсчитайте устройства Chrome, требующие внимания, в вашем домене | /reports:countChromeDevicesThatNeedAttention | ПОЛУЧАТЬ | Необязательно : orgUnitId, readMask. |
| Подсчитайте парк оборудования Chrome в вашем домене | /reports:countChromeHardwareFleetDevices | ПОЛУЧАТЬ | Необязательно : orgUnitId, readMask. |
| Подсчитайте версии Chrome, развернутые на устройствах в вашем домене. | /reports:countChromeVersions | ПОЛУЧАТЬ | Необязательно : orgUnitId, фильтр, pageSize, pageToken. |
| Подсчитайте количество заявленных приложений, установленных на ваших устройствах и в браузерах. | /reports:countInstalledApps | ПОЛУЧАТЬ | Необязательно : orgUnitId, фильтр, pageSize, pageToken, orderBy. |
| Получите сводную информацию о печати, выполненной каждым принтером в вашем домене. | /reports:countPrintJobsByPrinter | ПОЛУЧАТЬ | Необязательно : printOrgUnitId, фильтр, pageSize, pageToken, orderBy. |
| Получите сводную информацию о печати, выполненной каждым пользователем в вашем домене. | /reports:countPrintJobsByUser | ПОЛУЧАТЬ | Необязательно : printOrgUnitId, фильтр, pageSize, pageToken, orderBy. |
| Получите подробный отчет о заданиях на печать в вашем домене | /reports:enumeratePrintJobs | ПОЛУЧАТЬ | Необязательно : printOrgUnitId, фильтр, pageSize, pageToken, orderBy. |
| Перечислите устройства, на которых установлено определенное приложение. | /reports:findInstalledAppDevices | ПОЛУЧАТЬ | Необязательно : orgUnitId, фильтр, pageSize, pageToken, orderBy. |
| Получить количество событий сбоя Chrome | /reports:countChromeCrashEvents | ПОЛУЧАТЬ | Необязательно : orgUnitId, фильтр, orderBy. |
См. примеры кода, например запросы и ответы.
Права администратора
API отчетов учитывает делегирование ролей администратора. В зависимости от того, какие отчеты администратор хочет создать, требуются разные права администратора.
| Метод | Требуются права администратора |
|---|---|
| countChromeБраузерыNeedingAttention | «Сервисы -> Управление Chrome -> Просмотр отчета Chrome Insights» или «Сервисы -> ChromeOS -> Настройки -> Просмотр отчета Chrome Insights». |
| countChromeDevicesReachingAutoExpirationDate | «Сервисы -> Управление Chrome -> Просмотр отчета Chrome Insights» или «Сервисы -> ChromeOS -> Настройки -> Просмотр отчета Chrome Insights». |
| countChromeDevicesThatNeedAttention | «Сервисы -> Управление Chrome -> Просмотр отчета Chrome Insights» или «Сервисы -> ChromeOS -> Настройки -> Просмотр отчета Chrome Insights». |
| countChromeАппаратное обеспечениеФлотУстройства | «Сервисы -> Управление Chrome -> Просмотр отчета Chrome Insights» или «Сервисы -> ChromeOS -> Настройки -> Просмотр отчета Chrome Insights». |
| подсчет ChromeVersions | «Сервисы -> Управление Chrome -> Просмотр отчета о версиях Chrome» или «Сервисы -> ChromeOS -> Настройки -> Просмотр отчета о версиях Chrome» |
| countInstalledApps | «Сервисы -> Управление Chrome -> Просмотр отчета о списке расширений» или «Сервисы -> ChromeOS -> Настройки -> Просмотр отчета о списке расширений» |
| countPrintJobsByPrinter | «Сервисы -> Управление Chrome -> Просмотр отчета о принтерах Chrome» или «Сервисы -> ChromeOS -> Настройки -> Просмотр отчета о принтерах Chrome» |
| countPrintJobsByUser | «Сервисы -> Управление Chrome -> Просмотр отчета о принтерах Chrome» или «Сервисы -> ChromeOS -> Настройки -> Просмотр отчета о принтерах Chrome» |
| перечислитьPrintJobs | «Сервисы -> Управление Chrome -> Просмотр отчета о принтерах Chrome» или «Сервисы -> ChromeOS -> Настройки -> Просмотр отчета о принтерах Chrome» |
| findInstalledAppDevices | «Сервисы -> Управление Chrome -> Просмотр отчета о списке расширений» или «Сервисы -> ChromeOS -> Настройки -> Просмотр отчета о списке расширений» |
| countChromeCrashEvents | «Сервисы -> Управление Chrome -> Просмотр отчета о сбое Chrome» или «Сервисы -> ChromeOS -> Настройки -> Просмотр отчета о сбое Chrome» |
Для управления ролями и привилегиями администратора посетите «Консоль администратора -> Роли администратора».
Области API
Для API отчетов требуется следующая область действия OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
Для получения дополнительной информации см. Обзор аутентификации .