Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

傳回指定指標和細分維度的網址造訪摘要。

HTTP 要求

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/enterprise/securityInsights:queryUrlVisitsBreakdowns

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customer

string

必填。客戶 ID，格式為「customers/{customer_id}」。

查詢參數

參數
pageSize

integer

(選用步驟) 要傳回的細目數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 個細目。許可的最大值為 1000；超出的數值將一律指定為 1000。
pageToken

string

(選用步驟) 屬於接收自前一個 securityInsights.queryUrlVisitsBreakdowns 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 securityInsights.queryUrlVisitsBreakdowns 的所有其他參數須與提供網頁權杖的呼叫相符。
filter

string

(選用步驟) 要套用至要求的篩選器。如需語法，請參閱 AIP-160。系統不會提供 180 天前或 48 小時內的事件資料。如未指定 event_time，結果會顯示 48 小時前的資料。

支援的篩選欄位：- user - event_domain - event_time

如要依 user 或 event_domain 篩選，請將 breakdown 維度設為對應值 (例如，如要依 user 篩選，請將 breakdown = USER 設為 user)。

支援的運算子：- =，適用於 user 和 event_domain。- <=，費用只要 event_time。

支援的連詞：- AND

範例：user = "testuser" AND event_time <= "2024-01-02T00:00:00Z"
metric

enum (UrlVisitsMetric)

(選用步驟) 要傳回細分的指標。預設為 URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS。
breakdown

enum (UrlVisitsBreakdownDimension)

(選用步驟) 用來細分網址造訪次數的維度。預設為 USER。
fixedTimeRange

enum (FixedTimeRange)

(選用步驟) 要傳回細目的固定時間範圍。預設為 FIXED_TIME_RANGE_FOUR_WEEKS。系統會使用固定時間範圍進行預先運算，並縮短回應時間。

要求主體

要求主體必須為空白。

回應主體

securityInsights.queryUrlVisitsBreakdowns 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "urlVisitsBreakdowns": [
    {
      object (UrlVisitsBreakdown)
    }
  ],
  "nextPageToken": string
}
欄位
urlVisitsBreakdowns[]

object (UrlVisitsBreakdown)

指定洞察資料的網址造訪細目。
nextPageToken

string

可做為 pageToken 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
  • https://www.googleapis.com/auth/chrome.management.securityinsights

UrlVisitsBreakdownDimension

用來細分網址造訪次數的維度。

列舉
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED 未指定細分維度。預設為 USER。
USER 按使用者細目劃分。
EVENT_DOMAIN 依事件網域細目。

UrlVisitsBreakdown

特定細分維度的網址造訪摘要。

JSON 表示法 
{
  "summary": {
    object (UrlVisitsSummary)
  },

  // Union field dimension can be only one of the following:
  "user": string,
  "eventDomain": string
  // End of list of possible types for union field dimension.
}
欄位
summary

object (UrlVisitsSummary)

細分維度的網址造訪次數摘要。
聯集欄位 dimension。細目維度。dimension 只能是下列其中一項：
user

string

造訪網址的使用者。
eventDomain

string

網址造訪的事件網域。