YouTube Analytics API返回数据不符、video维度失效问题咨询

你遇到的接口返回数据和Studio后台不匹配、video维度不生效的问题，是调用这个API的高频踩坑点，对应问题和修复方式如下：

• 授权Scope配置错误
  完成OAuth2.0基础认证不代表有分析数据读取权限，调用Analytics接口必须在授权请求中携带yt-analytics.readonly权限范围。如果缺失这个权限，接口不会直接返回403权限报错，会静默返回空行或者全0值，是最常见的诱因。
• 授权身份与频道不匹配
  如果你要查询的是品牌类频道（非个人Google账号直接创建的频道），OAuth授权流程中必须选中对应品牌频道的身份完成授权，用个人主账号身份授权无法读取品牌频道的分析数据。另外要确认传入ids参数的channel==后面的字符串是频道原生ID，不是自定义Handle、频道昵称，原生ID可以在YouTube Studio的「高级设置」页面直接复制。
• 请求包含已废弃指标
  你参数里的dislikes指标从2021年12月YouTube调整差评展示规则后，已经不再向API返回有效统计值，频道所有者调用也只会拿到固定0值；部分接口版本下，请求携带已废弃/不兼容的指标，会导致整个查询结果被过滤，直接返回空行。测试阶段可以先把dislikes从metrics列表里移除再重试。
• Postman测试的Token问题
  用Postman调试时要注意，每次重新授权后必须替换最新生成的Access Token，不要混用其他账号、其他Scope生成的过期Token，否则也会触发静默无数据返回。

快速验证流程 #

按以下顺序调整后测试，能快速定位问题：

1. 重新发起OAuth授权，确认授权弹窗明确提示应用需要获取「查看YouTube分析报表」的权限，完成授权后替换最新Token
2. 简化请求参数：移除dimensions=video、移除sort参数、metrics只保留views、删掉dislikes，先调用接口确认能返回非0的有效播放数据
3. 基础数据返回正常后，再逐个加回维度、其他指标，定位触发异常的具体参数

注意：API返回的数据和Studio后台本身会存在小幅差异，API会自动过滤系统判定为无效刷量的播放、互动数据，Studio后台展示的是全量原始统计值，但不会出现全0、空行的极端差异。

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