Chrome Management Chrome Browsers API を使用すると、管理者は Chrome Enterprise Core に登録されている Chrome ブラウザのデータを表示し、管理できます。この一連の API を使用すると、登録済みの Chrome ブラウザの一覧表示、Chrome ブラウザの取得、Chrome ブラウザのアノテーション情報の更新、組織部門（OU）間での Chrome ブラウザの移動、Chrome ブラウザから収集されたデータの削除を行うことができます。
API メソッドの概要
URL は https://chromemanagement.googleapis.com/v1/customers/{customer_id} を基準とした相対パスです。
| 説明 | 相対 URL | HTTP メソッド |
|---|---|---|
| 登録済みの Chrome ブラウザを一覧表示する | /chromeBrowsers | GET |
| Chrome ブラウザを取得する | /chromeBrowsers/{browser_permanent_id} | GET |
| Chrome ブラウザのアノテーション情報を更新する | /chromeBrowsers/{browser_permanent_id} | PATCH |
| Chrome ブラウザを新しい組織部門（OU）に移動する | /chromeBrowsers:move | POST |
| Chrome ブラウザから収集されたデータを削除する | /chromeBrowsers/{browser_permanent_id} | 削除 |
リクエストとレスポンスの例については、コードサンプルをご覧ください。
結果をフィルタリングする
/chromeBrowsers メソッドを使用して Chrome ブラウザを一覧表示する場合は、filter クエリ パラメータを使用して結果を絞り込むことができます。すべてのフィルタ パラメータは、HTTP リクエストで送信されるときに URL エスケープする必要があります。複数の条件を AND 演算子を使用して組み合わせることができます。
- 文字列、整数、列挙型フィールド:
=比較演算子と:比較演算子をサポートします。ワイルドカード*（接頭辞prefix*、接尾辞*suffix、部分文字列*substring*、または存在*）は、machine_name、annotated_asset_id、browser_versionの=と:でのみサポートされています（例:machine_name=LIX*、browser_version:"*6367*"）。装飾のないグローバル文字列リテラル フィルタリング（フィールド名なし）もサポートされています。ABCなどの単一の用語は、インデックスに登録された文字列フィールドにABCが含まれている場合に一致します。ANDまたは空白文字で結合された複数の用語（例:machine AND 73、machine 73）は、インデックスに登録されたテキスト フィールドのいずれかに指定されたすべての用語を含むブラウザに一致します（"machine 73"などの単一引用符で囲まれた複数単語の文字列は、単一フィールド内の正確な連続フレーズに一致します）。 - タイムスタンプ フィールド:
=、<=、>=の比較演算子をサポートします。タイムスタンプには、二重引用符で囲まれた RFC-3339 形式の文字列（"2020-01-01T12:00:00Z"や"2012-04-21T11:30:00-04:00"など）が必要です。 閉じたタイムスタンプ範囲は、比較を使用して指定できます。 - 組織部門によるフィルタリング:
org_unit_path（例:org_unit_path=/Marketing）を指定して、特定の組織部門に属するブラウザをフィルタできます。単一の組織部門の一致がサポートされています。 - グループ フィルタリング:
in_group関数（in_group("groups/00gjdgxs0lm8l7o")など）を使用して、特定の Cloud Identity グループに属するブラウザをフィルタできます。
フィルタリング可能なフィールド
| フィールド | 説明 |
|---|---|
browser_permanent_id
|
Chrome ブラウザ デバイスの永続的な固有識別子。 |
last_policy_fetch_time
|
Chrome ブラウザ デバイスの前回のポリシー取得日時です。 |
os_platform
|
Chrome ブラウザ デバイスの OS プラットフォーム（例: WINDOWS、MAC、LINUX）。 |
os_architecture
|
Chrome ブラウザ デバイスの OS アーキテクチャ。 |
os_version |
Chrome ブラウザ デバイスの OS バージョンです。 |
machine_name
|
Chrome ブラウザ デバイスに関連付けられているマシンの名前。 |
annotated_location
|
Chrome ブラウザ デバイスのアノテーション付きの位置情報です。 |
annotated_user
|
Chrome ブラウザ デバイスのアノテーション付きのユーザーです。 |
annotated_asset_id
|
Chrome ブラウザ デバイスのアノテーション付きのアセット ID です。 |
annotated_note
|
Chrome ブラウザ デバイスのアノテーション付きのメモです。 |
org_unit_path
|
Chrome ブラウザ デバイスの組織部門のパス（例: /Marketing）。 |
org_unit_id
|
Chrome ブラウザ デバイスの組織部門 ID。 |
last_registration_time
|
Chrome ブラウザ デバイスの登録日時です。 |
os_platform_version
|
Chrome ブラウザ デバイスの OS プラットフォームとメジャー バージョン。 |
browser_version
|
デバイスにインストール済みであるとレポートされた Chrome ブラウザのバージョン。 |
last_status_report_time
|
Chrome ブラウザ デバイスの前回のステータス レポート日時。 |
extension_count
|
Chrome ブラウザ デバイスにインストールされている拡張機能の数。 |
policy_count
|
Chrome ブラウザ デバイスに適用されているポリシーの数。 |
last_device_user |
マシンに最後にログインしたユーザー。 |
last_activity_time
|
Chrome ブラウザ デバイスで前回示されたアクティビティです（ポリシー取得またはレポート）。 |
device_id_collision
|
デバイス ID が、Chrome ブラウザが同一のマシンであるとみなす複数のマシンによって共有されているかどうか（true または false）。 |
関数を絞り込む
| 関数 | 説明 |
|---|---|
in_group(string)
|
Chrome ブラウザ デバイスのリストを、指定された Cloud Identity グループのリソース名（形式: in_group("groups/{group_id}")）に属するデバイスにフィルタします。 |
結果の並べ替え
orderBy クエリ パラメータを使用して、結果の順序を指定できます。デフォルトでは、昇順で並べ替えられます。フィールドに対して降順を指定するには、フィールド名に接尾辞 " desc" を追加します（例: last_activity_time
desc）。
指定しない場合、デフォルトの順序は browser_permanent_id の昇順です。
サポートされている並べ替えフィールド
browser_permanent_idlast_policy_fetch_timeannotated_userannotated_locationannotated_asset_idannotated_notesorg_unit_pathos_versionlast_registration_timeextension_countpolicy_countlast_device_usermachine_namebrowser_version_channelos_platform_versionlast_activity_timebrowser_version
管理者権限
Chrome Browsers API は、管理者ロールの委任を尊重します。
| メソッド | 必要な管理者権限 |
|---|---|
| ListChromeBrowsers | [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] または [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] -> [読み取り] |
| GetChromeBrowser | [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] または [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] -> [読み取り] |
| UpdateChromeBrowser | [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] |
| MoveChromeBrowsers | [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] |
| DeleteChromeBrowser | [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] |
管理者ロールと権限を管理するには、[管理コンソール] > [管理者ロール] に移動します。
API スコープ
Chrome Management Chrome Browsers API には、次の OAuth スコープが必要です。
| メソッド | 必要な OAuth スコープ |
|---|---|
| ListChromeBrowsers | https://www.googleapis.com/auth/chrome.management.browsers または https://www.googleapis.com/auth/chrome.management.browsers.readonly |
| GetChromeBrowser | https://www.googleapis.com/auth/chrome.management.browsers または https://www.googleapis.com/auth/chrome.management.browsers.readonly |
| UpdateChromeBrowser | https://www.googleapis.com/auth/chrome.management.browsers |
| MoveChromeBrowsers | https://www.googleapis.com/auth/chrome.management.browsers |
| DeleteChromeBrowser | https://www.googleapis.com/auth/chrome.management.browsers |
詳細については、認証の概要をご覧ください。