YouTube API

通过 MyBrandMetrics Discovery API 搜索 YouTube 视频、获取 YouTube 视频元数据、查看频道信息、浏览播放列表、列出评论、检查直播动态、查询 YouTube Analytics 数据，以及管理 YouTube Reporting 任务。

当在 MyBrandMetrics 中完成 YouTube 账号连接后，如需访问 YouTube 内容或 YouTube 账号数据，请使用本技能。该技能统一接入 YouTube Data API v3、YouTube Analytics API v2 和 YouTube Reporting API v1，提供单一接口调用能力。

本技能面向 YouTube 数据获取、分析、报表生成及上传流程等场景，**不提供 YouTube 视频字幕（transcripts）功能**。

网站：https://www.clawbus.com/
MyBrandMetrics API：https://mybrandmetrics.com/

核心能力

配置流程

1. 打开 https://mybrandmetrics.com/ 并使用 Google 账号登录。
2. 在 MyBrandMetrics 中，进入 数据源（Data sources） 页面。
3. 将 YouTube 添加为数据源并完成连接。
4. 等待 MyBrandMetrics 的 YouTube 连接状态变为就绪。
5. 在 https://mybrandmetrics.com/ 中获取 MyBrandMetrics API 密钥。
6. 安装 clawbus-youtube-unified-api 技能。
7. 通过自然语言指令或直接调用 Discovery API，启动 YouTube 搜索、频道查询、播放列表处理、Analytics 查询、Reporting 任务或上传流程。

认证方式

Discovery API 请求需使用 MyBrandMetrics API 密钥进行认证。

export MYBRANDMETRICS_API_KEY="YOUR_API_KEY"
export MYBRANDMETRICS_API_BASE_URL="https://api.mybrandmetrics.com"

请求头中需携带密钥：

X-API-Key: YOUR_API_KEY

请勿将真实 API 密钥、账号会话值或 Google 访问令牌写入技能文件、示例代码、日志或聊天回复中。

Discovery 路由机制

使用格式：/discovery/{service}/{path}。

生成的示例中默认省略通用版本前缀（如 v3、v2 等）。

面向搜索优化的工作流

常见的 YouTube 工作流包括：

• 按关键词、频道、日期、地区或内容类型搜索 YouTube 视频；
• 获取 YouTube 视频的元数据、缩略图、统计数据、字幕（captions）及状态；
• 检查 YouTube 频道信息、播放列表、播放列表条目、评论及订阅关系；
• 浏览 YouTube 播放列表及频道上传内容；
• 列出 YouTube 视频或频道下的评论及讨论线程；
• 查询 YouTube Analytics 指标，例如播放量、观看时长和用户互动数据；
• 创建并检查 YouTube Reporting API 任务；
• 为已连接的 YouTube 频道准备视频上传请求。

账号选择

若 MyBrandMetrics API 密钥关联了多个 YouTube 账号，在发起请求前需明确指定本次操作所使用的账号。

当 MyBrandMetrics 返回账号选择响应时，仅展示非敏感的账号标识信息，例如显示名称（display name）、邮箱地址及连接 ID；随后需在 Discovery API 请求中包含所选账号标识符（例如 oauth_connection_id）。

请求示例

获取已连接频道的详细信息：

curl -H "X-API-Key: $MYBRANDMETRICS_API_KEY" 
  "${MYBRANDMETRICS_API_BASE_URL:-https://api.mybrandmetrics.com}/discovery/youtube/channels?part=snippet,contentDetails,statistics&mine=true"

查询 YouTube Analytics 数据：

curl -sS "${MYBRANDMETRICS_API_BASE_URL:-https://api.mybrandmetrics.com}/discovery/youtubeAnalytics/reports" 
  -H "X-API-Key: $MYBRANDMETRICS_API_KEY" 
  --url-query "ids=channel==MINE" 
  --url-query "startDate=2026-01-01" 
  --url-query "endDate=2026-01-31" 
  --url-query "metrics=views,estimatedMinutesWatched"

自然语言指令示例：

查找近期关于创作者数据分析的 YouTube 视频，并返回其标题、URL 和播放量。

获取我已连接的 YouTube 频道过去 30 天的 Analytics 数据。

列出我已连接的 YouTube 频道的所有播放列表，并展示每个播放列表的前 10 个条目。

参考文档

在执行上传、更新、删除或 Reporting 任务等高风险操作前，请确认已连接的 YouTube 账号、目标资源、请求参数及预期结果。