Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Довідник API

Batch і Bulk

Виберіть 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.One Bulk робота ID і незмінний вхідний файл.
Відстеження трекуКожна робота фінішує самостійно; одна з ладу не описує цілу партію.Одна робота визначає результати прогресу. Заповнені результати запаковані, не що кожен відео досягається.
Збірний вихідЗахопити кожен завершений результат роботи і зберегти його вхід до ID картографування.Захопити проявляється і кожен компресований NDJSON частина. Приєднуйтеся до індексу і video_id, не замовляйте замовлення.
Резюме після перериванняПрочитати збережену роботу IDs перед розглядом нових подач.Перевірте збережений Bulk ID. Запустіть pauseReason і відновіть цю роботу, якщо випали.

Перевірити потужність і вартість до початку

Про насЩо робити обліковий запис для
BatchВаш план maxBatchSize обмежує запити на подачу. Розбити більші набори на менші групи та повагу продуктивності загину.
BulkДо 2 GiB за ID файл. Робота подається поступово в межах загального облікового запису; видаліть дублікати до завантаження.
КредитиЗаготівля не одна плоска зарядка. Запити, які використовують для вашого облікового запису; завантаження додаються за розмірами даних.
ДоступнийКлюч має дозволяти кожне запитане джерело. Перевірте ліміти активного облікового запису: пробний доступ не надає повної місткості.