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