Security Insights API

您可以使用 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 選用：篩選器
查詢內容傳輸摘要，並依使用者/網域/內容類別細分 /enterprise/securityInsights:queryContentTransfersBreakdowns GET 選用：篩選器、指標、細目、fixedTimeRange、pageSize、pageToken
查詢網域的高層級網址造訪摘要 /enterprise/securityInsights:queryUrlVisits GET 選用：篩選器
查詢網址造訪摘要，並依使用者/網域細分 /enterprise/securityInsights:queryUrlVisitsBreakdowns GET 選用：篩選器、指標、細目、fixedTimeRange、pageSize、pageToken

如需要求和回應範例，請參閱程式碼範例。

訂閱規定

下列 API 方法需要有效的 Chrome Enterprise 進階版訂閱方案。如果顧客沒有這項訂閱方案，系統不會封鎖要求，但查詢結果會是空白。

  • queryUrlVisits
  • queryUrlVisitsBreakdowns

管理員權限

視呼叫的方法而定，您需要不同的管理員權限。

方法 需要管理員權限
啟用 「機構單位」>「讀取」
「服務」>「Chrome 管理服務」>「設定」>「管理使用者設定」
「服務」>「Chrome 資料遺失防護」>「管理 Chrome 資料遺失防護應用程式深入分析設定」
停用 「機構單位」>「讀取」
「服務」>「Chrome 管理服務」>「設定」>「管理使用者設定」
「服務」>「Chrome 資料遺失防護」>「管理 Chrome 資料遺失防護應用程式深入分析設定」
checkEnablementStatus 「機構單位 > 讀取」
「服務 > Chrome 資料遺失防護 > 管理 Chrome 資料遺失防護應用程式深入分析設定」或「服務 > Chrome 資料遺失防護 > 查看 Chrome 資料遺失防護應用程式深入分析設定」
queryContentTransfers 「服務 > Chrome 資料遺失防護 > 查看 Chrome 資料遺失防護應用程式深入分析設定」
queryContentTransfersBreakdowns 「服務 > Chrome 資料遺失防護 > 查看 Chrome 資料遺失防護應用程式深入分析設定」
queryUrlVisits 「服務 > Chrome 資料遺失防護 > 查看 Chrome 資料遺失防護應用程式深入分析設定」
queryUrlVisitsBreakdowns 「服務 > Chrome 資料遺失防護 > 查看 Chrome 資料遺失防護應用程式深入分析設定」

如要管理管理員角色和權限，請前往「管理控制台 -> 管理員角色」。

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

詳情請參閱「驗證總覽」。