Pemrosesan batch menyediakan cara untuk mengirimkan 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 batch processing. Panduan pemrosesan batch umum memberikan informasi umum tentang pemrosesan batch, dan panduan Struktur permintaan berisi informasi mendetail tentang cara membuat 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 ubah
Kampanye Performa Maksimal memerlukan operasi untuk membuat beberapa resource terkait, yang dijelaskan dalam
panduan Struktur permintaan. Buat a
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 CampaignAsset
resource. Selain itu, dalam tugas batch, pembuatan CampaignAsset
resource ini harus segera dilakukan setelah pembuatan Campaign
resource itu sendiri. Jika resource CampaignAsset tidak segera dibuat
setelah resource Campaign (saat pedoman merek diaktifkan - lihat
pemecahan masalah),
permintaan akan gagal dan menampilkan CampaignError yang menunjukkan aset tidak ada.
Menyertakan operasi pembuatan CampaignAsset nanti dalam daftar operasi yang sama tidak akan mencegah error ini.
Persyaratan AssetGroupOperation dan AssetGroupAssetOperation
Operasi berjenis MutateOperation yang
membuat AssetGroup dan
AssetGroupAsset resource dalam tugas batch harus
berurutan tanpa operasi lain di antaranya karena cara operasi ini dikelompokkan saat diproses. Jika tidak, permintaan akan menampilkan
AssetGroupError yang menunjukkan bahwa beberapa aset tidak ada,
meskipun operasi yang diperlukan untuk
memenuhi persyaratan aset minimum disertakan nanti
dalam daftar operasi.
Praktik terbaik AssetGroupListingGroupFilterOperation
Saat menggunakan filter kelompok listingan dalam konteks
AssetGroupListingGroupFilter, sebaiknya
tambahkan
AssetGroupListingGroupFilterOperation
operasi yang menargetkan AssetGroup yang sama ke
tugas batch secara berurutan, sehingga kumpulan operasi diperlakukan secara atomik
selama pemisahan batch. Untuk membaca lebih lanjut tentang pemisahan batch dan faktor lain
yang memengaruhi grup listingan, lihat
panduan pemrosesan batch grup listingan.
Menambahkan operasi ubah ke tugas
Tambahkan operasi ubah dari Langkah 2 ke daftar dan panggil
AddBatchJobOperations
untuk menambahkan daftar perubahan ke tugas batch yang dibuat di Langkah 1.
Ikuti langkah menambahkan operasi
di panduan pemrosesan batch umum untuk menambahkan daftar operasi ubah.
Menjalankan tugas batch
Izinkan tugas yang diupload untuk mulai berjalan dengan memanggil
RunBatchJob. Lihat
Langkah menjalankan tugas batch
di panduan pemrosesan batch umum untuk mengetahui contohnya.
Mengambil status tugas
Tugas batch dimulai sebagai operasi yang berjalan lama dan biasanya memerlukan waktu untuk selesai.
Setelah memulai tugas, gunakan metode operasi yang berjalan lama
GetOperation
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 di
panduan batch processing umum.