YouTube Data API PlaylistItems: list接口分页视频重复问题咨询

可能原因及对应解决办法 #

• 播放列表本身存在重复条目
  先检查目标播放列表是否被用户多次添加了同一视频：调用接口时将part参数改为snippet,contentDetails，返回结果中每个条目都有唯一的id（PlaylistItem的ID），如果两个条目contentDetails.videoId相同但id不同，说明是用户主动重复添加的，这属于正常情况，不是API问题。

• 请求过程中播放列表被修改
  如果在分页请求的间隙，播放列表被编辑（添加/删除视频、调整顺序），API返回的pageToken会基于当前列表状态生成，可能导致前后页内容重叠。解决方式是：尽量在短时间内完成所有分页请求，避免期间有外部编辑操作。

• 分页token使用错误
  确保每次请求的pageToken严格使用上一次响应返回的nextPageToken，不能重复使用旧token或自行构造。API的pageToken是和当前列表状态、分页位置绑定的，错误的token会导致请求到重复的页面内容。

• 客户端未做去重处理
  即使API返回重复内容，也可以在客户端层面处理：

  1. 如果要排除用户主动添加的重复视频，用contentDetails.videoId作为唯一键，将收集到的条目存入集合（比如Python的set，或者用字典以videoId为键）。
  2. 如果要保留所有PlaylistItem（包括用户重复添加的），用每个条目的id作为唯一键，避免重复存储同一PlaylistItem。

额外注意 #

调用接口时，建议始终携带part=id,contentDetails，这样可以同时获取PlaylistItem的唯一ID和视频ID，方便区分是真重复还是用户主动添加的重复视频。

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