Chrome 管理注册令牌 API 允许管理员管理用于在 Chrome 企业核心版中注册 Chrome 浏览器的注册令牌。 这组 API 可用于为其设备创建、检索、列出和撤消注册令牌。
API 方法快速概览
网址相对于 https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| 说明 | 相对网址 | HTTP 方法 |
|---|---|---|
| 创建注册令牌 | /enrollmentTokens | POST |
| 检索注册令牌 | /enrollmentTokens/{token_permanent_id} | GET |
| 列出注册令牌 | /enrollmentTokens | GET |
| 撤消注册令牌 | /enrollmentTokens/{token_permanent_id}:revoke | POST |
如需查看请求和响应示例，请参阅代码示例。
正在过滤结果
使用 /enrollmentTokens 方法列出注册令牌时，您可以使用 filter 查询参数缩小结果范围。通过 HTTP 请求发送所有过滤条件参数时，必须对这些参数进行网址转义。您可以使用 AND 运算符组合多个条件。
- 字符串和枚举字段：支持
=和:比较运算符。 - 组织部门过滤：您可以通过指定
org_unit_path或org_unit_id来过滤为特定组织部门创建的令牌。
可过滤的字段
| 字段 | 说明 |
|---|---|
device_type
|
注册令牌所适用的设备类型（目前为 CHROME_BROWSER）。 |
token_state
|
注册令牌的状态（ACTIVE、EXPIRED、REVOKED）。 |
org_unit_path
|
注册令牌的组织部门路径（例如 /Marketing）。 |
org_unit_id
|
注册令牌的组织部门模糊处理 ID。 |
管理员权限
Chrome Management Enrollment Tokens API 遵循管理员角色委托。
| 方法 | 需要管理员权限 |
|---|---|
| CreateEnrollmentToken | “服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器” |
| GetEnrollmentToken | “服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器” 或“服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器 -> 读取” |
| ListEnrollmentTokens | “服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器” 或“服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器 -> 读取” |
| RevokeEnrollmentToken | “服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器” |
如需管理管理员角色和权限，请访问“管理控制台 -> 管理员角色”。
API 范围
Chrome 管理注册令牌 API 需要以下 OAuth 范围：
| 方法 | 所需的 OAuth 范围 |
|---|---|
| CreateEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
| GetEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens 或 https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| ListEnrollmentTokens | https://www.googleapis.com/auth/chrome.management.enrollmenttokens 或 https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| RevokeEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
如需了解详情，请参阅身份验证概览。