Reports API を使用すると、管理対象の ChromeOS デバイスや Chrome ブラウザのデプロイに関する集計情報を示すレポートを生成できます。
API メソッドの概要
https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER を基準とする相対 URL
| 説明 | 相対 URL | 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
詳細については、認証の概要をご覧ください。