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 个细分。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
pageToken

string

可选。从之前的 securityInsights.queryUrlVisitsBreakdowns 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 securityInsights.queryUrlVisitsBreakdowns 的所有其他参数必须与提供页面令牌的调用匹配。
filter

string

可选。要应用于请求的过滤条件。如需了解语法，请参阅 AIP-160。我们不提供 180 天前或 48 小时内的事件数据。如果未指定 event_time，结果将截止到 48 小时前。

支持过滤的字段：- user - event_domain - event_time

按 user 或 event_domain 过滤需要将 breakdown 维度设置为相应的值（例如，您必须设置 breakdown = USER 才能按 user 过滤）。

支持的运算符：- =（适用于 user 和 event_domain）。- <=，event_time。

支持的连词：- AND

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

enum (UrlVisitsMetric)

可选。要返回细分的指标。默认值为 网址_VISITS_METRIC_TOTAL_SUSPICIOUS_网址_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

网址访问的事件网域。