You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

AdSense API v2版本更新后调用报表接口返回200但无行数据是什么原因

AdSense API v2报表接口返回空数据排查方案

高概率遗漏配置/参数(按排查优先级排序)

  • 缺失includeZeroRecords参数
    AdSense API v2默认不返回指标全为0的行数据,只要你查询的AD_CLIENT_ID对应维度下当日AD_REQUESTS值为0,就会直接返回空行结果。追加参数includeZeroRecords=true即可拉取到含零值的全量维度数据。
  • 时区不匹配
    API默认使用你的AdSense账户本地时区处理传入的日期参数,如果你传入的2021-10-12为UTC时间,和账户时区存在时差时,会实际查询其他日期的数据,导致返回空。可追加timezone参数指定时区,例如timezone=UTC统一用UTC时间查询。
  • 权限不足
    你请求使用的OAuth 2.0凭证关联的谷歌账号,需要对目标pub-xxxxxxxxxxxxxxx账号拥有至少报表只读权限。权限不足时接口不会报错,仅返回空数据集。
  • 维度与指标组合兼容性问题
    先移除dimensions=AD_CLIENT_ID参数仅查询AD_REQUESTS指标,若此时有数据返回,说明你账户下的广告客户端在查询日期无对应请求数据;若仍无数据继续排查其他问题。
  • 币种参数冲突
    如果你的账户默认结算币种不是USD,跨币种查询历史数据可能触发空返回,可移除currencyCode=USD参数使用默认币种查询验证。

测试用请求示例

你可以直接使用调整后的请求路径验证:

https://adsense.googleapis.com/v2/accounts/pub-xxxxxxxxxxxxxxx/reports:generate?dateRange=CUSTOM&startDate.year=2021&startDate.month=10&startDate.day=12&endDate.year=2021&endDate.month=10&endDate.day=12&currencyCode=USD&metrics=AD_REQUESTS&dimensions=AD_CLIENT_ID&alt=json&includeZeroRecords=true&timezone=UTC

内容的提问来源于stack exchange,提问作者Seunghwan Kim

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.30 11:24:05