调用YouTube Data API的/videos接口时items元素返回为空问题咨询

我之前也碰到过YouTube Data API这类返回空结果的情况，来帮你拆解问题和解决办法：

首先要纠正一个小细节：你实际调用的是**videos.list接口**（不是搜索接口），因为传入了id参数——搜索接口是search.list，而videos.list是用来根据ID查询视频详情的。

下面是导致返回空items数组的核心原因和对应解决方案：

• 参数名拼写不符合API规范：你写的max_results是蛇形命名，但YouTube API要求驼峰命名的maxResults。不过这不是当前空结果的直接原因，但会影响后续分页逻辑，建议先修正。
• 视频的权限或状态限制：哪怕API密钥和视频ID都有效，以下几种情况会让API返回空结果：
  1. 视频是私有状态：私有视频只有上传者本人（或授权协作者）能通过API获取信息，仅用API密钥不行——API密钥只是验证应用的调用权限，不代表能访问私有内容。这种情况需要用OAuth 2.0授权，以视频所有者的身份发起请求。
  2. 视频有地区/年龄限制：如果视频设置了仅特定地区可看，或者需要年龄验证，而你的请求没附带regionCode参数（比如regionCode: 'US'），也没有通过OAuth验证用户身份，API会返回空结果。
  3. 视频已被删除/下架：可以直接在浏览器访问https://www.youtube.com/watch?v=UCo8bcnLyZH8tBIH9V1mLgqQ，确认视频是否还能正常打开。

下一步排查&修正步骤 #

1. 先直接访问视频链接，确认视频是否公开且可正常访问；
2. 如果是私有视频，切换为OAuth 2.0授权方式发起请求；
3. 如果是地区/年龄限制，在请求参数中添加对应地区的regionCode，或者通过OAuth验证用户身份；
4. 修正参数名：把max_results改为maxResults。

修正后的请求参数示例：

{
  key: process.env.YOUTUBE_KEY,
  part: 'contentDetails,statistics,snippet',
  id: 'UCo8bcnLyZH8tBIH9V1mLgqQ',
  maxResults: 5,
  regionCode: 'US' // 可选，根据视频可访问地区添加
}

另外，你可以用API控制台里的API Explorer直接发起测试请求，有时候能看到更详细的错误提示，而不是只返回空数组。

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