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 mutate khusus layanan, satu tugas di
BatchJobService dapat beroperasi terhadap koleksi campuran
kampanye, grup iklan, iklan, kriteria, label, dan item feed.
Tugas yang dikirimkan berjalan secara paralel, dan
BatchJobService otomatis mencoba ulang
operasi yang gagal karena error sementara seperti error batas frekuensi. 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 dependen dalam satu tugas.
Operasi
BatchJobService mendukung semua operasi yang tercantum di
MutateOperation, dengan beberapa
pengecualian penting.
Karena Google Ads API menjalankan semua operasi dalam tugas dengan kegagalan sebagian diaktifkan, jika tugas di batalkan atau operasi individual gagal, operasi yang berhasil tidak akan di-roll back.
Operasi berikut di MutateOperation harus bersifat
atomik, sehingga tidak mendukung kegagalan sebagian
dan tidak didukung dalam tugas batch. Hindari menambahkan operasi ini ke
tugas Anda, tetapkan partial_failure ke false dalam permintaan Anda, dan gunakan metode mutate
di GoogleAdsService sebagai gantinya.
Operasi yang tidak didukung di BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation