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