Batch processing

Meskipun sebagian besar layanan menyediakan API sinkron yang mengharuskan Anda membuat permintaan lalu menunggu respons, BatchJobService menyediakan cara untuk melakukan batch operasi pada beberapa layanan tanpa menunggu operasi selesai secara sinkron.

Tidak seperti operasi perubahan khusus layanan, satu tugas di BatchJobService dapat beroperasi terhadap kumpulan campuran kampanye, grup iklan, iklan, kriteria, label, dan aset. Tugas yang dikirimkan berjalan secara paralel, dan BatchJobService otomatis mencoba ulang operasi yang gagal karena error sementara seperti error batas kapasitas. Google Ads API tetap menghitung setiap operasi terhadap batas operasi harian Anda, mengikuti petunjuk penghitungan operasi API.

BatchJobService juga memungkinkan Anda menggunakan ID sementara dalam permintaan sehingga Anda dapat mengirimkan operasi yang bergantung dalam satu tugas.

Operasi

BatchJobService mendukung semua operasi yang tercantum dalam MutateOperation yang layanan dasarnya mendukung kegagalan sebagian, serta AssetGroupOperation dan AssetGroupListingGroupFilterOperation, yang dikecualikan dan dieksekusi secara eksplisit (bersama dengan operasi yang saling bergantung terkait) dalam sub-batch atomik.

Karena Google Ads API menjalankan operasi standar dalam tugas dengan kegagalan parsial diaktifkan (kecuali dalam sub-batch atomik), jika tugas dibatalkan atau operasi individual gagal, operasi yang berhasil tidak di-roll back.

Operasi berikut di MutateOperation harus bersifat atomik dan tidak mendukung kegagalan sebagian, sehingga tidak didukung dalam tugas batch. Menambahkan salah satu operasi ini ke tugas batch akan menampilkan error MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE (atau InternalError.INTERNAL_ERROR untuk BookCampaignsOperation dan QuoteCampaignsOperation). Sebagai gantinya, jalankan operasi tersebut menggunakan GoogleAdsService.Mutate dengan partial_failure yang ditetapkan ke false (dan validate_only yang ditetapkan ke true untuk QuoteCampaignsOperation).

Operasi yang tidak didukung di BatchJobService

Berikutnya
Alur penggunaan