Batch processing menyediakan cara untuk mengirim sekumpulan operasi, yang mungkin saling bergantung, ke beberapa layanan tanpa menunggu operasi selesai secara sinkron. Anda dapat menggunakan batch processing untuk membuat dan mengelola kampanye Performa Maksimal.
Panduan ini memberikan detail khusus untuk kampanye Performa Maksimal saat menggunakan batch processing. Panduan batch processing umum memberikan informasi umum tentang batch processing, dan Panduan permintaan struktur berisi informasi mendetail tentang cara membuat permintaan untuk membuat atau mengelola kampanye Performa Maksimal.
Untuk membuat kampanye Performa Maksimal menggunakan batch processing, ikuti langkah-langkah berikut:
Membuat tugas batch baru
Ikuti langkah pembuatan tugas
batch processing umum untuk membuat
resource BatchJob.
Menyiapkan daftar operasi mutate
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 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 akan 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 tersebut 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 mutate ke tugas
Tambahkan operasi mutasi dari Langkah 2 ke daftar, lalu panggil
AddBatchJobOperations
untuk menambahkan daftar mutasi ke tugas batch yang dibuat di Langkah 1.
Ikuti langkah menambahkan operasi
dalam panduan batch processing 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 batch processing 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 batch processing umum.