Обзор документации
Справочник API
Выберите Batch для независимых запросов с различными входами. Выберите Bulk для файла видео IDs, который требует одинаковой работы.
На этой странице
Выберите работу, которую вам нужно сделать
Выбор зависит от формы вашего ввода, а не от фиксированного количества элементов. Оба режима работают в фоновом режиме. Для одного запроса используйте в режиме реального времени или асинхронизируйте напрямую.
| Ваша задача | Выбрать |
|---|---|
| Поиск нескольких тем для ежедневного брифинга | Batch: Каждый запрос имеет свои собственные поисковые термины, местоположение или язык. |
| Объедините результаты Google и метаданные YouTube в исследовательской работе | Batch: Смешайте источники и соберите отдельный результат для каждого запроса. |
| Обновите метаданные или соберите транскрипты для видео каталога | Bulk: Один файл видео-ID, один источник и одинаковые параметры для каждого видео. |
| Доставить список видео в ведро в том же формате | Bulk: Используйте youtube_download с общими настройками мультимедиа и хранилищем назначения. |
| Используйте различные настройки вывода для каждого видео | Batch: Параметры запроса могут отличаться; Bulk применяет один набор ко всему файлу. |
Batch: независимые запросы
Отправьте объект JSON, содержащий запросы. Каждый элемент имеет свой источник, ввод и парам. Используйте Batch для поиска Google, поиска YouTube, смешанных источников или видео, которые требуют разных опций.
{
"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 берет видео IDs; используйте Batch для поиска по ключевым словам.
- Используйте отдельное задание при изменении источника или опций. Например, метаданные и транскрипты для одного и того же файла представляют собой два задания Bulk.
- Для скачивания предоставьте хранилище назначения и доступ к владельцу с разрешением youtube_download. Результирующие строки описывают доставленные носители; медиафайлы хранятся в вашем ведре.
dQw4w9WgXcQ
jNQXAC9IVRwПланируйте, как вы будете собирать результаты
| Ответственный | Batch | Bulk |
|---|---|---|
| Сохранить после подачи | Каждый queries[].id связан с исходным входом. Не существует ни одной работы Batch ID. | Один Bulk работает с ID и неизменным входным файлом. |
| Завершение трека | Каждая работа завершается самостоятельно; одна неудача не описывает всю партию. | Одна работа показывает количество достигнутых результатов, а это означает, что результаты упакованы, а не то, что каждое видео получилось. |
| Собирать продукцию | Получите результат каждой выполненной работы и сохраните отображение ввода-вывода-ID. | Возьмите манифест и каждую сжатую часть NDJSON. Присоединяйтесь по индексу и video_id, а не по порядку строк. |
| Резюме после перерыва | Прочитайте сохраненную работу IDs, прежде чем рассматривать новые предложения. | Проверьте сохраненный Bulk ID. Разрешите pauseReason и возобновите работу, если остановитесь. |
Проверить емкость и стоимость перед началом
| Проверить | Что нужно учитывать |
|---|---|
| Batch | maxBatchSize вашего плана ограничивает количество запросов на отправку. Разделите большие наборы на более мелкие группы и уважайте возможности работы в ожидании. |
| Bulk | До 2 GiB в файле ID. Работа подается постепенно в пределах общей емкости счета; удалите дубликаты перед загрузкой. |
| Кредиты | Группировка - это не один фиксированный заряд. Запросы используют цену за источник; загрузки измеряются по доставляемому размеру данных. |
| Доступ | Ключ должен быть доступен каждому запрашиваемому источнику. Проверьте лимиты активной учетной записи; пробная версия не является полнофункциональной учетной записью. |