借助 Reports API，您可以生成报告，从而了解有关受管理的 ChromeOS 设备 / Chrome 浏览器部署的汇总信息。
API 方法快速概览
网址相对于 https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| 说明 | 相对网址 | HTTP 方法 | 允许的请求参数 |
|---|---|---|---|
| 统计您网域中需要注意的 Chrome 浏览器数量 | /reports:countChromeBrowsersNeedsingAttention | GET | 可选：orgUnitId |
| 网域中即将到期的 Chrome 设备的数量 | /reports:countChromeDevicesReachingAutoExpirationDate | GET | 可选：orgUnitId、minAueDate、maxAueDate |
| 统计您网域中需要注意的 Chrome 设备数量 | /reports:countChromeDevicesThatNeedsAttention | GET | 可选：orgUnitId、readMask |
| 统计您网域中的 Chrome 硬件设备 | /reports:countChromeHardwareFleetDevices | GET | 可选：orgUnitId、readMask |
| 统计您网域中设备部署的 Chrome 的版本数 | /reports:countChromeVersions 中 | GET | 可选：orgUnitId、filter、pageSize、pageToken |
| 统计设备上和浏览器中安装的被报告应用数量 | /reports:countinstalledApps | GET | 可选：orgUnitId、filter、pageSize、pageToken、orderBy |
| 获取您网域中每台打印机的打印操作的摘要 | /reports:countPrintJobsByPrinter | GET | 可选：printOrgUnitId、filter、pageSize、pageToken、orderBy |
| 获取您网域中每个用户执行打印操作的摘要 | /reports:countPrintJobsByUser | GET | 可选：printOrgUnitId、filter、pageSize、pageToken、orderBy |
| 获取您网域中的打印任务的详细报告 | /reports:enumeratePrintJobs | GET | 可选：printOrgUnitId、filter、pageSize、pageToken、orderBy |
| 列出已安装特定应用的设备 | /reports:findinstalledAppDevices | GET | 可选：orgUnitId、filter、pageSize、pageToken、orderBy |
| 获取 Chrome 崩溃事件计数 | /reports:countChromeCrashEvents | GET | 可选：orgUnitId、filter、orderBy |
如需查看示例请求和响应，请参阅代码示例。
管理员权限
Reports API 会遵循管理员角色委托。 根据管理员想要生成的报告，需要不同的管理员权限。
| 方法 | 需要管理员权限 |
|---|---|
| countChromeBrowsersNeedingAttention | “服务 -> Chrome 管理 -> 查看 Chrome 数据洞察报告”
或“服务 -> ChromeOS -> 设置 -> 查看 Chrome 数据洞察报告” |
| countChromeDevicesReachingAutoExpirationDate | “服务 -> Chrome 管理 -> 查看 Chrome 数据洞察报告”
或“服务 -> ChromeOS -> 设置 -> 查看 Chrome 数据洞察报告” |
| countChromeDevicesThatNeedAttention | “服务 -> Chrome 管理 -> 查看 Chrome 数据洞察报告”
或“服务 -> ChromeOS -> 设置 -> 查看 Chrome 数据洞察报告” |
| countChromeHardwareFleetDevices | “服务 -> Chrome 管理 -> 查看 Chrome 数据洞察报告”
或“服务 -> ChromeOS -> 设置 -> 查看 Chrome 数据洞察报告” |
| 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 -> 设置 -> 查看扩展程序列表报告” |
| countChromeCrashEvents | “服务 -> Chrome 管理 -> 查看 Chrome 崩溃报告” 或“服务 -> ChromeOS -> 设置 -> 查看 Chrome 崩溃报告” |
要管理管理员角色和权限，请访问“管理控制台 -> 管理员角色”。
API 范围
Reports API 需要以下 OAuth 范围：
https://www.googleapis.com/auth/chrome.management.reports.readonly
如需了解详情，请参阅身份验证概览。