内容与社交 / YouTube Data API

YouTube 开发者 API

YouTube Data API 支持视频和频道检索、上传、播放列表及评论等内容操作。公开数据读取与代表频道用户的写入需要不同凭证;本条目聚焦 Data API,不把它等同于任意视频下载或所有频道分析数据的开放接口。

视频检索频道数据视频上传播放列表OAuth字幕
01 / CAPABILITIES

开放功能

核心接口调用手册

3 个场景

覆盖关键词搜索、视频资料与统计、频道资料三个公开读取场景。使用 API Key,不包含视频下载、任意字幕获取、上传或账号写入。

公开视频与频道检索

查询视频、频道、搜索结果及可返回的公开统计信息,用于内容索引或频道资料展示。

接入要求创建 Cloud 项目并启用 YouTube Data API;公共读取按端点使用 API Key,字段、可见性与方法配额分别核对。
按关键词搜索公开视频站内调用手册 · 参数、代码与排错读取视频资料和公开统计站内调用手册 · 参数、代码与排错按频道 Handle 读取资料站内调用手册 · 参数、代码与排错

授权字幕轨道下载

下载有权限管理的视频字幕轨道,并按支持的格式或目标语言请求转换。

接入要求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

开通步骤

  1. 01

    建立项目与启用 API

    在 Google Cloud 控制台建立项目,确认 YouTube Data API 已启用。

  2. 02

    选择读取或用户授权

    公开读取使用适用的 API Key;频道操作配置 OAuth 客户端、回调和所需 scopes。

  3. 03

    完成小范围验证

    先查询少量公开资源并检查配额消耗;写操作使用自己控制的专用频道,并主动选择内容可见性。

  4. 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

官方资料

以下资料用于核对本页内容。申请与使用时,请以对应接口的最新规则为准。

  1. 01
  2. 02
    Implementing OAuth 2.0 Authorization已核对官方资料 · 2026-10-15
  3. 03
  4. 04
  5. 05
    Comments: insert:回复已有评论已核对官方资料 · 2026-10-15
  6. 06
    Captions: download:视频编辑权限要求已核对官方资料 · 2026-10-15
  7. 07
    Quota and Compliance Audits已核对官方资料 · 2026-10-15
  8. 08
    YouTube API Services Developer Policies已核对官方资料 · 2026-10-15
  9. 09
    Cloud API 控制台,未登录核验项目官方入口 · 细则待复核 · 2026-10-15
官方文档核对,未进行接口实测
最近核验 2026-10-15 · 查看核验说明