Reports API

The Reports API enables you to generate reports that give you aggregate information on your managed Chrome OS 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 versions of Chrome deployed to devices in your domain /reports:countChromeVersions GET Optional: orgUnitId, filter, pageSize, pageToken
Count the reported apps installed across your devices and browsers /reports:countInstalledApps GET Optional: orgUnitId, filter, pageSize, pageToken, order_by
List the devices on which a particular app is installed /reports:findInstalledAppDevices GET Optional: orgUnitId, pageSize, pageToken, order_by

See code samples 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
countChromeVersions "Services -> Chrome Management -> View Chrome Versions Report"
or "Services -> Chrome OS -> Settings -> View Chrome Versions Report"
countInstalledApps "Services -> Chrome Management -> View Extensions List Report"
or "Services -> Chrome OS -> Settings -> View Extensions List Report"
findInstalledAppDevices "Services -> Chrome Management -> View Extensions List Report"
or "Services -> Chrome OS -> Settings -> View Extensions List Report"

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

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.