Batch processing menyediakan cara untuk mengirimkan sekumpulan 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 generik memberikan informasi umum tentang pemrosesan batch, dan Panduan menyusun permintaan berisi informasi mendetail tentang cara menyusun 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 referensi terkait, yang dijelaskan secara mendetail 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 dilakukan setelah pembuatan resource
Campaign itu sendiri. Jika resource CampaignAsset tidak dibuat segera
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 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 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 listing 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 kelompok listingan, lihat panduan pemrosesan batch kelompok 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 memeriksa status tugas
hingga selesai.
Setelah semua tugas batch Anda selesai, panggil
ListBatchJobResults untuk
mencetak status dan responsnya mengikuti langkah
mencantumkan semua hasil tugas batch dalam
panduan pemrosesan batch umum.