Maksimum Performans için toplu işleme

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şlem kılavuzu, toplu işlem 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ç kaynak oluşturmak 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 şartları

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, bir toplu işteki 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 şartları

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, minimum öğe koşullarını karşılamak için gereken işlemler daha sonra işlem listesine dahil edilse bile istek, AssetGroupError hatası vererek bazı öğelerin eksik olduğunu belirtir.

AssetGroupListingGroupFilterOperation en iyi uygulama

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, toplu iş bölme sırasında işlem grubu 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şiklik işlemlerini işe ekleme

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üreli işlemler olarak başlar ve genellikle tamamlanması zaman alır. İşi başlattıktan sonra, uzun süreli işlemin GetOperation yöntemini kullanarak iş tamamlanana kadar işin durumunu sorgulayın.

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.