YouTube Data API 视频更新报错：添加标题描述本地化翻译时提示请求元数据无效

问题本质 #

invalidVideoMetadata类型400错误的触发，和传入的本地化文本内容完全无关——你已经用纯测试字符串复现了报错，也排除了非法字符问题，说明问题出在Videos.Update接口的全量校验规则上。
之所以会出现部分视频正常、部分视频持续报错的差异，是因为不同视频的元数据锁定状态、现有配置不同，不会统一触发校验失败。

核心触发原因 #

• 冗余的part参数触发字段校验失败
  你当前调用接口时传入的part参数是localizations, snippet, status。YouTube的Videos.Update接口遵循严格规则：只要part参数里声明了某类字段，就必须在请求体中完整携带该字段下所有当前合法的属性值，否则会被判定为你要清空这些属性。
  其中status类下的大部分属性是平台锁定的不可修改值：比如部分视频设置了年龄限制、嵌入权限锁定、广告匹配规则锁定，这类字段不支持通过接口修改。如果part参数带了status，但请求体里没有携带这些锁定字段的正确当前值，就会直接被判定为元数据非法。
  无特殊锁定status字段的视频不会触发这个校验，所以能正常更新；有锁定字段的视频就会持续报错。
• 请求体丢失现有本地化条目
  如果拉取待更新视频对象时，没有完整拿到视频当前已存在的所有本地化翻译条目（比如之前通过YouTube后台手动添加过其他语言的翻译），只在代码里新增了英语（en）的本地化条目，提交时API会校验发现你提供的localizations集合不完整，直接拒绝请求。
• 视频本身状态不支持本地化更新
  三类特殊状态的视频是完全不支持通过接口写入本地化内容的：实时直播的流视频、存在版权争议的受限视频、刚上传还未完成转码的草稿视频。这类视频无论提交什么内容，都会触发invalidVideoMetadata错误。

修复操作步骤 #

1. 收缩part参数范围
   你只需要更新本地化内容，不需要修改原视频的snippet信息、也不需要修改status配置，直接把part参数改成仅包含localizations，避免触发冗余字段的全量校验：

   var my_update_request = youtubeService.Videos.Update(video, "localizations");
   

2. 拉取完整元数据后再修改
   给目标视频新增本地化条目前，必须先调用Videos.List接口把目标视频的现有数据完整拉取到video对象中，确保提交更新时不会丢失已经存在的其他本地化条目。拉取时指定part参数为snippet, localizations, status，拿到完整对象后，只往Localizations字典里新增英语的本地化内容，不要修改其他已拉取的字段值。
3. 单独校验报错视频的状态
   对持续报错的视频，先单独调用Videos.List接口拉取该视频的status字段，检查是否命中了三类特殊状态。如果命中，需要等视频状态恢复正常后再重试更新。

接口返回错误的对应关系 #

Google.Apis.Requests.RequestError
The request metadata is invalid.[400]
Location[body-other]
Reason[invalidVideoMetadata]
Domain[youtube.video]

返回的Location标记为body-other，说明错误不是来自请求体里的某个单独字段（比如本地化的标题、描述文本），而是来自请求体整体的元数据完整性校验，和上述提到的触发场景完全匹配。

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