调用YouTube Analytics API获取品牌账号数据时遇Forbidden错误的解决办法

• 验证授权范围
  确保脚本的OAuth授权包含YouTube Analytics所需的权限范围：

  • 普通分析数据用https://www.googleapis.com/auth/yt-analytics.readonly
  • 涉及收益数据用https://www.googleapis.com/auth/yt-analytics-monetary.readonly
    可在Google Apps Script项目的「OAuth同意屏幕」设置中确认已添加对应范围，或在代码中明确指定授权范围。

• 确认品牌账号权限关联

  1. 确保运行脚本的Google账号，在YouTube Studio中被授予该品牌账号的完整分析访问权限（仅管理员身份可能不够，需确认分析数据的访问权限已开通）
  2. 核对channelId变量值是否为品牌账号对应的频道ID，而非个人频道ID

• 检查API启用状态与配额
  登录Google Cloud控制台，确认：

  • YouTube Analytics API已处于启用状态
  • API配额未被耗尽，若配额不足可申请提升或等待配额周期重置

• 重置脚本授权
  旧授权缓存可能引发权限异常，操作步骤：

  1. 打开Google Apps Script项目，点击执行按钮旁的下拉菜单，选择「管理授权」
  2. 找到当前项目的授权记录，点击「移除访问权限」
  3. 重新运行脚本，按提示完成新的授权流程，确保选择关联品牌账号的Google账号

• 校验API请求参数
  检查createReport函数中第25行的API请求参数：

  • 确认ids参数格式为channel==[你的品牌频道ID]，格式不可出错
  • 指标（metrics）、维度（dimensions）需符合YouTube Analytics API规范，避免使用无权限访问的字段（如收益类指标需额外权限）

内容的提问来源于stack exchange，提问作者三井宏務