Reports API

利用 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

如需了解详情,请参阅身份验证概览