借助 Security Insights API，您可以启用或停用 Chrome 安全性洞察功能、检查其启用状态，以及查询洞察数据（例如内容传输和网址访问）。
API 方法快速概览
网址相对于
https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| 说明 | 相对网址 | HTTP 方法 | 允许的请求参数 |
|---|---|---|---|
| 为您的网域启用洞察功能，并为网域中的根组织部门/一组特定的组织部门配置 Chrome 连接器 | /enterprise/securityInsights:enable | POST | 可选: targetOus |
| 为您的网域停用洞察功能 | /enterprise/securityInsights:disable | POST | |
| 检查网域的洞察功能启用状态 | /enterprise/securityInsights:checkEnablementStatus | GET | |
| 查询网域的高级内容传输摘要 | /enterprise/securityInsights:queryContentTransfers | GET | 可选：filter |
| 查询内容传输摘要，并按用户/网域/内容分类细分 | /enterprise/securityInsights:queryContentTransfersBreakdowns | GET | 可选：filter、metric、breakdown、fixedTimeRange、pageSize、pageToken |
| 查询网域的高级网址访问摘要 | /enterprise/securityInsights:queryUrlVisits | GET | 可选：filter |
| 查询网址访问摘要，并按用户/网域细分 | /enterprise/securityInsights:queryUrlVisitsBreakdowns | GET | 可选：filter、metric、breakdown、fixedTimeRange、pageSize、pageToken |
如需查看请求和响应示例，请参阅 代码示例。
订阅要求
以下 API 方法需要有效的 Chrome 企业进阶版订阅。如果客户没有此订阅，请求不会被阻止，但查询结果将为空。
queryUrlVisitsqueryUrlVisitsBreakdowns
管理员权限
根据调用的方法，需要不同的管理员权限。
| 方法 | 所需的管理员权限 |
|---|---|
| 启用 | “组织部门 > 读取” “服务 > Chrome 管理 > 设置 > 管理用户设置” “服务 > Chrome DLP > 管理 Chrome DLP 应用数据分析设置” |
| 停用 | “组织部门 > 读取” “服务 > Chrome 管理 > 设置 > 管理用户设置” “服务 > Chrome DLP > 管理 Chrome DLP 应用数据分析设置” |
| checkEnablementStatus | “组织部门 > 读取” “服务 > Chrome DLP > 管理 Chrome DLP 应用数据分析设置” 或 “服务 > Chrome DLP > 查看 Chrome DLP 应用数据分析设置” |
| queryContentTransfers | “服务 > Chrome DLP > 查看 Chrome DLP 应用数据分析设置” |
| queryContentTransfersBreakdowns | “服务 > Chrome DLP > 查看 Chrome DLP 应用数据分析设置” |
| queryUrlVisits | “服务 > Chrome DLP > 查看 Chrome DLP 应用数据分析设置” |
| queryUrlVisitsBreakdowns | “服务 > Chrome DLP > 查看 Chrome DLP 应用数据分析设置” |
如需管理管理员角色和权限，请访问“管理控制台 -> 管理员角色”。
API 范围
启用和停用 API 需要以下 OAuth 范围：
https://www.googleapis.com/auth/chrome.management.securityinsights
对于 checkEnablementStatus 和所有查询方法，可以使用以下任一范围：
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
如需了解详情，请参阅身份验证 概览。