Pemrosesan batch menyediakan cara untuk mengirim serangkaian operasi, yang mungkin saling bergantung, ke beberapa layanan tanpa menunggu operasi selesai secara sinkron. Anda dapat menggunakan pemrosesan batch untuk membuat dan mengelola kampanye Performa Maksimal.
Panduan ini memberikan detail khusus untuk kampanye Performa Maksimal saat menggunakan pemrosesan batch. Panduan pemrosesan batch umum memberikan informasi umum tentang pemrosesan batch, dan Panduan permintaan struktur berisi informasi mendetail tentang pembuatan permintaan untuk membuat atau mengelola kampanye Performa Maksimal.
Untuk membuat kampanye Performa Maksimal menggunakan pemrosesan batch, ikuti langkah-langkah berikut:
Membuat tugas batch baru
Ikuti langkah pembuatan tugas pemrosesan batch umum untuk membuat resource BatchJob.
Menyiapkan daftar operasi mutasi
Kampanye Performa Maksimal memerlukan operasi untuk membuat beberapa resource terkait, yang dijelaskan dalam Panduan permintaan struktur. Buat MutateOperation untuk setiap resource yang harus disertakan dalam tugas batch.
Persyaratan CampaignOperation dan CampaignAssetOperation
Jika pedoman merek diaktifkan untuk kampanye (lihat
pedoman merek), Anda harus menautkan
aset merek ke kampanye menggunakan resource
CampaignAsset. Selain itu, dalam tugas batch, pembuatan resource CampaignAsset
ini harus segera terjadi setelah pembuatan resource Campaign
itu sendiri. Jika resource CampaignAsset tidak langsung dibuat
setelah resource Campaign (saat panduan merek diaktifkan - lihat
pemecahan masalah),
permintaan akan gagal dan menampilkan CampaignError yang menunjukkan aset yang hilang.
Menyertakan operasi pembuatan CampaignAsset nanti dalam daftar operasi
yang sama tidak akan mencegah error ini.
Persyaratan AssetGroupOperation dan AssetGroupAssetOperation
Operasi jenis MutateOperation yang
membuat resource AssetGroup dan
AssetGroupAsset dalam tugas batch harus
berurutan tanpa operasi lain di antaranya karena cara operasi
ini dikelompokkan bersama saat diproses. Jika tidak, permintaan akan menampilkan
AssetGroupError yang menunjukkan beberapa aset tidak ada,
meskipun operasi yang diperlukan untuk
memenuhi persyaratan aset minimum disertakan nanti
dalam daftar operasi.
Praktik terbaik AssetGroupListingGroupFilterOperation
Saat menggunakan filter grup listingan dalam konteks
AssetGroupListingGroupFilter, sebaiknya
tambahkan operasi
AssetGroupListingGroupFilterOperation
yang menargetkan AssetGroup yang sama ke
tugas batch secara berurutan, sehingga kumpulan operasi diperlakukan secara atomik
selama pemisahan batch. Untuk membaca selengkapnya tentang pemisahan batch dan faktor lain
yang memengaruhi grup listingan, lihat
panduan pemrosesan batch grup listingan.
Menambahkan operasi mutasi ke tugas
Tambahkan operasi mutasi dari Langkah 2 ke daftar dan panggil
AddBatchJobOperations
untuk menambahkan daftar mutasi ke tugas batch yang dibuat di Langkah 1.
Ikuti langkah menambahkan operasi
dalam panduan pemrosesan batch umum untuk menambahkan daftar operasi mutasi.
Menjalankan tugas batch
Izinkan tugas yang diupload untuk mulai berjalan dengan memanggil
RunBatchJob. Lihat langkah Menjalankan tugas batch dalam panduan pemrosesan batch umum untuk mengetahui contohnya.
Mengambil status tugas
Tugas batch dimulai sebagai operasi yang berjalan lama dan biasanya memerlukan waktu untuk diselesaikan.
Setelah memulai tugas, gunakan metode GetOperation operasi yang berjalan lama untuk melakukan polling status tugas hingga selesai.
Setelah semua tugas batch selesai, panggil
ListBatchJobResults untuk
mencetak status dan responsnya dengan mengikuti
langkah mencantumkan semua hasil tugas batch dalam
panduan pemrosesan batch umum.