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 選用: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

詳情請參閱驗證總覽一文。