Toplu işleme, birbirine bağlı olabilecek bir dizi işlemi, işlemlerin tamamlanmasını eşzamanlı olarak beklemeden birden fazla hizmete göndermenin bir yolunu sunar. Maksimum Performans kampanyaları oluşturmak ve yönetmek için toplu işlemden yararlanabilirsiniz.
Bu kılavuzda, toplu işlemle çalışırken Maksimum Performans kampanyalarına özgü ayrıntılar verilmektedir. Genel toplu işleme kılavuzu, toplu işleme hakkında genel bilgiler sağlar. İstekleri yapılandırma kılavuzu ise Maksimum Performans kampanyaları oluşturmak veya yönetmek için istek oluşturma hakkında ayrıntılı bilgiler içerir.
Toplu işleme kullanarak Maksimum Performans kampanyası oluşturmak için aşağıdaki adımları uygulayın:
Yeni bir toplu iş oluşturma
BatchJob kaynağı oluşturmak için genel toplu işleme iş oluşturma adımını uygulayın.
Değişiklik işlemlerinin listesini hazırlama
Maksimum Performans kampanyaları, ilgili birkaç kaynağın oluşturulması için işlemler gerektirir. Bu kaynaklar İstekleri yapılandırma kılavuzunda ayrıntılı olarak açıklanmıştır. Toplu işe dahil edilmesi gereken her kaynak için bir MutateOperation oluşturun.
CampaignOperation ve CampaignAssetOperation koşulları
Bir kampanya için marka kuralları etkinleştirildiğinde (marka kuralları bölümüne bakın) CampaignAsset kaynaklarını kullanarak marka varlıklarını kampanyaya bağlamanız gerekir. Ayrıca, toplu işte bu CampaignAsset
kaynaklarının oluşturulması, Campaign
kaynağının oluşturulmasından hemen sonra gerçekleşmelidir. CampaignAsset kaynakları, Campaign kaynağından hemen sonra oluşturulmazsa (marka kuralları etkinleştirildiğinde, sorun giderme bölümüne bakın) istek başarısız olur ve eksik öğeleri belirten bir CampaignError döndürülür.
CampaignAsset oluşturma işlemlerinin daha sonra aynı işlem listesine eklenmesi bu hatayı önlemez.
AssetGroupOperation ve AssetGroupAssetOperation koşulları
Bir toplu iş içinde AssetGroup ve AssetGroupAsset kaynakları oluşturan MutateOperation türündeki işlemler, işlenirken gruplandırılma şekilleri nedeniyle aralarında başka işlemler olmadan sıralı olmalıdır. Aksi takdirde,
AssetGroupError isteği, bazı öğelerin
eksik olduğunu belirtir.
Bu durum,
minimum öğe koşullarını karşılamak için gereken işlemler daha sonra
işlem listesine dahil edilse bile geçerlidir.
AssetGroupListingGroupFilterOperation en iyi uygulamalar
AssetGroupListingGroupFilter bağlamında listeleme grubu filtreleriyle çalışırken aynı AssetGroup'i hedefleyen AssetGroupListingGroupFilterOperation işlemlerini toplu işe art arda eklemenizi öneririz. Böylece işlem grubu, toplu iş bölme sırasında atomik olarak ele alınır. Toplu bölme ve listeleme gruplarını etkileyen diğer faktörler hakkında daha fazla bilgi edinmek için listeleme grubu toplu işleme kılavuzunu inceleyin.
Değiştirme işlemlerini işe ekleyin.
2. adımda oluşturulan mutasyon işlemlerini bir listeye ekleyin ve 1. adımda oluşturulan toplu işe mutasyon listesini eklemek için AddBatchJobOperations yöntemini çağırın.
Değişiklik işlemleri listesini eklemek için genel toplu işleme kılavuzundaki işlem ekleme adımını uygulayın.
Toplu işi çalıştırma
RunBatchJob yöntemini çağırarak yüklenen işlerin çalışmaya başlamasına izin verin. Örnek için genel toplu işleme kılavuzundaki Toplu işi çalıştırma adımına bakın.
İşin durumunu alma
Toplu işler, uzun süren işlemler olarak başlar ve genellikle tamamlanması zaman alır.
İşi başlattıktan sonra, uzun süren işlemin GetOperation yöntemini kullanarak iş tamamlanana kadar işin durumunu düzenli olarak kontrol edin.
Tüm toplu işleriniz tamamlandığında, genel toplu işleme kılavuzundaki tüm toplu iş sonuçlarını listeleme adımını uygulayarak durumlarını ve yanıtlarını yazdırmak için ListBatchJobResults yöntemini çağırın.