使用YouTube Data API v3上传视频：自动私有锁定问题求助

1. 明确设置上传请求的隐私状态参数 #

YouTube Data API默认会将未指定隐私状态的上传视频设为私有。你需要在上传请求的status字段中明确指定privacyStatus，可选值为public（公开）、unlisted（不公开列出）或private（私有）。未设置该参数时，视频会自动转为私有，部分场景下还会因权限或审核问题被锁定。

2. 验证API权限范围是否足够 #

上传并修改视频状态需要正确的OAuth权限范围：

• 基础上传需请求https://www.googleapis.com/auth/youtube.upload
• 若要上传后修改视频隐私状态，需额外添加https://www.googleapis.com/auth/youtube或https://www.googleapis.com/auth/youtube.force-ssl
  确保OAuth授权流程中请求了上述必要范围，权限不足会导致视频上传后无法修改状态，被锁定为私有。

3. 排查YouTube账号限制 #

如果你的账号存在以下情况，上传的视频可能被自动锁定为私有：

• 新注册账号：YouTube对新账号有初始上传限制，需完成手机号验证并等待账号“成熟”后才能公开上传视频
• 违规记录：账号曾违反社区规范、版权政策，导致上传权限受限，需前往YouTube Studio查看账号状态并处理违规警告

4. 检查视频元数据与内容合规性 #

视频的标题、描述、标签或内容若包含违规元素（如版权侵权内容、敏感词汇、违反社区规范的内容），YouTube的自动审核系统会将视频设为私有并锁定。请确保视频内容和元数据符合YouTube的社区规范与版权政策。

5. 上传后尝试通过API修改状态 #

如果视频已被锁定为私有，在权限足够的前提下，可调用videos.update接口修改隐私状态：

# 假设已获取授权后的youtube对象，video_id为上传后的视频ID
update_request = youtube.videos().update(
    part='status',
    body={
        'id': video_id,
        'status': {
            'privacyStatus': 'public'
        }
    }
)
response = update_request.execute()
print(f"视频状态已更新为: {response['status']['privacyStatus']}")

正确上传示例代码 #

以下是包含明确隐私状态设置的完整上传代码片段：

from googleapiclient.discovery import build
from googleapiclient.http import MediaFileUpload
from google.oauth2.credentials import Credentials

# 加载已保存的OAuth凭证（需提前完成授权流程）
credentials = Credentials.from_authorized_user_file('token.json')
youtube = build('youtube', 'v3', credentials=credentials)

# 构建视频请求体，明确设置隐私状态
request_body = {
    'snippet': {
        'title': '测试视频标题',
        'description': '测试视频描述',
        'tags': ['测试', 'YouTube API']
    },
    'status': {
        'privacyStatus': 'public',
        'selfDeclaredMadeForKids': False  # 根据实际视频内容设置，避免COPPA合规问题
    }
}

# 初始化媒体上传对象
media_file = MediaFileUpload('test_video.mp4', chunksize=-1, resumable=True)

# 创建上传请求
upload_request = youtube.videos().insert(
    part='snippet,status',
    body=request_body,
    media_body=media_file
)

# 执行断点续传
response = None
while response is None:
    status, response = upload_request.next_chunk()
    if status:
        print(f"上传进度: {int(status.progress() * 100)}%")

print(f"视频上传成功，ID: {response['id']}")

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