Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

傳回指定指標和細分維度的內容轉移摘要。

HTTP 要求

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

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

路徑參數

參數
customer

string

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

查詢參數

參數
pageSize

integer

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

string

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

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

string

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

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

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

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

支援的連詞：- AND

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

enum (ContentTransfersMetric)

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

enum (ContentTransfersBreakdownDimension)

(選用步驟) 用來細分內容轉移作業的維度。預設為 USER。
fixedTimeRange

enum (FixedTimeRange)

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

要求主體

要求主體必須為空白。

回應主體

securityInsights.queryContentTransfersBreakdowns 的回應訊息。

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

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

object (ContentTransfersBreakdown)

指定洞察資料的內容轉移細目。
nextPageToken

string

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

授權範圍

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

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

ContentTransfersBreakdownDimension

用來細分內容轉移作業的維度。

列舉
CONTENT_TRANSFERS_BREAKDOWN_DIMENSION_UNSPECIFIED 未指定細分維度。預設為 USER。
USER 按使用者細目劃分。
EVENT_DOMAIN 依事件網域細目。
CONTENT_CATEGORY 依內容類別細分。

ContentTransfersBreakdown

特定細分維度的內容轉移摘要。

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

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

object (ContentTransfersSummary)

依細分維度顯示的內容轉移摘要。
聯集欄位 dimension。細目維度。dimension 只能是下列其中一項：
user

string

轉移內容的使用者。
eventDomain

string

內容轉移的事件網域。
contentCategory

string

要轉移的內容類別。