You need to enable JavaScript to run this app. 使用YouTube Data API上传视频已设unlisted仍自动转私有问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.13 21:36:02