Security Insights API を使用すると、Chrome セキュリティ インサイト機能を有効または無効にしたり、有効化ステータスを確認したり、分析情報データ（コンテンツの転送や URL へのアクセスなど）をクエリしたりできます。
API メソッドの概要
URL は https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER に対する相対パスです
| 説明 | 相対 URL | HTTP メソッド | 許可されたリクエスト パラメータ |
|---|---|---|---|
| ドメインの分析情報を有効にし、ドメインのルート組織部門または特定の組織部門セットに対して Chrome コネクタを構成する | /enterprise/securityInsights:enable | POST | 省略可: targetOus |
| ドメインの分析情報を無効にする | /enterprise/securityInsights:disable | POST | |
| ドメインのインサイトの有効化ステータスを確認する | /enterprise/securityInsights:checkEnablementStatus | GET | |
| ドメインのコンテンツ転送の概要をクエリする | /enterprise/securityInsights:queryContentTransfers | GET | 省略可: フィルタ |
| ユーザー、ドメイン、コンテンツ カテゴリ別の内訳を含むコンテンツ転送の概要をクエリする | /enterprise/securityInsights:queryContentTransfersBreakdowns | GET | 省略可: filter、metric、breakdown、fixedTimeRange、pageSize、pageToken |
| ドメインの URL 訪問の概要をクエリする | /enterprise/securityInsights:queryUrlVisits | GET | 省略可: フィルタ |
| ユーザー/ドメイン別の内訳を含む URL 訪問の概要をクエリする | /enterprise/securityInsights:queryUrlVisitsBreakdowns | GET | 省略可: filter、metric、breakdown、fixedTimeRange、pageSize、pageToken |
リクエストとレスポンスの例については、コードサンプルをご覧ください。
サブスクリプションの要件
次の API メソッドには、有効な Chrome Enterprise Premium サブスクリプションが必要です。お客様がこのサブスクリプションを所有していない場合、リクエストはブロックされませんが、クエリ結果は空になります。
queryUrlVisitsqueryUrlVisitsBreakdowns
管理者権限
呼び出すメソッドに応じて、必要な管理者権限が異なります。
| メソッド | 必要な管理者権限 |
|---|---|
| 有効にする | 「組織部門 > 読み取り」 「サービス > Chrome 管理 > 設定 > ユーザー設定を管理」 「サービス > Chrome DLP > Chrome DLP アプリケーション分析情報の設定を管理」 |
| 無効にする | 「組織部門 > 読み取り」 「サービス > Chrome 管理 > 設定 > ユーザー設定を管理」 「サービス > Chrome DLP > Chrome DLP アプリケーション分析情報の設定を管理」 |
| checkEnablementStatus | [組織部門] > [読み取り] [サービス] > [Chrome DLP] > [Chrome DLP アプリケーション インサイトの設定の管理] または [サービス] > [Chrome DLP] > [Chrome DLP アプリケーション インサイトの設定の表示] |
| queryContentTransfers | 「[サービス] > [Chrome DLP] > [Chrome DLP アプリケーション インサイトの設定の表示]」 |
| queryContentTransfersBreakdowns | 「[サービス] > [Chrome DLP] > [Chrome DLP アプリケーション インサイトの設定の表示]」 |
| queryUrlVisits | 「[サービス] > [Chrome DLP] > [Chrome DLP アプリケーション インサイトの設定の表示]」 |
| queryUrlVisitsBreakdowns | 「[サービス] > [Chrome DLP] > [Chrome DLP アプリケーション インサイトの設定の表示]」 |
管理者ロールと権限を管理するには、[管理コンソール] -> [管理者ロール] にアクセスします。
API スコープ
API の有効化と無効化には、次の OAuth スコープが必要です。
https://www.googleapis.com/auth/chrome.management.securityinsights
checkEnablementStatus とすべてのクエリ メソッドでは、次のいずれかのスコープを使用できます。
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
詳細については、認証の概要をご覧ください。