利用 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 | 可选: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
如需了解详情,请参阅身份验证概览。
