Chrome Policy API 概览

Chrome Policy API 是一套服务,可让 Chrome 管理员以编程方式查看和管理分配给其组织中的组织部门的 Chrome 政策。借助此 API,Chrome 管理员可以深入了解其组织中 ChromeOS 设备和 Chrome 浏览器的使用情况。

主要优势

  • Google 管理控制台兼容性:您通过 API 所做的更改会反映在 Google 管理控制台界面中,反之亦然。

  • 审核日志记录:使用此 API 所做的更改会记录在标准的管理员审核日志中。

  • 数据驱动的方法:Chrome 政策以数据形式表示,API 接口不会直接引用 Chrome 政策。这样,您就可以自动执行 API 客户端,以便使用未来的 Chrome 政策,而无需进行额外的开发。随着时间的推移,通过 API 支持的政策数量将会增加。

  • 与 Admin SDK API 相辅相成:此 API 是 Admin SDK API 的有益补充,Chrome 管理员可以通过该 API 执行以下任务:

下表列出了您可以使用此 API 完成的主要任务。如需查看示例请求和响应,请参阅代码示例

网址是相对于 https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER 的。

任务说明 相对网址 HTTP 方法 请求参数
列出政策架构 ./policySchemas GET 可选filterpageSizepageToken
获取政策架构 ./policySchemas/$SCHEMA_NAME GET  
获取或列出组织部门或群组的政策 ./policies:resolve POST 必需policySchemaFilterpolicyTargetKey

可选pageSizepageToken

修改组织部门中的政策 ./policies/orgunits:batchModify POST 必填requests: {policyTargetKey, policyValue, updateMask}
继承组织部门中的政策 ./policies/orgunits:batchInherit POST 必填requests: {policyTargetKey, policySchema}
修改群组中的政策 ./policies/groups:batchModify POST 必填requests: {policyTargetKey, policyValue, updateMask}
删除群组中的政策 ./policies/groups:batchDelete POST 必填requests: {policyTargetKey, policySchema}
列出群组中的优先级排序 ./policies/groups:listGroupPriorityOrdering POST 必填requests: {policyTargetKey, policyNamespace}
更新群组中的优先级排序 ./policies/groups:updateGroupPriorityOrdering POST 必填requests: {policyTargetKey, policyNamespace, groupIds}
根据政策上传文件 ./policies/files:uploadPolicyFile POST 必填requests: {policyField}

用量限额

此 API 仅供 Chrome 客户组织内部使用。有关详情,请参阅 Chrome Policy API 服务条款。如需与 Google 合作构建商业 API 客户端,请提交合作伙伴申请

后续步骤