YouTube Analytics API请求adImpressions指标返回403 Forbidden错误

针对你遇到的调用YouTube Analytics API时，只要包含adImpressions指标就返回403 Forbidden，而基础指标（likes/views等）正常的问题，可从以下几个方向排查：

1. 确认API权限范围是否正确 #

广告相关指标需要特定的OAuth权限范围，普通的YouTube只读权限无法获取这类数据：

• 必须包含https://www.googleapis.com/auth/yt-analytics-monetary.readonly（针对盈利/广告类指标）或https://www.googleapis.com/auth/yt-analytics.readonly（包含所有分析数据权限）
• 检查你的OAuth授权流程，确保在获取令牌时请求了上述权限，若缺失需重新发起授权，覆盖原有令牌。

2. 检查频道的AdSense/YPP关联状态 #

即使确认投放了广告，频道可能存在以下问题：

• 未正确关联AdSense账号
• YouTube Partner Program（YPP）状态异常（如审核未通过、权限受限）
  让客户登录YouTube Studio，进入「盈利」板块，确认AdSense关联正常，且无任何权限限制提示。

3. 验证指标与维度/过滤条件的兼容性 #

虽然官方文档标注adImpressions与video维度兼容，但部分场景下可能触发权限错误：

• 尝试简化请求：去掉filters参数，将dimensions改为day，仅请求adImpressions指标，看是否能正常返回数据
• 若简化后正常，再逐步添加video维度和过滤条件，定位是否是特定视频或过滤规则导致的问题

4. 确认OAuth令牌的实际权限 #

管理员账号不一定拥有盈利数据的访问权限：

• 调用https://www.googleapis.com/oauth2/v3/tokeninfo?access_token=你的令牌解析令牌，查看scope字段确认包含广告相关权限
• 确保授权的账号确实被授予了该频道的盈利数据访问权限（部分团队会单独管控这类权限）

5. 排查数据延迟问题 #

YouTube广告数据的生成延迟通常比基础指标长（2-3天），若请求时段包含近期数据，可能数据未同步，但这种情况一般返回空数据集而非403。可尝试缩小到更早的历史时段测试。

错误响应示例： #

{
  "error": {
    "code": 403,
    "message": "Forbidden",
    "errors": [
      {
        "message": "Forbidden",
        "domain": "global",
        "reason": "forbidden"
      }
    ]
  }
}

请求示例： #

curl --location 'https://youtubeanalytics.googleapis.com/v2/reports' \
--header 'accept: application/json' \
--header 'accept-encoding: gzip, deflate' \
--header 'user-agent: (gzip)' \
--header 'x-goog-api-client: gdcl/2.140.0 gl-python/3.9.18' \
--header 'content-length: 5866' \
--header 'x-http-method-override: GET' \
--header 'content-type: application/x-www-form-urlencoded' \
--header 'authorization: Bearer ***' \
--data-urlencode 'metrics=likes,adImpressions' \
--data-urlencode 'startDate=2025-01-01' \
--data-urlencode 'endDate=2025-01-31' \
--data-urlencode 'ids=channel==UCrQPfnt2X3fef95kqVqYqAA' \
--data-urlencode 'dimensions=video' \
--data-urlencode 'filters=video==yZ-na0KZWTs,7ftlK-E1UJE,W72sqFPo4Qo.....' \
--data-urlencode 'alt=json'

内容的提问来源于stack exchange，提问作者Adverity