Meskipun sebagian besar layanan menyediakan API sinkron, yang mengharuskan Anda membuat permintaan
lalu menunggu respons, BatchJobService
menyediakan cara untuk menjalankan batch operasi pada beberapa layanan tanpa
menunggu operasi secara sinkron.
Tidak seperti operasi mutasi khusus layanan, satu tugas di
BatchJobService dapat beroperasi terhadap gabungan
kumpulan kampanye, grup iklan, iklan, kriteria, label, dan elemen feed.
Tugas yang dikirim berjalan secara paralel, dan
BatchJobService otomatis mencoba kembali operasi
yang gagal karena error sementara seperti error batas kapasitas. Google Ads API tetap menghitung setiap operasi dalam batas operasi harian mengikuti petunjuk penghitungan operasi API.
Selain itu, BatchJobService 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 dibatalkan atau setiap operasi gagal, operasi yang berhasil tidak akan di-roll back.
Operasi berikut di MutateOperation harus bersifat atomik, sehingga tidak mendukung kegagalan parsial dan tidak didukung dalam tugas batch. Hindari menambahkannya ke tugas Anda, tetapkan
partial_failure ke false dalam permintaan Anda, dan gunakan metode mutate di
GoogleAdsService.
Operasi yang tidak didukung di BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation