Pemrosesan batch menyediakan cara untuk mengirimkan serangkaian operasi, yang dapat 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 Anda menggunakan batch processing. Panduan pemrosesan batch generik memberikan informasi umum tentang pemrosesan batch, dan Panduan menyusun 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 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 Performa Maksimal
Campaign (brand_guidelines_enabled
ditetapkan secara default ke true kecuali jika Anda menetapkannya ke false atau membuat kampanye
sasaran perjalanan), Anda harus menautkan aset Asset merek ke kampanye menggunakan
aset CampaignAsset.
Kampanye Performa Maksimal Jasa dan Servis tidak mendukung
pedoman merek dan menghilangkan referensi CampaignAsset merek
(tetapkan brand_guidelines_enabled ke false saat
membuat kampanye). Kampanye Performa Maksimal Retail (dengan feed Merchant
Center) dapat menghilangkan resource CampaignAsset merek dalam
sub-batch atomik yang sama hanya jika Anda membuat kampanye tanpa aset tanpa resource
AssetGroupAsset kustom (selain aset HTML5
MEDIA_BUNDLE) atau jika
brand_guidelines_enabled ditetapkan ke false.
Dalam tugas batch, buat resource CampaignAsset ini
segera setelah Anda membuat resource Campaign itu sendiri (hingga
total 1.000 operasi dalam sub-batch atomik).
Operasi Campaign create (resource_name) dan operasi CampaignAsset create (campaign) berturut-turut harus menentukan ID sementara negatif yang sama, dan setiap operasi create AssetOperation prasyarat harus ditempatkan sebelum pembuatan Campaign. 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
Saat Anda membuat resource AssetGroup dengan resource
Asset terkait menggunakan AssetGroupAsset untuk memenuhi
persyaratan aset minimum, objek
MutateOperation yang membuat resource AssetGroup dan
AssetGroupAsset dalam tugas batch harus berurutan tanpa operasi lain
di antaranya karena cara operasi ini dikelompokkan ke dalam
sub-batch atomik (total hingga 1.000 operasi
per sub-batch). Tentukan ID sementara negatif yang sama
dalam operasi AssetGroup create (resource_name) dan operasi
AssetGroupAsset create berturut-turut (asset_group), dan tempatkan operasi
AssetOperation create prasyarat sebelum
pembuatan AssetGroup. Jika tidak, permintaan akan gagal dengan
AssetGroupError yang menunjukkan bahwa beberapa aset
tidak ada, meskipun operasi yang diperlukan untuk
memenuhi persyaratan aset minimum disertakan nanti dalam
daftar operasi.
AssetGroupListingGroupFilterOperation praktik terbaik
Saat Anda membuat, memperbarui, atau menghapus resource AssetGroupListingGroupFilter, tambahkan semua operasi AssetGroupListingGroupFilterOperation yang menargetkan AssetGroup yang sama ke tugas batch secara berurutan sehingga operasi dikelompokkan ke dalam sub-batch atomik selama pemisahan batch. Untuk mengetahui detail 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
metode 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
Mulai jalankan operasi yang diupload dengan memanggil
metode RunBatchJob. Lihat langkah Menjalankan tugas batch
dalam panduan pemrosesan batch umum untuk mengetahui contohnya.
Melakukan polling status tugas dan mengambil hasil
Tugas batch berjalan sebagai operasi yang berjalan lama dan biasanya memerlukan waktu untuk diselesaikan. Setelah
memulai tugas, gunakan metode Operations.GetOperation
pada layanan google.longrunning.Operations (atau kueri
batch_job.status dengan GoogleAdsService) untuk
melakukan polling status tugas hingga selesai.
Setelah tugas batch selesai, panggil metode ListBatchJobResults untuk mengambil status dan respons untuk setiap operasi dalam tugas. Misalnya, lihat
Mencantumkan semua hasil tugas batch.