01 / CAPABILITIES
开放功能
核心接口调用手册
3 个场景覆盖关键词搜索、视频资料与统计、频道资料三个公开读取场景。使用 API Key,不包含视频下载、任意字幕获取、上传或账号写入。
公开视频与频道检索
查询视频、频道、搜索结果及可返回的公开统计信息,用于内容索引或频道资料展示。
接入要求创建 Cloud 项目并启用 YouTube Data API;公共读取按端点使用 API Key,字段、可见性与方法配额分别核对。
按关键词搜索公开视频站内调用手册 · 参数、代码与排错→读取视频资料和公开统计站内调用手册 · 参数、代码与排错→按频道 Handle 读取资料站内调用手册 · 参数、代码与排错→视频上传与内容管理
代表授权用户上传视频并配置标题、描述及可见性等元数据,配合相应接口管理自己的频道内容。
接入要求上传需 youtube.upload 等受支持的用户授权范围;明确选择内容可见性,部分代理上传参数仅面向内容合作伙伴。
播放列表与评论互动
创建用户授权的播放列表,并回复已有评论,为频道内容工作流提供接口。
接入要求相应写接口需要用户 OAuth 授权和具体 scopes;回复现有评论与创建顶层评论是不同端点,不承诺所有视频都允许评论。
授权字幕轨道下载
下载有权限管理的视频字幕轨道,并按支持的格式或目标语言请求转换。
接入要求captions.download 要求用户有编辑该视频的权限及相应 OAuth 范围;不能据此下载任意公开视频的字幕或视频文件。
02 / REQUIREMENTS
接入条件
- 适用主体
- 内容工具开发者、频道运营者、公开视频数据工具开发者、获得用户授权的应用团队
- 接入方式
- 受支持的公开读取使用 Google Cloud 项目的 API Key / 用户或频道数据及写操作使用 OAuth 2.0 和所需 scopes / YouTube 内容合作伙伴的代理参数另需对应合作资格
- 申请概况
- Google 账号可创建项目;公开读取与频道写入分别使用 API Key 和 OAuth 授权。
- 拥有 Google 账号,创建 Google Cloud 项目并启用 YouTube Data API,取得目标请求所需凭证。
- 只读公开资源与频道写操作分别配置;需用户数据时实现 OAuth 2.0,并申请实际必要的授权范围。
- 在项目控制台核对具体方法及配额桶;公开分发应用还需按所用权限和当前流程核对相关验证要求。
- 向用户清楚说明数据用途、隐私政策和删除及撤销授权方式;用户应能决定上传与修改内容的实际动作。
03 / GET STARTED
开通步骤
- 01
建立项目与启用 API
在 Google Cloud 控制台建立项目,确认 YouTube Data API 已启用。
- 02
选择读取或用户授权
公开读取使用适用的 API Key;频道操作配置 OAuth 客户端、回调和所需 scopes。
- 03
完成小范围验证
先查询少量公开资源并检查配额消耗;写操作使用自己控制的专用频道,并主动选择内容可见性。
- 04
核对分发与扩额
检查当前项目配额、用户授权与开发者政策;需要更多配额时走官方申请和合规审计流程。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况YouTube Data API 使用配额单位和方法调用桶管理用量,配额单位不是货币价格。
- 核对日官方概览列出默认每日 100 次 search.list、100 次 videos.insert,其他端点合计每日 10,000 配额单位;这些是可变的默认分配,并非每个用户各享一份。
- 普通列表读取通常消耗 1 单位,部分写操作通常消耗 50 单位;搜索、上传及字幕等方法应查看自己的当前配额桶与成本表,不能套用统一每请求成本。
- 超过默认分配的扩额需提交官方申请并接受适用的合规审计;本次资料未列统一按次货币单价,不将配额换算成收费金额。
- 程序服务器、存储和同时使用的其他 Google Cloud 或第三方产品可能单独产生费用,应与 Data API 配额分开预算。
使用范围与限制
- API Key 不等于频道所有者授权,不能访问任意账号的私有资源或代表他人上传、评论。
- 本条目介绍 Data API;频道经营分析、广告、播放器等产品有各自接口和授权要求。
- 字幕下载需要视频编辑权限;公开视频可播放不代表字幕和视频文件可通过该接口任意下载。
- 上传、评论、删除和可见性修改会影响真实频道内容;应尊重用户明确选择。
- API 数据的保存、刷新、展示及删除受开发者政策约束,不能作为无限期复制内容的许可。
- 方法配额和项目控制台可能调整,不应通过拆分项目或其他方式规避分配限制。
如何进行开发测试
- 可以建立独立开发项目并使用自己控制的专用频道,先测试少量公开读取。
- 接口请求仍使用真实项目配额;上传、评论等写操作会产生真实内容。
- 本次未确认覆盖上述能力的通用免费隔离沙箱,测试项目不等于没有配额或内容副作用。
接入前再确认
- 具体项目的默认分配、方法配额和扩额状态需在 Cloud 控制台确认。
- 上传前由用户选择内容可见性,并核对当前频道设置与端点资格。
- 未创建项目、验证 OAuth、申请扩额或上传任何内容。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时,请以对应接口的最新规则为准。
- 01
- 02
- 03
- 04
- 05
- 06
- 07
- 08
- 09
官方文档核对,未进行接口实测
最近核验 2026-10-15 · 查看核验说明