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 Insights 報告」
或「服務 ->」ChromeOS ->設定 ->查看 Chrome Insights 報告」 |
| countChromeDevicesReachingAutoExpirationDate | 「服務 ->Chrome 管理服務 ->查看 Chrome Insights 報告」
或「服務 ->」ChromeOS ->設定 ->查看 Chrome Insights 報告」 |
| countChromeDevicesThatNeedAttention | 「服務 ->Chrome 管理服務 ->查看 Chrome Insights 報告」
或「服務 ->」ChromeOS ->設定 ->查看 Chrome Insights 報告」 |
| countChromeHardwareFleetDevices | 「服務 ->Chrome 管理服務 ->查看 Chrome Insights 報告」
或「服務 ->」ChromeOS ->設定 ->查看 Chrome Insights 報告」 |
| 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
詳情請參閱驗證總覽一文。