使用YouTube Data API V3在JavaScript中获取频道订阅列表遇错求助

我来帮你一步步搞定这两个开发者调用YouTube API时常见的问题：

1. 先处理旧身份验证库的废弃警告 #

Google已经明确要废弃gapi.auth2这套旧授权库了，咱们直接换成最新的Google Identity Services (GIS)，既能消除警告，也更安全稳定。下面是替换后的完整代码，你只需要把YOUR_API_KEY和YOUR_CLIENT_ID换成自己的信息：

<script src="https://accounts.google.com/gsi/client" async defer></script>
<script>
let tokenClient;
let gapiClientReady = false;
let gisClientReady = false;

// 初始化GAPI客户端
function initGapi() {
  gapi.load('client', async () => {
    await gapi.client.init({
      apiKey: 'YOUR_API_KEY',
      discoveryDocs: ['https://www.googleapis.com/discovery/v1/apis/youtube/v3/rest'],
    });
    gapiClientReady = true;
    checkButtonStatus();
  });
}

// 初始化GIS授权客户端
function initGis() {
  tokenClient = google.accounts.oauth2.initTokenClient({
    client_id: 'YOUR_CLIENT_ID',
    scope: 'https://www.googleapis.com/auth/youtube.channel-memberships.readonly', // 权限说明见下文
    callback: (resp) => {
      if (resp.error) throw resp;
      console.log('授权成功');
      document.getElementById('execute-btn').style.visibility = 'visible';
    },
  });
  gisClientReady = true;
  checkButtonStatus();
}

// 两个客户端都准备好才显示授权按钮
function checkButtonStatus() {
  if (gapiClientReady && gisClientReady) {
    document.getElementById('auth-btn').style.visibility = 'visible';
  }
}

// 触发授权流程
function handleAuth() {
  const existingToken = gapi.client.getToken();
  if (!existingToken) {
    // 首次授权，弹出权限同意窗口
    tokenClient.requestAccessToken({prompt: 'consent'});
  } else {
    // 已有token，静默刷新有效期
    tokenClient.requestAccessToken({prompt: ''});
  }
}

// 执行API调用获取订阅数据
async function handleExecute() {
  try {
    const response = await gapi.client.youtube.subscriptions.list({
      part: ['subscriberSnippet,contentDetails'],
      channelId: 'UCLlE_JEV7I0pQ7fhY4BIrrQ'
    });
    console.log('订阅者数据:', response.result);
    // 这里可以添加渲染订阅列表的业务逻辑
  } catch (err) {
    console.error('API调用失败:', err);
  }
}

// 页面加载时初始化两个客户端
window.addEventListener('load', () => {
  initGapi();
  initGis();
});
</script>

<button id="auth-btn" style="visibility: hidden;">授权并加载</button>
<button id="execute-btn" style="visibility: hidden;">获取订阅列表</button>

2. 解决「请求者无权访问请求的订阅」错误 #

这个错误大概率是权限范围不足或者API参数理解偏差导致的，分两种场景排查：

场景A：你想获取「自己频道的订阅者列表」（谁关注了你的频道） #

这种场景下，youtube.readonly权限是不够的，必须使用更高级的权限：

• 推荐用最小化权限：https://www.googleapis.com/auth/youtube.channel-memberships.readonly（仅能获取订阅者信息，符合权限最小化原则）
• 若需要更多API操作，也可以用全权限：https://www.googleapis.com/auth/youtube

上面的代码已经配置了推荐的精细权限，你只需要确保授权时同意该权限即可。

场景B：你想获取「自己账号订阅的频道列表」（你关注了谁） #

那你之前的API参数用错了！channelId是用来查询某个频道的订阅者，查询自己订阅的频道应该用mine: true替代channelId，且此时用youtube.readonly权限就足够。修改后的调用代码如下：

async function handleExecute() {
  try {
    const response = await gapi.client.youtube.subscriptions.list({
      part: ['snippet,contentDetails'],
      mine: true
    });
    console.log('我订阅的频道:', response.result);
  } catch (err) {
    console.error('API调用失败:', err);
  }
}

额外检查项 #

• 确认你的OAuth客户端是Web应用类型，并且在Google开发者控制台中正确配置了授权域名（比如本地测试的http://localhost:5500），否则会出现隐形的授权失败。
• 确保授权登录的Google账号是该YouTube频道的所有者，用其他账号登录肯定无法获取数据。

内容的提问来源于stack exchange，提问作者Abdul Raheem Ghani