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

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