YouTube Data API会员接口403权限禁止问题排查求助

错误信息 #

{
  "error": {
    "code": 403,
    "message": "Access forbidden. The request may not be properly authorized.",
    "errors": [
      {
        "message": "Access forbidden. The request may not be properly authorized.",
        "domain": "youtube.common",
        "reason": "forbidden"
      }
    ]
  }
}

已配置的权限范围 #

scope: [
  'email',
  'profile',
  'openid',
  'https://www.googleapis.com/auth/youtube.channel-memberships.creator',
  'https://www.googleapis.com/auth/youtube',
  'https://www.googleapis.com/auth/youtube.readonly',
  'https://www.googleapis.com/auth/youtubepartner',
  'https://www.googleapis.com/auth/youtubepartner-channel-audit',
]

问题代码（会员API请求） #

async requestMembers({
  access,
  refresh,
}: {
  access: string;
  refresh: string;
}) {
  const url = `${'https://youtube.googleapis.com/youtube/v3/'}members?part=snippet`;
  fetch(url, {
    headers: {
      Authorization: `Bearer ${access}`,
      'Content-Type': 'application/json',
    },
  })
    .then((res) => res.json())
    .then((json) => {
      console.log(JSON.stringify(json));
    });
}

正常运行的评论API代码 #

sendComment = (text: string, access_token: string, id: string) => {
  const url = `${'https://youtube.googleapis.com/youtube/v3/'}liveChat/messages?part=snippet`;
  fetch(url, {
    method: 'POST',
    body: JSON.stringify({
      snippet: {
        liveChatId: id,
        type: 'textMessageEvent',
        textMessageDetails: {
          messageText: text,
        },
      },
    }),
    headers: {
      Authorization: `Bearer ${access_token}`,
      'Content-Type': 'application/json',
    },
  })
    .then((response) => response.json())
    .then((data) => console.log('send comment - ', data));
};

核心原因分析 #

1. 会员API强制参数缺失：YouTube Data API的members端点要求必须指定mine=true参数，用于获取当前授权用户所属频道的会员数据。如果不添加该参数，请求会默认尝试获取公开会员列表（该接口不支持此操作），直接触发403权限错误。而评论API无需此参数，因此可正常运行。
2. 权限范围实际生效存疑：虽然配置了youtube.channel-memberships.creator权限，但访问令牌可能并未实际包含该权限——比如OAuth授权流程中用户未同意该权限，或刷新令牌时未重新请求该范围。
3. 账号权限限制：会员API仅允许频道的所有者/创作者本人调用，即使是频道管理员账号也可能没有权限。

解决建议 #

1. 添加mine=true参数：修改会员API请求的URL，强制指定获取当前授权用户的频道会员：

   const url = 'https://youtube.googleapis.com/youtube/v3/members?part=snippet&mine=true';
   

2. 验证访问令牌的权限范围：调用Google令牌信息接口检查实际权限：

   curl "https://oauth2.googleapis.com/tokeninfo?access_token=YOUR_ACCESS_TOKEN"
   

   确认返回结果中包含https://www.googleapis.com/auth/youtube.channel-memberships.creator。
3. 确保授权账号为频道所有者：使用频道的官方所有者账号完成OAuth授权，而非普通管理员账号。
4. 完善错误处理：在fetch请求中添加状态检查，捕获非200响应的详细错误：

   .then((res) => {
     if (!res.ok) throw new Error(`HTTP error! status: ${res.status}`);
     return res.json();
   })
   .catch((err) => console.error('Request error:', err));
   

5. 刷新访问令牌：如果令牌已过期或权限不全，使用refresh令牌重新获取包含完整权限的access令牌。

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