基于 YouTube Data API 的自动化视频上传工具,支持断点续传、元数据管理与 OAuth 2.0 安全认证,适合内容创作者批量发布。
说明:
## 核心功能
**youtube-publisher** 是一款面向 YouTube 内容创作者的命令行自动化工具,基于官方 YouTube Data API v3 构建,通过 OAuth 2.0 实现安全授权。核心能力覆盖视频上传全流程:支持大文件断点续传(10MB 分块)、自定义标题/描述/标签/分类、隐私状态控制(private/unlisted/public)、缩略图设置、播放列表管理及频道信息查询。
## 显著优点
– **官方 API 保障**:直接调用 Google 官方接口,非模拟浏览器操作,稳定性与兼容性佳
– **断点续传机制**:大视频上传中断可自动恢复,避免重复劳动
– **Token 自动刷新**:OAuth 2.0 凭证过期后自动续期,无需频繁手动授权
– **灵活的元数据控制**:支持完整视频 SEO 设置,包括分类 ID、标签体系和隐私策略
– **Agent 集成友好**:可通过自然语言指令触发,适合 AI 工作流嵌入
## 潜在局限
– **配额限制严格**:YouTube API 每日上传限额约 6 个视频,大规模批量发布受限
– **前置配置繁琐**:需手动完成 Google Cloud 项目创建、API 启用、OAuth 凭证下载等步骤
– **缩略图门槛**:自定义缩略图要求频道完成电话验证
– **测试模式限制**:未发布应用需手动添加测试用户
– **依赖 Google 生态**:全程需稳定访问 Google 服务,网络环境可能影响体验
## 适合人群
– 独立视频创作者、知识区 UP 主、技术教程博主
– 需要自动化内容分发的小型团队
– 已具备 Google Cloud 使用经验的开发者
– 追求”一键发布”工作流的效率型用户
## 常规风险
– **OAuth 凭证泄露**:`client_secret.json` 需妥善保管,避免提交至代码仓库
– **Token 文件安全**:`token.json` 包含长期访问凭证,建议限制文件权限
– **API 配额耗尽**:超限后将无法上传,需监控用量或申请配额提升
– **隐私误发布**:默认 private 设计合理,但误操作可能导致非预期公开
– **服务依赖风险**:YouTube API 政策变更可能影响功能可用性








