Chrome Management Chrome Browsers API

借助 Chrome Management Chrome Browsers API，管理员可以查看数据并管理已注册 Chrome 企业核心版的 Chrome 浏览器。这组 API 可用于列出已注册的 Chrome 浏览器、检索 Chrome 浏览器、更新 Chrome 浏览器的注释信息、在组织部门 (OU) 之间移动 Chrome 浏览器，以及删除从 Chrome 浏览器收集的数据。

API 方法简要概览

网址相对于 https://chromemanagement.googleapis.com/v1/customers/{customer_id}

说明 相对网址 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 请求中发送的所有过滤条件参数都必须经过网址转义。可以使用 AND 运算符组合多个条件。

  • 字符串、整数和枚举字段：支持 = 和 : 比较运算符。仅 machine_name、annotated_asset_id 和 browser_version 支持将通配符 *（前缀 prefix*、后缀 *suffix、子字符串 *substring* 或存在 *）与 = 和 : 搭配使用（例如 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 浏览器设备的操作系统平台（例如 WINDOWS、MAC、LINUX）。
os_architecture Chrome 浏览器设备的操作系统架构。
os_version Chrome 浏览器设备的操作系统版本。
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 浏览器设备的操作系统平台和主要版本。
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_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

管理员权限

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

如需了解详情，请参阅身份验证概览。