Method: customers.chromeBrowsers.list

检索客户的所有 Chrome 浏览器（分页）。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。格式：customers/{customerId}

查询参数

参数
pageSize

integer

可选。页面中结果的数量上限。最大值和默认值均为 100。
pageToken

string

可选。用于指定列表中下一页的令牌。
filter

string

可选。用于过滤浏览器的过滤条件。过滤条件中可以使用以下字段：

  • browser_permanent_id
  • virtual_device_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）匹配浏览器（而像 "machine 73" 这样带引号的单个短语则匹配单个字段中的连续短语）。
orderBy

string

可选。用于指定结果排序方式的字段。支持的字段包括：

  • browser_permanent_id
  • virtual_device_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