Jelajahi dokumentasi
Referensi API
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 Anda | Pilih |
|---|---|
| Cari beberapa topik untuk pengarahan harian | Batch: Setiap query memiliki istilah pencarian sendiri, lokasi atau bahasa. |
| Gabungan hasil Google dan metadata YouTube dalam sebuah pekerjaan penelitian | Batch: Campur sumber dan mengumpulkan hasil terpisah untuk setiap query. |
| Segarkan metadata atau kumpulkan transkrip untuk katalog video | Bulk: Satu video - ID file, satu sumber dan pilihan yang sama untuk setiap video. |
| Kirim daftar video ke ember dengan format yang sama | Bulk: Gunakan youtube_download dengan pengaturan media bersama dan penyimpanan tujuan. |
| Gunakan konfigurasi keluaran yang berbeda untuk setiap video | Batch: 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.
{
"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.
- Pilih metadata, transkrip, takarir, klasifikasi lisensi atau unduh. Bulk mengambil video IDs; gunakan Batch untuk pencarian kata kunci.
- Gunakan pekerjaan terpisah ketika sumber atau pilihan berubah. Misalnya, metadata dan transkrip untuk berkas yang sama adalah dua pekerjaan Bulk.
- Untuk diunduh, menyediakan penyimpanan tujuan dan akses pemilik dengan izin youtube_download. Baris hasil menjelaskan media yang disampaikan; berkas media disimpan dalam ember Anda.
dQw4w9WgXcQ
jNQXAC9IVRwRencana bagaimana Anda akan mengumpulkan hasil
| Tanggung Jawab | Batch | Bulk |
|---|---|---|
| Simpan setelah penyerahan | Setiap queries[].id, terkait dengan masukan aslinya. Tidak ada Batch pekerjaan tunggal ID. | Satu Bulk tugas ID dan berkas masukan yang tidak berubah. |
| Melengkapi trek | Setiap 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 keluaran | Ambil 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 interupsi | Baca 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
| Periksa | Apa yang harus dicatat |
|---|---|
| Batch | Rencanamu adalah maxBatchSize membatasi pencarian setiap penyerahan. Membagi set yang lebih besar ke dalam kelompok-kelompok yang lebih kecil dan menghormati kapasitas pekerjaan. |
| Bulk | Sampai 2 GiB per berkas ID. Pekerjaan diajukan secara bertahap dalam kapasitas berbagi akun; hapus duplikat sebelum mengunggah. |
| Kredit | Pengelompokan bukan satu muatan datar. Kueri menggunakan harga per-source; unduhan dimediasi oleh pengiriman ukuran data. |
| Akses | Kunci harus mengijinkan setiap sumber yang diminta. Periksa batas akun aktif; uji coba bukan akun kapasitas penuh. |