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
詳情請參閱驗證總覽。