如何通过YouTube Data API v3检测视频不可用及确认状态？

1. 检测视频是否不可用的最佳方式 #

• 优先用YouTube Data API v3的videos.list接口：调用时指定目标视频ID，若返回的items数组为空，直接判定视频不可用（已删除、设为私密或当前权限无法访问）。
• 检查API错误状态：如果请求返回404、403等HTTP状态码，对应视频无法访问；若API能返回数据但页面打不开，需额外请求contentDetails字段，查看是否有regionRestriction（区域限制）、contentRating（年龄限制），或检查status.madeForKids是否为true——这类限制不会改变视频的privacyStatus，但会让特定用户/地区无法访问视频。
• 验证播放权限：调用videos.list时加入part=player，查看返回的player.embedHtml能否正常渲染，若渲染失败则说明视频无法公开播放。

2. 视频状态分析 #

从你提供的API返回数据看，privacyStatus标记为public但页面不可用，大概率是以下情况之一：

• 区域/年龄限制：视频可能被设置了仅特定地区可访问，或有年龄限制，这类限制不改变privacyStatus，但不符合条件的用户无法打开页面。你可以补充请求contentDetails字段，确认是否有相关配置。
• 平台政策下架：视频可能因违反社区准则、版权投诉被YouTube下架，但API状态还未同步更新。这种情况下，历史统计数据（比如点赞数）会被保留，这也能解释点赞数远超播放量的现象——点赞是视频正常公开时积累的，之后视频被限制访问，播放量停止增长，但旧的点赞数据未被清除。
• API状态延迟：极少数情况下，API会存在状态同步延迟，创作者刚修改了视频隐私设置（比如设为不公开/私密），但API还未更新到最新状态。

关于点赞数超过播放量：这种情况通常是视频曾经公开并积累了大量点赞，之后因限制/下架导致播放量不再增加，但历史点赞数据被保留；也可能是测试环境下的刷赞行为，但前者更常见。

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