YouTube API 集成 — 连接您的频道分析 |管分析公司
通过 Google OAuth 连接一次，即可获取每日同步分析 - CPM、RPM、观众保留率和观看速度 - 无需导出 CSV 或单独访问 YouTube Studio。
What is YouTube API 集成 and when should you use it?
通过 Google OAuth 连接一次，即可获取每日同步分析 - CPM、RPM、观众保留率和观看速度 - 无需导出 CSV 或单独访问 YouTube Studio。
What is YouTube API 集成?
YouTube API 集成是 TubeAnalytics 的主要数据连接，通过 Google OAuth 2.0 身份验证将创作者的 YouTube 频道与平台关联起来。授权后，TubeAnalytics 会从 YouTube Analytics API 和 YouTube Data API v3（即为 YouTube Studio 提供支持的同一组经过身份验证的端点）读取数据，以导入视频效果指标、受众人口统计数据、获利数据和频道元数据。分析和元数据访问为只读。唯一的例外是评论管理：`youtube.force-ssl` 范围允许评论仪表板在创作者自己的视频上回复、审核、标记垃圾评论和删除评论。TubeAnalytics 无法上传或发布视频、编辑视频元数据、更改频道设置、删除视频，也无法访问超出创作者在 OAuth 同意屏幕上明确授权范围的任何非公开数据。分析范围将 TubeAnalytics 限制为创作者在 YouTube Studio 中已能看到的数据。数据同步每天运行。YouTube API 集成适用于所有计划，是 TubeAnalytics 所有其他功能和集成的基础。
Connection Details
Connection Type
OAuth
Sync Cadence
每日自动同步。首次连接时会按 API 允许的最长范围导入历史数据——通常 Starter 方案为 90 天，Professional 方案为 1 年，Enterprise 方案最长可达 5 年。
Authentication Method
Google OAuth 2.0，包含四个 YouTube 权限范围：youtube.readonly、yt-analytics.readonly 和 yt-analytics-monetary.readonly（只读），以及用于创作者自己视频的评论管理和字幕轨道读取的 youtube.force-ssl。创作者可随时在其 Google 帐号权限页面撤销授权。
Evidence and Validation
This integration summary is reviewed against product documentation and publicly available reference sources to keep integration guidance stable.
- Integration capability documentation is published across TubeAnalytics product pages.
- Connection models and data flow descriptions are documented in integration setup references.
- Compatible tool documentation is linked for validation of integration workflows.
What YouTube API 集成 includes
一键 OAuth 身份验证
通过 Google 的 OAuth 同意流程，在两分钟内即可连接您的 YouTube 频道。无需生成 API 密钥，无需复制令牌，无需开发人员设置。该连接适用于任何拥有 Google 帐户的 YouTube 频道。
每日自动数据同步
连接后，TubeAnalytics 每 24 小时自动提取一次新的分析数据。
完整历史数据导入
初次连接时，TubeAnalytics 会导入您频道的历史分析数据，追溯到 YouTube API 允许的范围内。入门计划导入 90 天，专业计划导入 1 年，企业导入长达 5 年的历史数据。
只读、安全访问
分析和元数据范围为只读。评论管理是唯一的写入功能：youtube.force-ssl 让您可以在仪表板中回复和审核自己视频上的评论。Google 使用同一范围保护其字幕端点，因此转录工具也借助它读取您自己视频的字幕轨道——仅读取，不会写回任何内容。TubeAnalytics 无法上传或发布视频、编辑视频元数据、更改频道设置或删除视频。您可以随时在 Google 帐户设置中撤消访问权限。
多格式数据导出
通过 YouTube API 提取的所有数据都可以导出为 CSV、PDF 或通过 TubeAnalytics API。将导出的数据与实时仪表板一起用于自定义报告、电子表格分析或存档目的。
自动错误恢复
如果 YouTube API 遇到中断，TubeAnalytics 会自动重试错过的同步。过期或被撤销的 OAuth 令牌无法重试——该频道的同步会停止，直到您重新授权连接。
How to set up YouTube API 集成
- 1
从 TubeAnalytics 启动连接
导航至 TubeAnalytics 仪表板中的“设置”>“频道”，然后单击“添加频道”。您将被重定向到 Google 的 OAuth 同意屏幕，您可以在其中选择与您的 YouTube 频道关联的 Google 帐户。
- 2
审核并批准 OAuth 权限
Google 会显示 TubeAnalytics 请求的权限。分析、收入和元数据范围为只读；youtube.force-ssl 允许对已连接频道进行评论管理和字幕轨道访问。选择“允许”之前，请检查同意屏幕。
- 3
TubeAnalytics 导入您的频道数据
授权后，TubeAnalytics 开始导入您频道的分析历史记录。初始同步会根据您的计划的历史数据限制来处理您的视频库、受众数据和收入指标。大多数频道在连接后 24 小时内完全同步。
- 4
每日同步使您的数据保持最新
TubeAnalytics 运行每日同步，更新所有指标（观看次数、观看时间、订阅者数量、CPM、RPM 和参与度数据），因此您的仪表板始终反映最新的可用 YouTube Analytics 数据，无需任何手动操作。
- 5
管理和监控您的连接
从“设置”>“频道”，您可以手动触发同步。随时断开连接以停止数据收集。
- < 2 minutes
- 通过 OAuth 连接您的 YouTube 频道 — 无需开发人员设置
- Daily
- 自动同步节奏
- 限定范围的 OAuth 访问
- OAuth 范围 — 分析和元数据为只读；youtube.force-ssl 涵盖评论管理和转录字幕读取，均仅限于您自己的视频
TubeAnalytics platform data, 2025
TubeAnalytics feature specification, 2025
Google OAuth Scope Documentation, 2024
Who uses YouTube API 集成
独立创作者，8K 订阅者
Challenge: 每天多次手动登录 YouTube Studio 以检查发布后的视频性能。不断的上下文切换分散了内容制作的注意力，并在发布期间造成了不必要的压力。
Solution: 连接 YouTube API 集成后，所有性能数据（观看速度、点击率、平均观看时长和流量来源）在发布后几分钟内就会出现在 TubeAnalytics 仪表板中。创建者改为每天两次检查单个仪表板，而不是每小时多次检查 Studio，估计每周可节省 3 小时的集中制作时间。
多渠道代理，12个客户渠道
Challenge: 管理 12 个 YouTube 频道需要在 YouTube Studio 中的 12 个 Google 帐户之间进行切换，这一工作流程很容易出错，并且每周仅花费一整天的时间来收集数据和报告。
Solution: 该机构使用 OAuth 集成将所有 12 个客户端渠道连接到企业工作区下的 TubeAnalytics。所有渠道数据都可以在一个仪表板中使用，并具有统一的报告，完全消除了帐户切换。每周报告周期从 10 小时缩短至不到 2 小时。
数据驱动的创作者，4.5 万订阅者
Challenge: 希望使用 YouTube 数据构建自定义仪表板和自动警报，但缺乏直接使用 YouTube Analytics API 的技术专业知识。
Solution: YouTube API 集成自动处理所有 API 身份验证和数据获取。创建者通过 TubeAnalytics 的仪表板访问其完整的分析数据集并导出，无需编写单个 API 调用。当他们后来需要自定义集成时，TubeAnalytics API 提供了相同的数据，而无需直接 YouTube API 管理。
Frequently asked questions
- 什么是 TubeAnalytics YouTube API 集成？
- YouTube API 集成是通过 Google OAuth 2.0 将您的 YouTube 频道链接到 TubeAnalytics 的连接层。获得授权后，TubeAnalytics 会从 YouTube Analytics API 和 YouTube Data API v3（YouTube Studio 使用的经过身份验证的端点相同）提取数据，以使用视频性能、观众、收入和元数据填充您的仪表板。分析和元数据访问为只读；评论管理还会使用 youtube.force-ssl 范围，让您可以回复和审核自己视频上的评论。该集成按每日节奏自动同步。它是所有 TubeAnalytics 功能所需的基础连接，并且适用于每个计划。
- YouTube API 集成安全吗？
- 是的，以下是具体授予的权限。TubeAnalytics 通过 Google OAuth 2.0 请求四个 YouTube 范围：youtube.readonly 用于视频和频道元数据，yt-analytics.readonly 用于效果数据，yt-analytics-monetary.readonly 用于收入数据，youtube.force-ssl 用于评论管理器和转录工具。前三个为只读。youtube.force-ssl 是读写范围，用于两件事：在评论仪表板中回复、审核、标记垃圾评论和删除您自己视频上的评论，以及读取转录工具所依赖的字幕轨道——Google 使用 youtube.force-ssl 保护其字幕端点，因此仅靠 youtube.readonly 无法获取字幕。转录功能仅使用读取操作。评论是产品唯一会写入 YouTube 的地方——TubeAnalytics 无法上传或发布视频，无法编辑标题、说明、标签或缩略图，无法更改频道设置，也无法删除视频。您可以随时在 Google 帐户的“拥有帐户访问权限的第三方应用”页面查看和撤消访问权限。TubeAnalytics 还会对所有静态 OAuth 令牌进行加密，并根据 Google 的令牌到期时间表轮换这些令牌。
- 初始数据同步需要多长时间？
- 大多数频道的初始同步通常会在 24 小时内完成。在此期间，TubeAnalytics 会导入您的视频库元数据、分析历史记录、观众人口统计数据和收入数据，直至您的计划允许（90 天入门版、1 年专业版、5 年企业版）。同步在后台运行 - 您可以关闭浏览器并稍后返回以发现数据已准备好。初始导入后，每日增量同步只需几分钟即可处理新数据，因为它们仅提取自上次成功同步以来的更新。
- 如果我的 OAuth 令牌过期会怎样？
- Google OAuth 令牌会在设定的期限（通常为 6-12 个月，具体取决于令牌类型）后或在您更改 Google 帐户密码后过期。当令牌过期时，TubeAnalytics 会检测到同步失败，并停止同步该频道，直到您重新授权连接。
- 我可以将多个 YouTube 频道连接到一个 TubeAnalytics 帐户吗？
- 是的。 TubeAnalytics 支持单个账户下的多个通道连接。入门版计划支持 1 个通道，专业版支持最多 3 个通道，企业版支持最多 5 个通道。每个通道都有自己的 OAuth 授权流程，并在“设置”>“频道”中独立管理。专业版和企业版计划提供多渠道视图，让您可以在单个仪表板视图中查看所有连接渠道的汇总指标。
- YouTube API 集成提取哪些数据？
- 该集成可提取视频级分析（观看次数、观看时间、点击率、平均观看持续时间）、受众数据（人口统计、保留曲线、新观众与回访观众）、收入指标（每千次展示费用、每千次展示收入、广告类型效果、估计收入）、流量来源细分（浏览、搜索、建议、外部、通知）以及视频元数据（标题、描述、标签、发布日期、缩略图）。可用的确切数据集取决于 YouTube Analytics API 的数据保留和您的 TubeAnalytics 计划层级。所有数据都与您在 YouTube Studio 中看到的数据相符，因为两个平台都使用相同的 API 端点。
Try YouTube API 集成 free for 30 days
Payment info required. Available on all plans.