跳转到主要内容
当你发布带有自定义 thumbNail 的 YouTube 视频时,视频可能已成功发布,但缩略图未能应用。此时帖子的顶层 status 会保持 "success"(视频已上线),但 YouTube 结果中会带有 warnings 数组,说明缩略图失败的原因:

症状

你的 YouTube 视频出现在频道上,但你提供的自定义缩略图缺失——YouTube 会改用自动生成的帧。API 响应返回 status: "success",并附带一个 thumbnail 的 warnings 条目(feature: "thumbnail"code: 307)。

最常见原因:频道未验证

YouTube 缩略图 403 失败的主要原因是频道未验证。YouTube 要求先完成频道(手机)验证才能接受自定义缩略图上传。

修复:验证你的频道

  1. 前往 https://www.youtube.com/verify,为该频道完成手机验证
  2. 或者,在 YouTube Studio 中进入 Settings → Channel,选择 Feature Eligibility,然后启用 Features that require phone verification
  3. YouTube 在完成验证后可能最多需要 24 小时才允许自定义缩略图。手机验证被”启用”并不保证 YouTube 会允许缩略图上传——最终由 YouTube 决定资格。
  4. 请确认你可以在 YouTube Studio 中手动上传缩略图。如果无法手动上传,API 也同样无法上传。

次要原因:OAuth 权限

如果你的频道已经验证,但缩略图仍以 403 失败,则已关联的 YouTube 账号可能缺少必要的权限。请尝试在 Social Accounts解除并重新关联你的 YouTube 账号,并在重新关联时授予所有请求的权限。 对于 Brand / Content Owner 账号(业务或组织频道常见),请确保已关联的账号拥有必要的权限——我们建议使用 “Owner” 权限。

发布前的缩略图要求

Ayrshare 会在可能的情况下于发布前对 thumbNail 进行校验。为避免 307 缩略图失败,请确保缩略图满足以下要求:
  • 格式: PNG 或 JPG/JPEG。文件扩展名必须为 pngjpgjpeg
  • 大小: 不超过 2MB。
  • 可访问的 URL: thumbNail URL 必须可公开访问,以便 Ayrshare 抓取。
缩略图问题永远不会导致帖子失败。如果缩略图明确无效(扩展名错误、确认超过 2MB 或无法访问),Ayrshare 会在视频上传前跳过该缩略图,仍会发布视频,并在 warnings 中说明原因。如果失败只能在视频上传后才能确定,视频仍会保持在线,失败信息通过上述 warnings 数组暴露。无论哪种情况,视频都会发布,status 始终保持 "success"

相关内容