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, filter, pageSize, pageToken |
| Подсчитайте количество установленных приложений на ваших устройствах и в браузерах. | /reports:countInstalledApps | ПОЛУЧАТЬ | Необязательные параметры : orgUnitId, filter, pageSize, pageToken, orderBy |
| Получите сводку о печати, выполненной каждым принтером в вашем домене. | /reports:countPrintJobsByPrinter | ПОЛУЧАТЬ | Необязательные параметры : printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Получите сводку по печати, выполненной каждым пользователем в вашем домене. | /reports:countPrintJobsByUser | ПОЛУЧАТЬ | Необязательные параметры : printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Получите подробный отчет о заданиях печати в вашем домене. | /reports:enumeratePrintJobs | ПОЛУЧАТЬ | Необязательные параметры : printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Перечислите устройства, на которых установлено данное приложение. | /reports:findInstalledAppDevices | ПОЛУЧАТЬ | Необязательные параметры : orgUnitId, filter, pageSize, pageToken, orderBy |
| Перечислите профили, в которых установлено конкретное приложение. | /reports:findInstalledAppProfiles | ПОЛУЧАТЬ | Необязательные параметры : orgUnitId, filter, pageSize, pageToken, orderBy |
| Получите количество событий сбоев Chrome. | /reports:countChromeCrashEvents | ПОЛУЧАТЬ | Необязательные параметры : orgUnitId, filter, orderBy |
Примеры запросов и ответов можно посмотреть в примерах кода .
Административные права
API отчетов учитывает делегирование ролей администратора. В зависимости от того, какие отчеты администратор хочет сгенерировать, требуются разные права администратора.
| Метод | Требуются права администратора. |
|---|---|
| countChromeBrowsersNeedingAttention | «Службы -> Управление Chrome -> Просмотреть отчет Chrome Insights» или "Сервисы -> ChromeOS -> Настройки -> Просмотреть отчет Chrome Insights" |
| countChromeDevicesReachingAutoExpirationDate | «Службы -> Управление Chrome -> Просмотреть отчет Chrome Insights» или "Сервисы -> ChromeOS -> Настройки -> Просмотреть отчет Chrome Insights" |
| countChromeDevicesThatNeedAttention | «Службы -> Управление Chrome -> Просмотреть отчет Chrome Insights» или "Сервисы -> ChromeOS -> Настройки -> Просмотреть отчет Chrome Insights" |
| countChromeHardwareFleetDevices | «Службы -> Управление Chrome -> Просмотреть отчет Chrome Insights» или "Сервисы -> ChromeOS -> Настройки -> Просмотреть отчет Chrome Insights" |
| countChromeVersions | «Службы -> Управление Chrome -> Просмотр отчета о версиях Chrome» или "Сервисы -> ChromeOS -> Настройки -> Просмотр отчета о версиях Chrome" |
| countInstalledApps | «Службы -> Управление Chrome -> Просмотр отчета со списком расширений» или "Сервисы -> ChromeOS -> Настройки -> Просмотреть отчет со списком расширений" |
| countPrintJobsByPrinter | «Службы -> Управление Chrome -> Просмотр отчета по принтерам Chrome» или "Службы -> ChromeOS -> Настройки -> Просмотр отчета о принтерах Chrome" |
| countPrintJobsByUser | «Службы -> Управление Chrome -> Просмотр отчета по принтерам Chrome» или "Службы -> ChromeOS -> Настройки -> Просмотр отчета о принтерах Chrome" |
| enumeratePrintJobs | «Службы -> Управление Chrome -> Просмотр отчета по принтерам Chrome» или "Службы -> ChromeOS -> Настройки -> Просмотр отчета о принтерах Chrome" |
| findInstalledAppDevices | «Службы -> Управление Chrome -> Просмотр отчета со списком расширений» или "Сервисы -> ChromeOS -> Настройки -> Просмотреть отчет со списком расширений" |
| findInstalledAppProfiles | «Службы -> Управление Chrome -> Просмотр отчета со списком расширений» или "Сервисы -> ChromeOS -> Настройки -> Просмотреть отчет со списком расширений" |
| countChromeCrashEvents | «Службы -> Управление Chrome -> Просмотреть отчет о сбое Chrome» или "Службы -> ChromeOS -> Настройки -> Просмотреть отчет о сбое Chrome" |
Для управления ролями и правами администратора перейдите в раздел «Консоль администратора -> Роли администратора».
Области действия API
Для работы API отчетов требуется следующая область действия OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
Для получения более подробной информации см. раздел «Обзор аутентификации» .