使用YouTube Data API上传视频已设unlisted仍自动转私有问题咨询
按排查优先级从高到低定位即可,所有方案均适配你当前使用的依赖栈:
1. 补全API必填的合规声明字段(第一优先级排查点)
YouTube Data API从2023年起强制要求所有上传请求必须传入selfDeclaredMadeForKids字段完成儿童内容合规声明,缺失该字段时,服务端会静默忽略你传入的privacyStatus参数,直接把视频默认设为私有,不会抛出明确的错误提示。
在原有初始化VideoStatus的代码中补全对应赋值即可:
$videoStatus = new Google_Service_YouTube_VideoStatus(); $videoStatus->setPrivacyStatus('unlisted'); // 必加合规声明,缺失会导致隐私状态被覆盖 $videoStatus->setSelfDeclaredMadeForKids(false); $video->setStatus($videoStatus);
注意:只要元数据里存在合规相关字段缺失,服务端的状态覆盖优先级永远高于你传入的自定义值。
2. 修复旧版apiclient的multipart序列化bug
你当前使用的google/apiclient ^2.7版本,在使用uploadType=multipart上传时存在已知序列化问题:会丢失status字段的序列化内容,导致服务端收不到你传入的隐私状态参数,最终走默认私有逻辑。
调整composer.json的依赖版本到稳定无bug的区间:
"require": { "google/apiclient": "^2.15.0", "hybridauth/hybridauth": "~3.4.0", "guzzlehttp/guzzle": "^7.0" }
执行依赖更新:composer update google/apiclient
3. 校验OAuth授权的权限范围
如果是通过hybridauth流程获取的access token,要确认授权scope包含https://www.googleapis.com/auth/youtube.upload的完整写权限。如果仅获取了只读类的scope,服务端会完全忽略你传入的所有视频元数据,所有上传的视频都会自动标记为私有。
拿到token后可以通过简单调用做校验:请求YouTube的channels.list接口,传入part=status,contentDetails,如果返回结果中存在contentDetails.relatedPlaylists.uploads字段,说明上传权限完整;如果字段缺失,需要重新走授权流程补全写权限scope。
4. 增加上传后的状态兜底逻辑
你当前的代码仅在拿到视频ID后就直接返回,没有校验服务端实际返回的视频状态。可以在拿到video_id后补全兜底校验逻辑,一旦发现隐私状态被覆盖,直接主动发起状态更新:
// 原有拿到$video_id的逻辑后面追加 $videoCheck = $service->videos->listVideos('status', [ 'id' => $video_id ]); $currentStatus = $videoCheck->getItems()[0]->getStatus()->getPrivacyStatus(); if ($currentStatus !== 'unlisted') { $updateVideo = new Google_Service_YouTube_Video(); $updateVideo->setId($video_id); $updateStatus = new Google_Service_YouTube_VideoStatus(); $updateStatus->setPrivacyStatus('unlisted'); $updateStatus->setSelfDeclaredMadeForKids(false); $updateVideo->setStatus($updateStatus); // 主动覆盖更新状态 $service->videos->update('status', $updateVideo); }
常见非代码类误判
如果你的YouTube频道未完成手机号验证、未通过基础合规审核,所有上传的视频无论API传入什么隐私参数,都会被强制设为私有,这种情况直接去YouTube工作室完成账号验证流程即可,不需要修改代码。
内容的提问来源于stack exchange,提问作者JoeL

