# Batch dan massal

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

Referensi kanonikal: https://flashdata.dev/id/docs/reference/batch-and-bulk
Diulang: 2026-11-05 oleh FlashData

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

## 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. |

- [Realtime dan async](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#choose)

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

## 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

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

- [Jalankan permintaan Batch dan mengumpulkan hasilnya](https://flashdata.dev/id/docs/guides/async-batch/reference.md#batch)
- [Buat permintaan Batch untuk suatu sumber](https://flashdata.dev/id/docs/guides/async-batch/reference.md#customize)

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

## 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

```text
dQw4w9WgXcQ
jNQXAC9IVRw
```

- [Buka Bulk API taman bermain](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#playground)
- [Bulk daerah titik akhir dan permintaan](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#endpoints)
- [Mempersiapkan dan audit sebuah data video dengan CLI](https://flashdata.dev/id/docs/guides/bulk/reference.md)

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

## Rencana 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. |

- [Batch koleksi hasil](https://flashdata.dev/id/docs/guides/async-batch/reference.md#batch-results)
- [Bulk manifest dan bagian](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#downloadBulkJobManifest)
- [Simpan hasil sebelum kadaluwarsa](https://flashdata.dev/id/docs/guides/save-results/reference.md)

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

## 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. |

- [Batas akun](https://flashdata.dev/id/docs/guides/usage-and-limits/reference.md)
- [Kredit dan harga](https://flashdata.dev/id/docs/guides/credits-and-billing/reference.md)
