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 个细分。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
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 维度设置为相应的值（例如，您必须设置 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

内容传输的内容分类。