使用YouTube Data API创建直播时自定义缩略图设置不生效问题

核心根因 #

你在创建直播的请求snippet节点中传入的thumbnails结构，是YouTube Data API定义的只读响应字段，客户端在创建、更新直播资源时写入该节点的所有内容，都会被服务端直接忽略，完全不会被解析为自定义缩略图的配置项。

• 从API设计逻辑来看，响应结构里的thumbnails字段仅用于返回服务端自动生成、系统自动截取的直播缩略图元数据，本身不开放写入权限。
• YouTube不会主动跨域抓取你使用的图床地址中的图片作为直播缩略图，因此哪怕你填的URL完全公开可访问，也不会触发缩略图的替换流程——服务端没收到有效自定义缩略图指令，自然会使用直播流自动生成的默认缩略图展示。

正确的自定义缩略图配置步骤 #

• 第一步：先正常调用liveBroadcasts.create接口完成直播活动的创建，从接口返回的结果中提取该直播关联的videoId。每个直播活动本质对应一个独立的YouTube视频资源，自定义缩略图是绑定在这个视频资源上的属性。
• 第二步：单独调用thumbnails.set接口，采用multipart/form-data的请求格式，上传本地存储的图片二进制文件，请求路径中传入第一步获取到的videoId，即可完成自定义缩略图的绑定。
• 前置校验需要确认两点：一是你的YouTube账号已完成手机号验证、无未处理的社区违规记录，具备自定义缩略图的使用权限；二是待上传的图片符合平台规范，分辨率不低于1280×720、文件大小不超过2MB、格式为JPG/PNG/BMP，无违规内容。

避坑提醒 #

• 不要把缩略图配置嵌套在创建直播的snippet节点中传参，这个操作从API规则层面就不被支持，无论传入什么值都不会生效。
• 不要尝试通过传入外部公开URL的方式指定缩略图，YouTube无拉取外部图片做缩略图的机制，所有自定义缩略图都必须通过官方上传接口提交本地文件。

注意：直播创建时的请求体里完全不需要嵌套thumbnails结构，多余的无效参数只会被服务端静默丢弃，不会带来任何配置效果。

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