浏览文档
API 参考
输入各不相同的独立查询使用 Batch;视频 ID 文件中的所有视频需要同一种操作时使用 Bulk。
本页内容
按任务选择
按输入形式选择,不按固定条数区分。两种模式都在后台运行。只有一项查询时,直接使用 Realtime 或 Async。
| 你的任务 | 选择 |
|---|---|
| 为每日简报搜索多个主题 | Batch: 每项查询有各自的搜索词、地区或语言。 |
| 在研究任务中组合 Google 结果与 YouTube 元数据 | Batch: 混合不同来源,分别获取每项查询的结果。 |
| 刷新视频目录元数据或收集转录文本 | Bulk: 一个视频 ID 文件、一个来源,所有视频共用相同选项。 |
| 将视频列表以相同格式交付到存储桶 | Bulk: 使用 youtube_download,共用媒体设置和目标存储。 |
| 为每个视频使用不同输出设置 | Batch: 各查询的参数可以不同;Bulk 对整个文件应用同一组选项。 |
Batch:独立查询
发送包含 queries 的 JSON 对象。每项拥有独立的 source、输入和 params。Google 搜索、YouTube 搜索、混合来源或需要不同选项的视频适合使用 Batch。
Batch 输入 · 两种不同任务
{
"queries": [
{
"source": "google_search",
"query": "open source speech recognition",
"params": {
"num": 5
}
},
{
"source": "youtube_metadata",
"video_id": "dQw4w9WgXcQ",
"params": {}
}
]
}Bulk:对文件执行同一种操作
上传 UTF-8 文件,每行一个 YouTube 视频 ID。为整个文件选择一个支持的来源与一组选项。Bulk 扫描文件,在账户容量内提交工作,再将结果打包成可下载分片。
- 选择元数据、转录文本、字幕、许可分类或下载。Bulk 接收视频 ID;关键词搜索使用 Batch。
- 来源或选项改变时使用单独的任务。例如,同一文件的元数据与转录文本需要两个 Bulk 任务。
- 下载需要目标存储及具有 youtube_download 权限的所有者访问。结果行描述已交付媒体,媒体文件存储在你的桶中。
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw规划如何收集结果
| 事项 | Batch | Bulk |
|---|---|---|
| 提交后保存 | 每项 queries[].id 及其原始输入,没有统一的 Batch 任务 ID。 | 一个 Bulk 任务 ID 与未改变的输入文件。 |
| 跟踪完成情况 | 每项任务独立完成;单项失败不代表整批失败。 | 一个任务提供进度计数。completed 表示结果已打包,不代表所有视频都成功。 |
| 收集输出 | 获取每项已完成任务的结果,保留输入与 ID 的对应关系。 | 获取清单及所有压缩 NDJSON 分片。按 index 与 video_id 匹配,不依赖行顺序。 |
| 中断后继续 | 考虑重新提交前,先读取已保存任务 ID。 | 检查已保存 Bulk ID;若暂停,处理 pauseReason 后恢复同一任务。 |
开始前检查容量与费用
| 检查项 | 需要考虑的内容 |
|---|---|
| Batch | 套餐 maxBatchSize 限制每次提交的查询数。将较大的集合拆成小组,并遵守等待任务容量。 |
| Bulk | 每个 ID 文件最大 2 GiB。任务在共用账户容量内逐步提交;上传前先去重。 |
| 额度 | 分组不代表统一计费一次。查询按来源定价;下载按交付数据量计费。 |
| 权限 | 密钥须允许访问每个请求来源。检查当前账户限制,试用并非完整容量账户。 |