您可以使用 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 | 選用:printerOrgUnitId、filter、pageSize、pageToken、orderBy |
| 取得網域中每位使用者的列印摘要 | /reports:countPrintJobsByUser | GET | 選用:printerOrgUnitId、filter、pageSize、pageToken、orderBy |
| 取得網域中列印工作的詳細報告 | /reports:enumeratePrintJobs | GET | 選用:printerOrgUnitId、filter、pageSize、pageToken、orderBy |
| 列出安裝特定應用程式的裝置 | /reports:findInstalledAppDevices | GET | 選用:orgUnitId、filter、pageSize、pageToken、orderBy |
| 列出安裝特定應用程式的設定檔 | /reports:findInstalledAppProfiles | 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」->「設定」->「查看擴充功能清單報告」 |
| findInstalledAppProfiles | 「服務」->「Chrome 管理服務」->「查看擴充功能清單報告」
或「服務」->「ChromeOS」->「設定」->「查看擴充功能清單報告」 |
| countChromeCrashEvents | 「服務」->「Chrome 管理」->「查看 Chrome 異常終止報告」
或「服務」->「ChromeOS」->「設定」->「查看 Chrome 異常終止報告」 |
如要管理管理員角色和權限,請前往「管理控制台 -> 管理員角色」。
API 範圍
Reports API 需要下列 OAuth 範圍:
https://www.googleapis.com/auth/chrome.management.reports.readonly
詳情請參閱驗證總覽一文。