Accounts.reports: generate

需要授权

根据查询参数中发送的报告请求生成AdSense报告。返回JSON作为结果;要获取CSV格式的输出,请将“alt=csv”指定为查询参数。立即尝试

请求

HTTP请求

GET https://www.googleapis.com/adsense/v1.4/accounts/accountId/reports

参数

参数名称 说明
路径参数
accountId string 要为其生成报告的帐户。
必需查询参数
endDate string 要生成报告的日期范围的结束日期(包含此结束日期),格式为“YYYY-MM-DD”。
startDate string 要生成报告的日期范围的开始日期(包含此开始日期),格式为“YYYY-MM-DD”。
可选查询参数
currency string 生成货币指标报告所使用的币种。如未设置,则默认为帐户的币种。
dimension string 报告依据的维度。可用的维度在指标和维度中有所说明。要详细了解每个维度,请参阅AdSense术语库
filter string 应用到报告的过滤器
locale string 用于将报告输出翻译为本地语言的语言区域。如果未指定,则默认为“en_US”。
maxResults integer 要返回的报告数据的行数上限。如果startIndex未设置或为零,则API将返回maxResults值指定的所有行。如果未设置maxResults,则API将返回尽可能多的行,最多可达50000行。

如果startIndex设置为非零值,则startIndex和maxResults的总数不得超过5000,否则将返回错误:不支持超过5000行的分页。
可接受的值包括050000(含0和50000)。
metric string 要包含在报告中的数字列。可用的指标在指标和维度中有所说明。要详细了解每个指标,请参阅AdSense术语库
sort string 对生成的报告进行排序所使用的维度或指标的名称。可以选择性加上“+”前缀(按升序排序)或“-”前缀(按降序排序)。如果未指定任何前缀,则列将按升序排序。
startIndex integer 要返回的第一行报告数据的索引。如果startIndex未设置或为零,则API将返回maxResults值指定的所有行。如果未设置maxResults,则API将返回尽可能多的行,最多可达50000行。

如果startIndex设置为非零值,则startIndex和maxResults的总数不得超过5000,否则将返回错误:不支持超过5000行的分页。可接受的值包括05000(含0和5000)。
useTimezoneReporting boolean 报告是否应该按照AdSense帐户的本地时区生成。如果为false,则会使用默认的PST/PDT时区。

授权

此请求至少需要获得下列其中一个范围的授权(详细了解身份验证和授权)。

范围
https://www.googleapis.com/auth/adsense
https://www.googleapis.com/auth/adsense.readonly

请求正文

不要使用此方法提供请求正文。

响应

如果成功,此方法将返回具有以下结构的响应正文:

JSON

{
  "kind": "adsense#report",
  "totalMatchedRows": long,
  "headers": [
    {
      "name": string,
      "type": string,
      "currency": string
    }
  ],
  "rows": [
    [
      string
    ]
  ],
  "totals": [
    string
  ],
  "averages": [
    string
  ],
  "warnings": [
    string
  ],
  "startDate": string,
  "endDate": string
}
属性名称 说明 备注
kind string 种类,在此示例中为adsense#report。
totalMatchedRows long 与报告请求匹配的总行数。由于受到所请求的行数或报告行上限的限制,响应中返回的行数可能较少。
headers[] list 报告中所请求列的标头信息。此为标头列表;每个标头对应请求中的相应维度,后跟对应请求中相应指标的标头。
headers[].name string 标头的名称。
headers[].type string 标头的类型;其中有DIMENSION、METRIC_TALLY、METRIC_RATIO或METRIC_CURRENCY。

可接受的值为:
  • "DIMENSION":
  • "METRIC_CURRENCY":
  • "METRIC_RATIO":
  • "METRIC_TALLY":
headers[].currency string 此列的币种。只有标头类型为METRIC_CURRENCY时才显示币种。
rows[] list 报告的输出行。每一行表示一个单元格列表;每个单元格对应请求中的相应维度,后跟对应请求中相应指标的单元格。维度单元格包含字符串,而指标单元格包含数字。
totals[] list 报告的总计行。该行与报告中的其他行长度相同;与维度列对应的单元格为空。
averages[] list 报告的平均行。该行与报告中的其他行长度相同;与维度列对应的单元格为空。
warnings[] list 与生成报告相关的所有警告。
startDate string 所请求的开始日期,格式为yyy-mm-dd。
endDate string 所请求的结束日期,格式为yyy-mm-dd。

CSV

"(dynamic)"
(foreach)
  string
(/foreach)
属性名称 说明 备注
(dynamic) string

立即尝试!

请使用下面的API Explorer针对实际数据调用此方法并查看响应。

发送以下问题的反馈:

此网页
AdSense Management API
AdSense Management API