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
kampanye, grup iklan, iklan, kriteria, label, dan item feed campuran.
Tugas yang dikirimkan berjalan secara paralel, dan
BatchJobService otomatis mencoba ulang
operasi yang gagal karena error sementara seperti error batas kapasitas. Google Ads API masih 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 dalam
MutateOperation, dengan beberapa
pengecualian penting.
Karena Google Ads API menjalankan semua operasi dalam tugas dengan kegagalan sebagian diaktifkan, jika tugas dibatalkan atau operasi individual 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 menambahkan operasi ini ke tugas Anda, tetapkan partial_failure ke false dalam permintaan Anda, dan gunakan metode mutate di GoogleAdsService.
Operasi yang tidak didukung di BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation