[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-16 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/)."]]
