PHP实现将视频添加至YouTube播放列表失败排查求助

你的代码逻辑本身没问题，但出现无错误提示却未添加成功的情况，大概率是以下几个原因：

• 权限范围不足
  YouTube Data API的playlistItems.insert接口需要特定授权范围，确保初始化客户端时使用了https://www.googleapis.com/auth/youtube或https://www.googleapis.com/auth/youtube.force-ssl。如果用了只读类scope（比如https://www.googleapis.com/auth/youtube.readonly），API会静默拒绝写入操作，不会抛出异常。

• 视频或播放列表权限/有效性问题

  • 确认$videoId是有效的视频ID，且视频未设为私有、未被版权限制或已删除；
  • 检查目标播放列表（$playlistId）是否属于当前授权账号，且账号拥有该播放列表的编辑权限（比如播放列表是公开状态，或者你是播放列表所有者）。

• 客户端授权不完整
  若使用OAuth2授权，确保授权流程完整，用户已授予编辑权限；若使用服务账号，需先将服务账号关联到你的YouTube频道（服务账号默认无YouTube资源访问权限）。

• 未查看API实际响应内容
  返回的Guzzle响应并非无内容，你可以通过以下代码查看API的具体返回，排查隐藏问题：

  echo $response->getBody()->getContents();
  

  很多时候API会返回200状态码，但响应体里包含错误详情（比如权限提示、资源不存在等）。

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