如何通过YouTube API获取订阅动态流？v3/activities返回空的排查与替代方案

一、v3/activities?mine=true返回空数组的原因 #

你搞混了这个接口的实际用途：v3/activities?mine=true是用来获取当前授权用户自身频道的活动记录（比如自己上传视频、发布社区帖子、点赞/评论内容等操作），而非订阅频道的动态流。出现空数组的情况，要么是你自己的频道没有产生过任何活动，要么是授权权限不足：

• 必须确保授权时请求了https://www.googleapis.com/auth/youtube.readonly（或更高权限的youtube权限范围），虽然你能调用subscriptions?mine=true，但仍需确认权限覆盖了活动读取权限。

二、获取订阅动态流的正确方式 #

要拿到和YouTube订阅页一致的动态内容，不能用mine=true的activities接口，有两种可行方案：

方案1：批量查询订阅频道的活动（推荐） #

先通过v3/subscriptions?mine=true拿到所有订阅的频道ID，然后调用v3/activities时用channelId参数批量传入多个频道ID（用逗号分隔），指定part=snippet,contentDetails并设置maxResults控制返回数量：

GET https://www.googleapis.com/youtube/v3/activities?channelId=频道ID1,频道ID2&part=snippet,contentDetails&maxResults=50&key=你的API密钥

该接口会返回订阅频道的所有公开活动（包括上传视频、直播预告、社区帖子等），和订阅页内容完全匹配，且批量查询能减少请求次数，降低API配额消耗。

方案2：仅获取订阅频道的上传视频 #

如果只需要视频内容，不需要其他动态类型，可以通过v3/subscriptions?mine=true拿到每个频道的contentDetails.relatedPlaylists.uploads（即该频道的上传视频播放列表ID），再调用v3/playlistItems获取这些播放列表里的视频。但这种方式只能拿到视频内容，无法覆盖社区帖子、直播预告等其他动态，且请求次数更多，配额消耗更大。

三、API配额优化技巧 #

• 批量请求：尽可能使用批量参数（如多个channelId）减少请求次数，每个请求最多可传入50个频道ID。
• 缓存机制：定期缓存订阅列表和活动数据（比如每10-15分钟刷新一次），避免重复调用API。

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