Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Referensi API

Batch dan massal

Pilih Batch untuk query independen dengan masukan yang berbeda. Pilih Bulk untuk berkas video IDs yang semua membutuhkan operasi yang sama.

Di halaman ini

Pilih dengan pekerjaan yang perlu Anda lakukan

Pilihan tergantung pada bentuk input Anda, bukan jumlah item tetap. Kedua mode berjalan di latar belakang. Untuk satu pertanyaan, gunakan real time atau async secara langsung.

Tugas AndaPilih
Cari beberapa topik untuk pengarahan harianBatch: Setiap query memiliki istilah pencarian sendiri, lokasi atau bahasa.
Gabungan hasil Google dan metadata YouTube dalam sebuah pekerjaan penelitianBatch: Campur sumber dan mengumpulkan hasil terpisah untuk setiap query.
Segarkan metadata atau kumpulkan transkrip untuk katalog videoBulk: Satu video - ID file, satu sumber dan pilihan yang sama untuk setiap video.
Kirim daftar video ke ember dengan format yang samaBulk: Gunakan youtube_download dengan pengaturan media bersama dan penyimpanan tujuan.
Gunakan konfigurasi keluaran yang berbeda untuk setiap videoBatch: Parameter per- query dapat berbeda; Bulk memuat satu set ke seluruh berkas.

Batch: query independen

Kirim objek JSON berisi kueri. Setiap item memiliki sumber sendiri, masukan dan param. Gunakan Batch untuk pencarian Google, pencarian YouTube, sumber campuran, atau video yang membutuhkan pilihan berbeda.

Masukan Batch dua tugas berbeda
{
  "queries": [
    {
      "source": "google_search",
      "query": "open source speech recognition",
      "params": {
        "num": 5
      }
    },
    {
      "source": "youtube_metadata",
      "video_id": "dQw4w9WgXcQ",
      "params": {}
    }
  ]
}

Bulk: satu operasi melalui sebuah berkas

Unggah UTF-8 berkas dengan satu YouTube video ID per baris. Pilih satu sumber yang didukung dan satu set pilihan bagi seluruh berkas. Bulk memindai berkas, menyerahkan pekerjaan dalam kapasitas akun dan paket menghasilkan ke bagian yang dapat diunduh.

  1. Pilih metadata, transkrip, takarir, klasifikasi lisensi atau unduh. Bulk mengambil video IDs; gunakan Batch untuk pencarian kata kunci.
  2. Gunakan pekerjaan terpisah ketika sumber atau pilihan berubah. Misalnya, metadata dan transkrip untuk berkas yang sama adalah dua pekerjaan Bulk.
  3. Untuk diunduh, menyediakan penyimpanan tujuan dan akses pemilik dengan izin youtube_download. Baris hasil menjelaskan media yang disampaikan; berkas media disimpan dalam ember Anda.
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw

Rencana bagaimana Anda akan mengumpulkan hasil

Tanggung JawabBatchBulk
Simpan setelah penyerahanSetiap queries[].id, terkait dengan masukan aslinya. Tidak ada Batch pekerjaan tunggal ID.Satu Bulk tugas ID dan berkas masukan yang tidak berubah.
Melengkapi trekSetiap pekerjaan selesai secara independen; satu kegagalan tidak menggambarkan seluruh batch.Satu pekerjaan memperlihatkan progres negara. Selesai berarti hasil dikemas, bukan bahwa setiap video berhasil.
Mengumpulkan keluaranAmbil setiap hasil pekerjaan yang selesai dan pertahankan pemetaan input- ke - ID.Ambil manifes dan setiap terkompresi NDJSON bagian. Bergabung dengan indeks dan video_id, bukan baris order.
Lanjutkan setelah interupsiBaca pekerjaan yang disimpan IDs sebelum mempertimbangkan pengiriman baru.Periksa yang disimpan Bulk ID. Selesaikan pauseReason dan lanjutkan tugas itu jika diistirahatkan.

Periksa kapasitas dan biaya sebelum memulai

PeriksaApa yang harus dicatat
BatchRencanamu adalah maxBatchSize membatasi pencarian setiap penyerahan. Membagi set yang lebih besar ke dalam kelompok-kelompok yang lebih kecil dan menghormati kapasitas pekerjaan.
BulkSampai 2 GiB per berkas ID. Pekerjaan diajukan secara bertahap dalam kapasitas berbagi akun; hapus duplikat sebelum mengunggah.
KreditPengelompokan bukan satu muatan datar. Kueri menggunakan harga per-source; unduhan dimediasi oleh pengiriman ukuran data.
AksesKunci harus mengijinkan setiap sumber yang diminta. Periksa batas akun aktif; uji coba bukan akun kapasitas penuh.