# Batch и оптом

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

Каноническая ссылка: https://flashdata.dev/ru/docs/reference/batch-and-bulk
Разработчик: 2026-11-05 by FlashData

<a id="choose"></a>

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

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

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

- [Realtime и асинхронизация](https://flashdata.dev/ru/docs/reference/realtime-and-async/reference.md#choose)

<a id="batch"></a>

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

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

### Ввод Batch · две разные задачи

```json
{
  "queries": [
    {
      "source": "google_search",
      "query": "open source speech recognition",
      "params": {
        "num": 5
      }
    },
    {
      "source": "youtube_metadata",
      "video_id": "dQw4w9WgXcQ",
      "params": {}
    }
  ]
}
```

- [Запустите запрос Batch и соберите его результаты](https://flashdata.dev/ru/docs/guides/async-batch/reference.md#batch)
- [Создайте запрос Batch для источника](https://flashdata.dev/ru/docs/guides/async-batch/reference.md#customize)

<a id="bulk"></a>

## Bulk: одна операция над файлом

Загрузите файл UTF-8 с одним видео YouTube ID в строку. Выберите один поддерживаемый источник и один набор опций для всего файла. Bulk сканирует файл, отправляет работу в пределах емкости учетной записи и результаты пакетов в загружаемые части.

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

### video-ids.txt

```text
dQw4w9WgXcQ
jNQXAC9IVRw
```

- [Скачать игру Bulk API](https://flashdata.dev/ru/docs/reference/bulk-processing/reference.md#playground)
- [Конечные точки Bulk и поля запросов](https://flashdata.dev/ru/docs/reference/bulk-processing/reference.md#endpoints)
- [Подготовка и аудит набора видеоданных с помощью CLI](https://flashdata.dev/ru/docs/guides/bulk/reference.md)

<a id="batch-results"></a>

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

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

- [Batch результат](https://flashdata.dev/ru/docs/guides/async-batch/reference.md#batch-results)
- [Bulk манифест и части](https://flashdata.dev/ru/docs/reference/bulk-processing/reference.md#downloadBulkJobManifest)
- [Сохранить результаты до истечения срока](https://flashdata.dev/ru/docs/guides/save-results/reference.md)

<a id="limits"></a>

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

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

- [Ограничения по счетам](https://flashdata.dev/ru/docs/guides/usage-and-limits/reference.md)
- [Кредиты и цены](https://flashdata.dev/ru/docs/guides/credits-and-billing/reference.md)
