The Reports API enables you to generate reports that give you aggregate
information on your managed ChromeOS device / Chrome Browser deployment.

## Quick overview of API methods

URLs are relative to `https://chromemanagement.googleapis.com/v1/customers/*$CUSTOMER*`

| Description | Relative URL | Http method | Allowed request parameters |
|---|---|---|---|
| Count Chrome browsers needing attention in your domain | [/reports:countChromeBrowsersNeedingAttention](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/countChromeBrowsersNeedingAttention) | GET | *Optional*: orgUnitId |
| Count Chrome devices reaching auto expiration date in your domain | [/reports:countChromeDevicesReachingAutoExpirationDate](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/countChromeDevicesReachingAutoExpirationDate) | GET | *Optional*: orgUnitId, minAueDate, maxAueDate |
| Count Chrome devices needing attention in your domain | [/reports:countChromeDevicesThatNeedAttention](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/countChromeDevicesThatNeedAttention) | GET | *Optional*: orgUnitId, readMask |
| Count Chrome hardware fleet devices in your domain | [/reports:countChromeHardwareFleetDevices](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/countChromeHardwareFleetDevices) | GET | *Optional*: orgUnitId, readMask |
| Count versions of Chrome deployed to profiles in your domain | [/reports:countChromeProfileVersions](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/countChromeProfileVersions) | GET | *Optional*: orgUnitId, filter, pageSize, pageToken |
| Count versions of Chrome deployed to devices in your domain | [/reports:countChromeVersions](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/countChromeVersions) | GET | *Optional*: orgUnitId, filter, pageSize, pageToken |
| Count the reported apps installed across your devices and browsers | [/reports:countInstalledApps](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/countInstalledApps) | GET | *Optional*: orgUnitId, filter, pageSize, pageToken, orderBy |
| Get a summary of printing done by each printer in your domain | [/reports:countPrintJobsByPrinter](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/countPrintJobsByPrinter) | GET | *Optional*: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Get a summary of printing done by each user in your domain | [/reports:countPrintJobsByUser](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/countPrintJobsByUser) | GET | *Optional*: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Get a detailed report of print jobs in your domain | [/reports:enumeratePrintJobs](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/enumeratePrintJobs) | GET | *Optional*: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| List the devices on which a particular app is installed | [/reports:findInstalledAppDevices](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/findInstalledAppDevices) | GET | *Optional*: orgUnitId, filter, pageSize, pageToken, orderBy |
| List the profiles on which a particular app is installed | [/reports:findInstalledAppProfiles](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/findInstalledAppProfiles) | GET | *Optional*: orgUnitId, filter, pageSize, pageToken, orderBy |
| Get a count of Chrome crash events | [/reports:countChromeCrashEvents](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/countChromeCrashEvents) | GET | *Optional*: orgUnitId, filter, orderBy |
| Find SaaS usage reports in your domain | [/reports:findSaasUsage](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/findSaasUsage) | GET | *Optional*: filter, pageSize, pageToken, orderBy |
| Find SaaS usage reports in your domain grouped by browsers | [/reports:findSaasUsageBrowsers](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/findSaasUsageBrowsers) | GET | *Required* : app; *Optional*: filter, pageSize, pageToken, orderBy |
| Find SaaS usage reports in your domain grouped by profiles | [/reports:findSaasUsageProfiles](https://developers.google.com/chrome/management/reference/rest/v1/customers.reports/findSaasUsageProfiles) | GET | *Required* : app; *Optional*: filter, pageSize, pageToken, orderBy |

See [code samples](https://developers.google.com/chrome/management/guides/samples_reportsapi) for example requests and responses.

## Admin Privileges

Reports API respects admin role delegation.
Depending on which reports the admin wants to generate, different admin privileges are required.

| Method | Admin privileges required |
|---|---|
| countChromeBrowsersNeedingAttention | "Services -\> Chrome Management -\> View Chrome Insights Report" or "Services -\> ChromeOS -\> Settings -\> View Chrome Insights Report" |
| countChromeDevicesReachingAutoExpirationDate | "Services -\> Chrome Management -\> View Chrome Insights Report" or "Services -\> ChromeOS -\> Settings -\> View Chrome Insights Report" |
| countChromeDevicesThatNeedAttention | "Services -\> Chrome Management -\> View Chrome Insights Report" or "Services -\> ChromeOS -\> Settings -\> View Chrome Insights Report" |
| countChromeHardwareFleetDevices | "Services -\> Chrome Management -\> View Chrome Insights Report" or "Services -\> ChromeOS -\> Settings -\> View Chrome Insights Report" |
| countChromeProfileVersions | "Services -\> Chrome Management -\> View Chrome Versions Report" or "Services -\> ChromeOS -\> Settings -\> View Chrome Versions Report" |
| countChromeVersions | "Services -\> Chrome Management -\> View Chrome Versions Report" or "Services -\> ChromeOS -\> Settings -\> View Chrome Versions Report" |
| countInstalledApps | "Services -\> Chrome Management -\> View Extensions List Report" or "Services -\> ChromeOS -\> Settings -\> View Extensions List Report" |
| countPrintJobsByPrinter | "Services -\> Chrome Management -\> View Chrome Printers Report" or "Services -\> ChromeOS -\> Settings -\> View Chrome Printers Report" |
| countPrintJobsByUser | "Services -\> Chrome Management -\> View Chrome Printers Report" or "Services -\> ChromeOS -\> Settings -\> View Chrome Printers Report" |
| enumeratePrintJobs | "Services -\> Chrome Management -\> View Chrome Printers Report" or "Services -\> ChromeOS -\> Settings -\> View Chrome Printers Report" |
| findInstalledAppDevices | "Services -\> Chrome Management -\> View Extensions List Report" or "Services -\> ChromeOS -\> Settings -\> View Extensions List Report" |
| findInstalledAppProfiles | "Services -\> Chrome Management -\> View Extensions List Report" or "Services -\> ChromeOS -\> Settings -\> View Extensions List Report" |
| countChromeCrashEvents | "Services -\> Chrome Management -\> View Chrome Crash Report" or "Services -\> ChromeOS -\> Settings -\> View Chrome Crash Report" |
| findSaasUsage | "Services -\> Chrome Management -\> View SaaS Usage Report" or "Services -\> ChromeOS -\> Settings -\> View SaaS Usage Report" |
| findSaasUsageBrowsers | "Services -\> Chrome Management -\> View SaaS Usage Report" or "Services -\> ChromeOS -\> Settings -\> View SaaS Usage Report" |
| findSaasUsageProfiles | "Services -\> Chrome Management -\> View SaaS Usage Report" or "Services -\> ChromeOS -\> Settings -\> View SaaS Usage Report" |

To manage admin roles and privileges visit "Admin Console -\> Admin Roles".

> [!NOTE]
> **Note:** admin roles can be assigned directly to a Service Account.

## API scopes

Reports API requires the following OAuth scope:

    https://www.googleapis.com/auth/chrome.management.reports.readonly

For more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/).