如何以品牌账号运行Google Apps Script并完成权限授权？

阿华AIGC实验室

2026-5-27

解决Google Apps Script以品牌账号身份操作YouTube播放列表的权限问题

我遇到过不少类似的情况，品牌账号的权限逻辑确实容易绕晕——核心点在于：品牌账号本身不能独立运行或拥有Google Apps Script项目，它是依附于主账号的"子身份"，所有操作都需要通过主账号发起，但要明确指定操作的是品牌账号的资源，同时配置正确的权限范围。

下面是一步步解决的方案：

1. 确认主账号对品牌账号的管理权限

首先确保你的主账号在YouTube Studio中拥有目标品牌账号的所有者/管理员权限：

打开YouTube Studio，点击右上角的账号切换器，选择目标品牌账号。
进入「设置」→「权限」，检查你的主账号是否在列表中，且角色是「所有者」或「管理员」（如果不在，先添加）。

2. 配置脚本的正确OAuth权限范围

Google Apps Script默认的权限范围可能不够，需要手动指定YouTube Data API的必要范围：

在脚本编辑器中，点击「查看」→「显示清单文件」，打开appsscript.json。

修改oauthScopes数组，添加操作播放列表所需的权限（推荐使用最小权限原则）：

{
  "timeZone": "Asia/Shanghai",
  "dependencies": {},
  "oauthScopes": [
    "https://www.googleapis.com/auth/script.external_request",
    "https://www.googleapis.com/auth/youtube.force-ssl"
  ],
  "exceptionLogging": "STACKDRIVER"
}

youtube.force-ssl权限足够完成播放列表插入操作，比全权限的youtube更安全。

3. 在脚本中明确指定品牌账号的资源

脚本默认会使用当前运行账号（主账号）的资源，所以你需要确保操作的是品牌账号的播放列表，并且可以通过API确认品牌账号的频道ID：

先运行下面的辅助函数，获取你主账号管理的所有品牌账号频道信息：

function getBrandManagedChannels() {
  const response = YouTube.Channels.list('id,snippet', {
    mine: true,
    managedByMe: true
  });
  response.items.forEach(channel => {
    Logger.log(`品牌账号频道ID: ${channel.id} | 名称: ${channel.snippet.title}`);
  });
}

查看日志，找到目标品牌账号的频道ID，然后确认你的播放列表ID属于该频道（可以在YouTube Studio的播放列表设置中查看ID）。

在插入视频到播放列表的代码中，确保使用的是品牌账号的播放列表ID，示例代码：

function addVideoToBrandPlaylist() {
  const playlistId = "YOUR_BRAND_PLAYLIST_ID"; // 替换为品牌账号的播放列表ID
  const videoId = "TARGET_VIDEO_ID"; // 替换为要插入的视频ID

  const resource = {
    snippet: {
      playlistId: playlistId,
      resourceId: {
        kind: "youtube#video",
        videoId: videoId
      }
    }
  };

  try {
    const response = YouTube.PlaylistItems.insert(resource, "snippet");
    Logger.log(`视频已成功插入播放列表: ${response.id}`);
  } catch (e) {
    Logger.log(`错误: ${e.message}`);
  }
}