YouTube 渠道指南
连接 YouTube 频道、配置视频上传，并理解数据分析的新鲜度。
- 文档负责人:
- BlendDuck Documentation
- 最近复核:
BlendDuck 会把视频发布到已连接 Google 账号拥有的 YouTube 频道。没有初始化 YouTube 频道的 Google 账号无法完成连接。
连接 YouTube
- 登录拥有目标 YouTube 频道的 Google 账号。
- 打开控制台 → 渠道。
- 选择 YouTube → Connect。
- 批准频道读取和视频上传权限；请求分析权限时也一并批准。
- 核对返回的频道标题、自定义网址或频道 ID，以及头像。
- 安排公开内容前，先上传一条较短的私密或不公开测试视频。
如果 Google 让你选择账号，请选择真正拥有该频道的账号，而不是只能观看或评论 YouTube 的账号。
准备上传
YouTube 发布必须包含恰好一个视频。当前适配器不接受图片、纯文字、多个视频或 BlendDuck 线程。
| 字段 | 要求 |
|---|---|
| 视频类型 | 自动、Short 或标准视频；自动模式由 YouTube 判断符合条件的 Short。 |
| 标题 | 必填，1–100 字符。 |
| 描述 | 可选，最多 5,000 个 UTF-8 字节。 |
| 可见性 | 公开、私密或不公开。 |
| 面向儿童 | 按合规流程明确选择 Yes 或 No。 |
| 标签 | 可选的 YouTube 标签列表。 |
| 缩略图网址 | 可选；必须是 BlendDuck 能下载的公开远程图片网址。 |
BlendDuck 必须能够读取视频来源，而且来源需要返回内容类型和内容长度。存储中的 MP4、MOV、WebM 可以通过直接上传或 multipart 上传，默认上限为 4,000,000,000 字节；通过远程网址导入的视频仍使用有界代理路径，上限为 64 MiB。大文件只读取必要的字节范围进行检查，并以 32 MiB 分块续传到 YouTube，不会把完整视频载入 Worker 内存。标准视频和自动模式支持横屏与长视频，并执行 YouTube 的 12 小时硬上限；未启用长视频的账号仍受 YouTube 动态 15 分钟门槛限制。明确选择 Short 时，视频必须为方形或竖屏且不超过三分钟。排期内容仍依赖媒体时，不要删除文件或撤销访问权限。
安全发布
- 附加一个最终视频，并打开 YouTube 渠道定制。
- 选择自动、Short 或标准视频，然后填写清晰标题，并谨慎选择可见性。
- 设置受众声明和可选标签。
- 使用缩略图网址时，在无痕窗口打开，确认无需登录即可访问。
- 预览描述和链接。
- 首次连接时先以私密或不公开方式发布，在 YouTube 中检查结果后再使用公开可见性。
BlendDuck 使用可恢复的 YouTube 上传会话。成功后会返回视频 ID 和观看网址。上传仍在进行时不要创建重复内容，应先检查 History 和原生频道。
数据分析
YouTube Analytics 包括频道总量、粉丝历史，以及平台可提供的视频观看、点赞、评论、分享、观看时长、平均观看时长、完成百分比和订阅变化。在 YouTube 提供权威内容分类之前，BlendDuck 保持视频类型，不会仅凭时长推断 Short。
YouTube 报告可能延迟。跨渠道比较或导出报告时，日期范围应避开尚未稳定的最新时段。连接时显式授权评论权限后，BlendDuck 还支持在 Inbox 中读取和回复公开 YouTube 评论。
故障排查
| 现象 | 解决方法 |
|---|---|
| 连接提示没有 YouTube 频道 | 切换到拥有已初始化 YouTube 频道的 Google 账号。 |
| 编辑器要求媒体 | 附加恰好一个视频；不支持 YouTube 纯文字发布。 |
| 标题或可见性被拒绝 | 使用 1–100 字符标题，并选择公开、私密或不公开。 |
| 超过 15 分钟的视频被拒绝 | 为已连接的 YouTube 账号启用长视频，然后重新上传。 |
| 无法读取视频来源 | 确认上传已经完成、来源仍可访问，并返回有效内容类型和长度。 |
| 自定义缩略图失败 | 使用不需要 Cookie、登录或短期浏览器会话的公开图片网址。 |
| 分析数据不完整 | 等待平台处理，并确认连接时授予了分析权限。 |