用途:该技能封装 YouTube Data API v3,用于在用户提到 YouTube、youtube.com、youtu.be、视频链接、频道统计或视频相关问题时,检索视频与频道数据。
主要能力:搜索视频(支持关键词、类型、排序、发布时间等过滤);获取单个或多个视频的标题、播放量、点赞数、时长等详情;获取热门视频;按 ID、handle 或用户名查询频道及其订阅数、视频数;列出播放列表项、频道上传列表与频道播放列表;获取视频评论及按关键词搜索评论;查询视频分类并按分类搜索视频。
使用方式:基础地址为 https://youtube.googleapis.com/youtube/v3,所有请求使用 Authorization: Bearer $YOUTUBE_TOKEN。常用端点包括 search、videos、channels、playlistItems、playlists、commentThreads、videoCategories,通过 part 参数指定返回字段,如 snippet、statistics、contentDetails、status、player、brandingSettings。分页使用响应中的 nextPageToken 配合 pageToken 参数。视频 ID 可从 youtube.com/watch?v=VIDEO_ID 或 youtu.be/VIDEO_ID 提取。
限制与注意事项:API 每日配额为 10000 单位,搜索消耗 100 单位,多数其他请求消耗 1 单位;遇到 403/429 错误应实现指数退避;建议缓存响应以减少配额消耗;用户提供的查询值需进行 URL 编码,任意搜索文本可用 curl --get --data-urlencode。若请求失败,可运行 zero doctor check-connector --env-name YOUTUBE_TOKEN 或 zero doctor check-connector --url "https://youtube.googleapis.com/youtube/v3/videoCategories?part=snippet®ionCode=US" --method GET 排查连接。
适用场景:需要程序化获取 YouTube 视频、频道、播放列表、评论与分类数据的自动化任务或分析流程。
暂未提供:具体收费、价格、平台支持范围及效果保证等信息。