调用youtube/v3/playlistItems API返回异常历史直播数据的技术咨询

为什么会返回这类已结束的直播数据？ #

• 前台展示与API访问逻辑分离：YouTube频道主页的视频列表会自动过滤历史直播回放内容，但API不会套用这些前端过滤规则。只要你请求的播放列表包含这类直播回放条目（比如系统自动生成的「直播回放」专用播放列表），API就会完整返回所有条目，不受前台展示设置影响。
• 历史直播归档规则：2016年的直播结束后，YouTube会自动将回放视频归档到专属播放列表中。即便频道所有者后续在前台隐藏了该播放列表，API依然能获取到列表内容——这类系统生成的播放列表默认对API开放访问权限，除非手动设置了严格的隐私限制。

如何阻止这类数据被返回？ #

• 客户端过滤（推荐）：调用API时，请求包含status和contentDetails的part参数（示例：part=snippet,status,contentDetails），然后在返回结果中过滤掉标记为已结束直播的条目：
  • 检查item.snippet.liveBroadcastContent字段，仅保留值为none的条目（ended代表已结束的直播，live代表正在直播）
• 确认播放列表ID正确性：如果你原本想获取频道的普通视频列表而非直播回放列表，需确认传入的playlistId是否正确。频道的普通视频列表ID是将频道ID的UC前缀替换为UU，而直播回放列表的前缀通常是UUR（对应频道ID的UC替换），误传ID的话换成正确的普通视频列表ID即可。
• 额外调用videos.list验证（可选）：若需要更精准过滤，可用返回的contentDetails.videoId调用videos.list API，检查liveStreamingDetails.actualEndTime字段，存在该字段的即为已结束直播，直接排除。

内容的提问来源于stack exchange，提问作者김유진