Reports API を使用すると、レポートを生成して、管理対象の ChromeOS デバイスや Chrome ブラウザの環境に関する包括的な情報を確認できます。
API メソッドの概要
URL は https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER に対する相対パスです
| 説明 | 相対 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 | 省略可: 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 | [Services -> Chrome Management -> Chrome に関する分析情報レポートを表示] または [Services -> ChromeOS -> Settings -> Chrome に関する分析情報レポートを表示] |
| countChromeDevicesReachingAutoExpirationDate | [Services -> Chrome Management -> Chrome に関する分析情報レポートを表示] または [Services -> ChromeOS -> Settings -> Chrome に関する分析情報レポートを表示] |
| countChromeDevicesThatNeedAttention | [Services -> Chrome Management -> Chrome に関する分析情報レポートを表示] または [Services -> ChromeOS -> Settings -> Chrome に関する分析情報レポートを表示] |
| countChromeHardwareFleetDevices | [Services -> Chrome Management -> Chrome に関する分析情報レポートを表示] または [Services -> ChromeOS -> Settings -> 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
詳細については、認証の概要をご覧ください。