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:countChromeProfileVersions | GET | 省略可 __: orgUnitId, filter, pageSize, pageToken |
| ドメイン内のデバイスにデプロイされている 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 |
| ドメイン内の SaaS の使用状況レポートを検索する | /reports:findSaasUsage | GET | 省略可 __: filter, pageSize, pageToken, orderBy |
| ブラウザ別にグループ化されたドメイン内の SaaS の使用状況レポートを検索する | /reports:findSaasUsageBrowsers | GET | 必須 __: app; 省略可 __: filter, pageSize, pageToken, orderBy |
| プロファイル別にグループ化されたドメイン内の SaaS の使用状況レポートを検索する | /reports:findSaasUsageProfiles | GET | 必須 __: app; 省略可 __: filter, pageSize, pageToken, orderBy |
リクエストとレスポンスの例については、コードサンプルをご覧ください。
管理者権限
Reports API では、管理者ロールの委任が適用されます。 管理者が生成するレポートに応じて、必要な管理者権限が異なります。
| メソッド | 必要な管理者権限 |
|---|---|
| countChromeBrowsersNeedingAttention | "[サービス] -> [Chrome 管理] -> [Chrome インサイト レポートを表示]"
または "[サービス] -> [ChromeOS] -> [設定] -> [Chrome インサイト レポートを表示]" |
| countChromeDevicesReachingAutoExpirationDate | "[サービス] -> [Chrome 管理] -> [Chrome インサイト レポートを表示]"
または "[サービス] -> [ChromeOS] -> [設定] -> [Chrome インサイト レポートを表示]" |
| countChromeDevicesThatNeedAttention | "[サービス] -> [Chrome 管理] -> [Chrome インサイト レポートを表示]"
または "[サービス] -> [ChromeOS] -> [設定] -> [Chrome インサイト レポートを表示]" |
| countChromeHardwareFleetDevices | "[サービス] -> [Chrome 管理] -> [Chrome インサイト レポートを表示]"
または "[サービス] -> [ChromeOS] -> [設定] -> [Chrome インサイト レポートを表示]" |
| countChromeProfileVersions | "[サービス] -> [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 のクラッシュ レポートを表示]" |
| findSaasUsage | "[サービス] -> [Chrome 管理] -> [SaaS の使用状況レポートを表示]"
または "[サービス] -> [ChromeOS] -> [設定] -> [SaaS の使用状況レポートを表示]" |
| findSaasUsageBrowsers | "[サービス] -> [Chrome 管理] -> [SaaS の使用状況レポートを表示]"
または "[サービス] -> [ChromeOS] -> [設定] -> [SaaS の使用状況レポートを表示]" |
| findSaasUsageProfiles | "[サービス] -> [Chrome 管理] -> [SaaS の使用状況レポートを表示]"
または "[サービス] -> [ChromeOS] -> [設定] -> [SaaS の使用状況レポートを表示]" |
管理者のロールと権限を管理するには、管理コンソール -> [管理者ロール] にアクセスします。
API スコープ
Reports API には、次の OAuth スコープが必要です。
https://www.googleapis.com/auth/chrome.management.reports.readonly
詳細については、認証の概要をご覧ください。