Перейти к содержимому
RU
Ключ API
Обзор документации

Справочник API

Batch и оптом

Выберите Batch для независимых запросов с различными входами. Выберите Bulk для файла видео IDs, который требует одинаковой работы.

На этой странице

Выберите работу, которую вам нужно сделать

Выбор зависит от формы вашего ввода, а не от фиксированного количества элементов. Оба режима работают в фоновом режиме. Для одного запроса используйте в режиме реального времени или асинхронизируйте напрямую.

Ваша задачаВыбрать
Поиск нескольких тем для ежедневного брифингаBatch: Каждый запрос имеет свои собственные поисковые термины, местоположение или язык.
Объедините результаты Google и метаданные YouTube в исследовательской работеBatch: Смешайте источники и соберите отдельный результат для каждого запроса.
Обновите метаданные или соберите транскрипты для видео каталогаBulk: Один файл видео-ID, один источник и одинаковые параметры для каждого видео.
Доставить список видео в ведро в том же форматеBulk: Используйте youtube_download с общими настройками мультимедиа и хранилищем назначения.
Используйте различные настройки вывода для каждого видеоBatch: Параметры запроса могут отличаться; Bulk применяет один набор ко всему файлу.

Batch: независимые запросы

Отправьте объект JSON, содержащий запросы. Каждый элемент имеет свой источник, ввод и парам. Используйте Batch для поиска Google, поиска YouTube, смешанных источников или видео, которые требуют разных опций.

Ввод 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 сканирует файл, отправляет работу в пределах емкости учетной записи и результаты пакетов в загружаемые части.

  1. Выберите метаданные, транскрипт, подписи, классификацию лицензий или загрузку. Bulk берет видео IDs; используйте Batch для поиска по ключевым словам.
  2. Используйте отдельное задание при изменении источника или опций. Например, метаданные и транскрипты для одного и того же файла представляют собой два задания Bulk.
  3. Для скачивания предоставьте хранилище назначения и доступ к владельцу с разрешением youtube_download. Результирующие строки описывают доставленные носители; медиафайлы хранятся в вашем ведре.
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw

Планируйте, как вы будете собирать результаты

ОтветственныйBatchBulk
Сохранить после подачиКаждый queries[].id связан с исходным входом. Не существует ни одной работы Batch ID.Один Bulk работает с ID и неизменным входным файлом.
Завершение трекаКаждая работа завершается самостоятельно; одна неудача не описывает всю партию.Одна работа показывает количество достигнутых результатов, а это означает, что результаты упакованы, а не то, что каждое видео получилось.
Собирать продукциюПолучите результат каждой выполненной работы и сохраните отображение ввода-вывода-ID.Возьмите манифест и каждую сжатую часть NDJSON. Присоединяйтесь по индексу и video_id, а не по порядку строк.
Резюме после перерываПрочитайте сохраненную работу IDs, прежде чем рассматривать новые предложения.Проверьте сохраненный Bulk ID. Разрешите pauseReason и возобновите работу, если остановитесь.

Проверить емкость и стоимость перед началом

ПроверитьЧто нужно учитывать
BatchmaxBatchSize вашего плана ограничивает количество запросов на отправку. Разделите большие наборы на более мелкие группы и уважайте возможности работы в ожидании.
BulkДо 2 GiB в файле ID. Работа подается постепенно в пределах общей емкости счета; удалите дубликаты перед загрузкой.
КредитыГруппировка - это не один фиксированный заряд. Запросы используют цену за источник; загрузки измеряются по доставляемому размеру данных.
ДоступКлюч должен быть доступен каждому запрашиваемому источнику. Проверьте лимиты активной учетной записи; пробная версия не является полнофункциональной учетной записью.