Method: customers.chromeBrowsers.list

お客様のすべての Chrome ブラウザを取得します(ページ分割)。

HTTP リクエスト

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/chromeBrowsers

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。形式: customers/{customerId}

クエリ パラメータ

パラメータ
pageSize

integer

省略可。ページあたりの結果数の上限です。最大値とデフォルト値は 100 です。

pageToken

string

省略可。リストの次のページを指定するトークン。

filter

string

省略可。ブラウザのフィルタリングに使用されるフィルタ。フィルタでは次のフィールドを使用できます。

  • browser_permanent_id
  • last_policy_fetch_time
  • os_platform
  • os_architecture
  • os_version
  • machine_name
  • annotated_location
  • annotated_user
  • annotated_asset_id
  • annotated_note
  • org_unit_path
  • org_unit_id
  • last_registration_time
  • os_platform_version
  • browser_version
  • last_status_report_time
  • extension_count
  • policy_count
  • last_device_user
  • last_activity_time
  • device_id_collision

フィルタでは、次の関数を使用できます。

  • in_group(string): 指定した Cloud Identity グループのリソース名(例: in_group("groups/{groupId}"))に属するブラウザをフィルタします。

上記のフィールドまたは関数のいずれかを使用してフィルタを指定できます。複数のフィールドまたは関数によるフィルタリングは、AND 演算子でサポートされています。文字列型、整数型のフィールド、列挙型のフィールドは、= 演算子と : 演算子をサポートしています。タイムスタンプ タイプのフィールドは、=、<=、>= 演算子をサポートしています。タイムスタンプには、二重引用符で囲まれた RFC-3339 形式の文字列(例: "2012-04-21T11:30:00-04:00")が必要です。ワイルドカード * は、machine_name、annotated_asset_id、browser_version でのみサポートされています。また、フィールド名のないグローバル文字列リテラル フィルタリングもサポートされています。単一の用語(例: ABC)は、インデックスに登録された文字列フィールドに ABC が含まれている場合に一致します。AND または空白文字で結合された複数の用語(例: machine AND 73 または machine 73)は、すべての用語がインデックスに登録された文字列フィールドに少なくとも 1 つ含まれているブラウザに一致します(一方、"machine 73" のような単一引用符で囲まれたフレーズは、単一のフィールド内の連続するフレーズに一致します)。

orderBy

string

省略可。結果の並べ替えを指定するために使用されるフィールド。サポートされているフィールドは次のとおりです。

  • browser_permanent_id
  • last_policy_fetch_time
  • annotated_user
  • annotated_location
  • annotated_asset_id
  • annotated_notes
  • org_unit_path
  • os_version
  • last_registration_time
  • extension_count
  • policy_count
  • last_device_user
  • machine_name
  • browser_version_channel
  • os_platform_version
  • last_activity_time
  • browser_version

デフォルトでは昇順で並べ替えられます。フィールドを降順で指定するには、フィールド名に接尾辞 desc を追加する必要があります。デフォルトの順序は browser_permanent_id の昇順です。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

chromeBrowsers.list メソッドへのレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "chromeBrowsers": [
    {
      object (ChromeBrowser)
    }
  ],
  "nextPageToken": string
}
フィールド
chromeBrowsers[]

object (ChromeBrowser)

Chrome ブラウザ デバイス オブジェクトのリスト。

nextPageToken

string

この結果の次のページにアクセスするために使用されるトークン。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chrome.management.browsers.readonly
  • https://www.googleapis.com/auth/chrome.management.browsers