YouTube Data API更新视频描述后YT Studio不显示变更

• 核心原因1：接口传参不符合全量提交要求
  youtube.videos.update不是补丁式更新接口，属于全量覆盖更新接口，snippet节点不能只传入要修改的单个字段，必须携带该视频snippet下所有原有必填字段（包括categoryId、默认语言、标签、默认缩略图配置等），否则会触发后端的元数据分片同步逻辑：前台播放页读的是分片后的最新字段，YT Studio读的是全量校验通过的完整元数据，缺字段时全量校验不通过，就不会拉取最新的描述内容。改标题能同步是因为标题字段属于高优先级同步字段，单独传也会触发全量缓存刷新，描述属于低优先级字段，不会触发单独刷新。
  修正方式：更新前先调用videos.list接口拉取对应视频的完整snippet、status配置，在原有完整配置基础上覆盖要修改的description字段，再提交更新。
• 核心原因2：YT Studio缓存隔离
  YT Studio和用户侧播放页用的是两套独立的缓存集群，元数据同步延迟最高可达72小时，本地浏览器缓存也会导致看不到更新。验证时不要直接刷新页面，先退出谷歌账号重登，或者开无痕窗口访问YT Studio查看视频详情，排除本地缓存干扰。如果接口返回的最新数据已经是修改后的描述，不需要重复提交更新，重复请求只会触发接口限流，等缓存自动过期即可。
• 核心原因3：SDK版本bug
  100.0.0以上版本的googleapis NPM包存在序列化bug，会自动过滤长度超过5000字符的文本字段，提交时会把长描述截断甚至直接丢弃。可以先在发起请求前打印完整的requestBody，确认description字段完整携带，如果存在截断问题，把SDK版本降到95.0.0稳定版即可。

修正后的参考调用代码：

async publish(id, snippetUpdate) {
    const auth = this._utilService.getOAuthClient();
    // 拉取视频现有全量配置
    const videoRes = await youtube.videos.list({
        auth,
        part: ['snippet', 'status'],
        id: [id]
    });
    const targetVideo = videoRes.data.items?.[0];
    if (!targetVideo) {
        throw new Error('指定视频ID不存在');
    }
    // 合并更新字段，保留原有必填配置
    const mergedSnippet = {
        ...targetVideo.snippet,
        ...snippetUpdate
    };

    const updateParams = {
        auth,
        part: ['snippet', 'status'],
        requestBody: {
            id,
            snippet: mergedSnippet,
            status: targetVideo.status
        }
    };

    return youtube.videos.update(updateParams);
}

提交更新后可以立刻调用一次videos.list拉取最新视频数据校验，如果接口返回的description已经是修改后的值，就说明更新请求已经被服务端正常接收，剩下的只是后台缓存同步问题，不需要额外操作。

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