Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
API отчетов позволяет создавать отчеты, которые предоставляют совокупную информацию об управляемом устройстве ChromeOS или развертывании браузера Chrome.
Краткий обзор методов API
URL-адреса указаны относительно https://chromemanagement.googleapis.com/v1/customers/ $CUSTOMER
Описание
Относительный URL
HTTP-метод
Разрешенные параметры запроса
Подсчитайте браузеры Chrome, требующие внимания в вашем домене
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:
[null,null,["Последнее обновление: 2025-07-25 UTC."],[[["\u003cp\u003eThe Reports API lets you create reports to get insights on your managed ChromeOS devices and Chrome Browsers.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the API to count devices, browsers, apps, and more, as well as view print job summaries and crash events.\u003c/p\u003e\n"],["\u003cp\u003eDifferent API methods require specific admin privileges to access the data.\u003c/p\u003e\n"],["\u003cp\u003eTo use the API, you need the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.reports.readonly\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Reports API\n\nThe Reports API enables you to generate reports that give you aggregate\ninformation on your managed ChromeOS device / Chrome Browser deployment.\n\nQuick overview of API methods\n-----------------------------\n\nURLs are relative to `https://chromemanagement.googleapis.com/v1/customers/`*$CUSTOMER*\n\n| Description | Relative URL | Http method | Allowed request parameters |\n|--------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------|--------------------------------------------------------------------|\n| Count Chrome browsers needing attention in your domain | [/reports:countChromeBrowsersNeedingAttention](/chrome/management/reference/rest/v1/customers.reports/countChromeBrowsersNeedingAttention) | GET | *Optional*: orgUnitId |\n| Count Chrome devices reaching auto expiration date in your domain | [/reports:countChromeDevicesReachingAutoExpirationDate](/chrome/management/reference/rest/v1/customers.reports/countChromeDevicesReachingAutoExpirationDate) | GET | *Optional*: orgUnitId, minAueDate, maxAueDate |\n| Count Chrome devices needing attention in your domain | [/reports:countChromeDevicesThatNeedAttention](/chrome/management/reference/rest/v1/customers.reports/countChromeDevicesThatNeedAttention) | GET | *Optional*: orgUnitId, readMask |\n| Count Chrome hardware fleet devices in your domain | [/reports:countChromeHardwareFleetDevices](/chrome/management/reference/rest/v1/customers.reports/countChromeHardwareFleetDevices) | GET | *Optional*: orgUnitId, readMask |\n| Count versions of Chrome deployed to devices in your domain | [/reports:countChromeVersions](/chrome/management/reference/rest/v1/customers.reports/countChromeVersions) | GET | *Optional*: orgUnitId, filter, pageSize, pageToken |\n| Count the reported apps installed across your devices and browsers | [/reports:countInstalledApps](/chrome/management/reference/rest/v1/customers.reports/countInstalledApps) | GET | *Optional*: orgUnitId, filter, pageSize, pageToken, orderBy |\n| Get a summary of printing done by each printer in your domain | [/reports:countPrintJobsByPrinter](/chrome/management/reference/rest/v1/customers.reports/countPrintJobsByPrinter) | GET | *Optional*: printerOrgUnitId, filter, pageSize, pageToken, orderBy |\n| Get a summary of printing done by each user in your domain | [/reports:countPrintJobsByUser](/chrome/management/reference/rest/v1/customers.reports/countPrintJobsByUser) | GET | *Optional*: printerOrgUnitId, filter, pageSize, pageToken, orderBy |\n| Get a detailed report of print jobs in your domain | [/reports:enumeratePrintJobs](/chrome/management/reference/rest/v1/customers.reports/enumeratePrintJobs) | GET | *Optional*: printerOrgUnitId, filter, pageSize, pageToken, orderBy |\n| List the devices on which a particular app is installed | [/reports:findInstalledAppDevices](/chrome/management/reference/rest/v1/customers.reports/findInstalledAppDevices) | GET | *Optional*: orgUnitId, filter, pageSize, pageToken, orderBy |\n| Get a count of Chrome crash events | [/reports:countChromeCrashEvents](/chrome/management/reference/rest/v1/customers.reports/countChromeCrashEvents) | GET | *Optional*: orgUnitId, filter, orderBy |\n\nSee [code samples](/chrome/management/guides/samples_reportsapi) for example requests and responses.\n\nAdmin Privileges\n----------------\n\nReports API respects admin role delegation.\nDepending on which reports the admin wants to generate, different admin privileges are required.\n\n| Method | Admin privileges required |\n|----------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|\n| countChromeBrowsersNeedingAttention | \"Services -\\\u003e Chrome Management -\\\u003e View Chrome Insights Report\" or \"Services -\\\u003e ChromeOS -\\\u003e Settings -\\\u003e View Chrome Insights Report\" |\n| countChromeDevicesReachingAutoExpirationDate | \"Services -\\\u003e Chrome Management -\\\u003e View Chrome Insights Report\" or \"Services -\\\u003e ChromeOS -\\\u003e Settings -\\\u003e View Chrome Insights Report\" |\n| countChromeDevicesThatNeedAttention | \"Services -\\\u003e Chrome Management -\\\u003e View Chrome Insights Report\" or \"Services -\\\u003e ChromeOS -\\\u003e Settings -\\\u003e View Chrome Insights Report\" |\n| countChromeHardwareFleetDevices | \"Services -\\\u003e Chrome Management -\\\u003e View Chrome Insights Report\" or \"Services -\\\u003e ChromeOS -\\\u003e Settings -\\\u003e View Chrome Insights Report\" |\n| countChromeVersions | \"Services -\\\u003e Chrome Management -\\\u003e View Chrome Versions Report\" or \"Services -\\\u003e ChromeOS -\\\u003e Settings -\\\u003e View Chrome Versions Report\" |\n| countInstalledApps | \"Services -\\\u003e Chrome Management -\\\u003e View Extensions List Report\" or \"Services -\\\u003e ChromeOS -\\\u003e Settings -\\\u003e View Extensions List Report\" |\n| countPrintJobsByPrinter | \"Services -\\\u003e Chrome Management -\\\u003e View Chrome Printers Report\" or \"Services -\\\u003e ChromeOS -\\\u003e Settings -\\\u003e View Chrome Printers Report\" |\n| countPrintJobsByUser | \"Services -\\\u003e Chrome Management -\\\u003e View Chrome Printers Report\" or \"Services -\\\u003e ChromeOS -\\\u003e Settings -\\\u003e View Chrome Printers Report\" |\n| enumeratePrintJobs | \"Services -\\\u003e Chrome Management -\\\u003e View Chrome Printers Report\" or \"Services -\\\u003e ChromeOS -\\\u003e Settings -\\\u003e View Chrome Printers Report\" |\n| findInstalledAppDevices | \"Services -\\\u003e Chrome Management -\\\u003e View Extensions List Report\" or \"Services -\\\u003e ChromeOS -\\\u003e Settings -\\\u003e View Extensions List Report\" |\n| countChromeCrashEvents | \"Services -\\\u003e Chrome Management -\\\u003e View Chrome Crash Report\" or \"Services -\\\u003e ChromeOS -\\\u003e Settings -\\\u003e View Chrome Crash Report\" |\n\nTo manage admin roles and privileges visit \"Admin Console -\\\u003e Admin Roles\".\n| **Note:** admin roles can be assigned directly to a Service Account.\n\nAPI scopes\n----------\n\nReports API requires the following OAuth scope: \n\n https://www.googleapis.com/auth/chrome.management.reports.readonly\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/)."]]
