Method: domains.trafficStats.list

列出所有可用日期的流量统计信息。如果用户无权访问网域的 TrafficStats，则返回 PERMISSION_DENIED。

HTTP 请求

GET https://gmailpostmastertools.googleapis.com/v1/{parent=domains/*}/trafficStats

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

我们想要列出其流量统计信息的网域的资源名称。其格式应为 domains/{domain_name}，其中 domain_name 是完全限定域名。

查询参数

参数
startDate

object (Date)

要检索的指标的最早日期（含此日期）。必须同时指定 startDate 和 endDate 或都未指定。如果仅指定了 1 个参数，或者 endDate 早于 startDate 的时间，则返回 INVALID_ARGUMENT。
endDate

object (Date)

要检索的排除指标的最近一天。必须同时指定 startDate 和 endDate 或都未指定。如果仅指定了 1 个参数，或者 endDate 早于 startDate 的时间，则返回 INVALID_ARGUMENT。
pageSize

integer

请求的页面大小。服务器返回的 TrafficStats 可能少于请求的数量。如果未指定，服务器将选择相应的默认值。
pageToken

string

从上一个 List 请求返回的 nextPageToken 值（如果有）。这是之前调用 trafficStats.list 方法后返回的 ListTrafficStatsResponse.next_page_token 值。

请求正文

请求正文必须为空。

响应正文

trafficStats.list 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "trafficStats": [
    {
      object (TrafficStats)
    }
  ],
  "nextPageToken": string
}
字段
trafficStats[]

object (TrafficStats)

TrafficStats 的列表。
nextPageToken

string

用于检索下一页结果的令牌。如果列表中没有更多结果，则为空。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/postmaster.readonly

有关详情，请参阅授权指南。

日期

表示整个或部分日历日期（例如生日）。一天中的时间和时区要么在别处指定，要么不重要。日期相对于公历。可以表示以下任一情况：

  • 包含非零年份、月份和天值的完整日期。
  • 月份和天，年份值为零（例如周年纪念日）。
  • 单独的年份，月份和天值为零。
  • 年份和月份，天值为零（例如，信用卡到期日期）。

相关类型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
字段
year

integer

日期中的年份。必须介于 1 到 9999 之间，或为 0（即指定不含年份的日期）。
month

integer

一年中的第几个月。必须介于 1 到 12 之间，或为 0（即只指定年份，不指定月份和天值）。
day

integer

一个月中的第几天。必须介于 1 到 31 之间并且对年份和月份有效，或为 0（即天不重要，指定单独的年份或者年份和月份）。