借助 Reports API，您可以生成报告，其中包含有关受管理的 ChromeOS 设备 / Chrome 浏览器部署的汇总信息。
API 方法快速概览
网址相对于 https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| 说明 | 相对网址 | HTTP 方法 | 允许的请求参数 |
|---|---|---|---|
| 统计网域中需要注意的 Chrome 浏览器数量 | /reports:countChromeBrowsersNeedingAttention | GET | 可选：orgUnitId |
| 统计网域中达到自动过期日期的 Chrome 设备数量 | /reports:countChromeDevicesReachingAutoExpirationDate | GET | 可选：orgUnitId、minAueDate、maxAueDate |
| 统计网域中需要注意的 Chrome 设备数量 | /reports:countChromeDevicesThatNeedAttention | 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 | 可选：printerOrgUnitId、filter、pageSize、pageToken、orderBy |
| 获取网域中每位用户的打印摘要 | /reports:countPrintJobsByUser | GET | 可选：printerOrgUnitId、filter、pageSize、pageToken、orderBy |
| 获取网域中打印作业的详细报告 | /reports:enumeratePrintJobs | GET | 可选：printerOrgUnitId、filter、pageSize、pageToken、orderBy |
| 列出安装了特定应用的设备 | /reports:findInstalledAppDevices | GET | 可选：orgUnitId、filter、pageSize、pageToken、orderBy |
| 列出安装了特定应用的个人资料 | /reports:findInstalledAppProfiles | 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 -> 设置 -> 查看扩展程序列表报告” |
| findInstalledAppProfiles | “服务 -> Chrome 管理 -> 查看扩展程序列表报告” 或“服务 -> ChromeOS -> 设置 -> 查看扩展程序列表报告” |
| countChromeCrashEvents | “服务 -> Chrome 管理 -> 查看 Chrome 崩溃报告”
或“服务 -> ChromeOS -> 设置 -> 查看 Chrome 崩溃报告” |
如需管理管理员角色和权限，请前往“管理控制台 -> 管理员角色”。
API 范围
Reports API 需要以下 OAuth 范围：
https://www.googleapis.com/auth/chrome.management.reports.readonly
如需了解详情，请参阅身份验证概览。