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 selesai secara sinkron.
Tidak seperti operasi mutasi khusus layanan, satu tugas di BatchJobService dapat beroperasi terhadap kumpulan campuran kampanye, grup iklan, iklan, kriteria, label, dan elemen feed.
Tugas yang dikirim berjalan secara paralel, dan
BatchJobService akan otomatis mencoba kembali operasi
yang gagal karena error sementara seperti error batas kapasitas. Google Ads API tetap menghitung setiap operasi dalam batas operasi harian Anda dengan 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 dalam
MutateOperation, dengan beberapa pengecualian
penting.
Karena Google Ads API mengeksekusi semua operasi dalam tugas dengan kegagalan sebagian diaktifkan, jika tugas dibatalkan atau operasi individual gagal, operasi yang berhasil tidak akan di-roll back.
Operasi di MutateOperation berikut harus bersifat atomik, sehingga tidak mendukung kegagalan sebagian 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
AssetGroupOperationCampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation