Google Apps Script中YouTube品牌账号OAuth2授权失败求助

问题分析 #

核心问题在于：使用GAS的YouTube高级服务访问关联品牌账号的频道时，授权流程看似完成，但实际请求仍提示权限不足。这是因为品牌账号并非独立Google账号，GAS默认的OAuth配置和mine: true参数在该场景下存在适配缺陷。

解决方案 #

1. 显式配置OAuth权限范围 #

GAS默认的YouTube权限范围不足以覆盖品牌账号的管理权限，需手动在appsscript.json中添加完整API权限：

• 打开GAS编辑器，点击「查看」→「显示清单文件」
• 修改oauthScopes字段，添加核心权限范围，示例：

{
  "oauthScopes": [
    "https://www.googleapis.com/auth/youtube.force-ssl",
    "https://www.googleapis.com/auth/script.external_request"
  ]
}

其中youtube.force-ssl是管理YouTube频道、视频所需的核心权限，可覆盖所有读写操作。

2. 替换mine: true为适配品牌账号的参数 #

mine: true无法正确关联品牌频道，建议改用以下两种方式：

方式一：直接指定品牌频道ID

先从YouTube工作室「设置」→「频道设置」中获取品牌频道ID，然后传入参数调用：

function showBrandChannel() {
  const channelId = "你的品牌频道ID";
  const channels = YouTube.Channels.list(["snippet"], { id: channelId });
  console.log(channels);
}

方式二：获取当前用户管理的所有频道（含品牌账号）

使用managedByMe: true参数，可返回当前用户管理的全部频道，包括品牌账号：

function showManagedChannels() {
  const channels = YouTube.Channels.list(["snippet"], { managedByMe: true });
  console.log(channels);
}

3. 确认自定义GCP项目的配置（若已切换） #

若已将脚本绑定到自定义GCP项目，需确保：

• GCP控制台中已启用YouTube Data API v3
• OAuth同意屏幕中添加了所有配置的权限范围
• 品牌账号拥有者已完成该应用的OAuth授权流程

4. 重置授权缓存 #

若存在授权缓存问题，按以下步骤重置：

• 打开GAS编辑器，点击「运行」→「授权」，重新完成授权
• 访问Google账号「第三方应用连接」页面，移除该脚本授权后重新授权

验证测试 #

完成上述配置后，运行修改后的函数即可正常获取品牌账号的频道信息，后续视频更新等操作也可基于此流程实现。

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