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şturma veya yönetme istekleri 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ı
Maksimum Performans için marka kuralları etkinleştirildiğinde
Campaign (brand_guidelines_enabled
false olarak ayarlamadığınız veya seyahat hedefleri kampanyası oluşturmadığınız sürece varsayılan olarak true olur), CampaignAsset kaynaklarını kullanarak marka Asset kaynaklarını kampanyaya bağlamanız gerekir.
Yerel Hizmetler Maksimum Performans kampanyaları, marka kurallarını desteklemez ve marka CampaignAsset kaynaklarını atlar (kampanyayı oluştururken brand_guidelines_enabled değerini false olarak ayarlayın). Perakende Maksimum Performans kampanyaları (Merchant Center feed'i olan), yalnızca özel AssetGroupAsset kaynakları (HTML5 MEDIA_BUNDLE öğeleri hariç) olmayan öğesiz bir kampanya oluşturduğunuzda veya brand_guidelines_enabled, false olarak ayarlandığında aynı atomik alt gruptaki marka CampaignAsset kaynaklarını atlayabilir.
Toplu işlerde, Campaign kaynağını oluşturduktan hemen sonra bu CampaignAsset kaynaklarını oluşturun (atomik alt grupta toplam 1.000 işleme kadar).
Campaign create işlemi (resource_name) ve ardışık CampaignAsset create işlemleri (campaign) aynı negatif geçici ID belirtmelidir ve tüm ön koşul AssetOperation create işlemleri, Campaign oluşturma işleminden önce yerleştirilmelidir. 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 hatası döndürür. CampaignAsset oluşturma işlemlerini aynı işlem listesine daha sonra eklemek bu hatayı önlemez.
AssetGroupOperation ve AssetGroupAssetOperation koşulları
Minimum öğe gereksinimlerini karşılamak için AssetGroupAsset kullanarak ilişkili Asset kaynaklarıyla AssetGroup kaynakları oluşturduğunuzda, toplu işteki AssetGroup ve AssetGroupAsset kaynaklarını oluşturan MutateOperation nesneleri,bu işlemlerin atomik alt gruplar (alt grup başına toplam 1.000 işleme kadar) halinde gruplandırılma şekli nedeniyle aralarında başka işlemler olmadan sıralı olmalıdır. AssetGroup create işleminde (resource_name) ve ardışık AssetGroupAsset create işlemlerinde (asset_group) aynı negatif geçici ID'yi belirtin ve ön koşul olan AssetOperation create işlemlerini AssetGroup oluşturma işleminden önce gerçekleştirin. Aksi takdirde, minimum öğe koşullarını karşılamak için gereken işlemler daha sonra işlem listesine dahil edilse bile istek, AssetGroupError ile başarısız olur ve bazı öğelerin eksik olduğunu belirtir.
AssetGroupListingGroupFilterOperation en iyi uygulama
AssetGroupListingGroupFilter kaynakları oluştururken, güncellerken veya kaldırırken aynı AssetGroup'i hedefleyen tüm AssetGroupListingGroupFilterOperation işlemlerini toplu işe art arda ekleyin. Böylece işlemler, toplu iş bölme sırasında atomik bir alt toplu iş halinde gruplandırılır. Toplu bölme ve listeleme gruplarını etkileyen diğer faktörler hakkında ayrıntılı bilgi 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 AddBatchJobOperations yöntemini çağırarak mutasyon listesini 1. adımda oluşturulan toplu işe ekleyin. 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şlemleri çalıştırmaya başlayın. Örnek için genel toplu işleme kılavuzundaki Toplu işi çalıştırma adımına bakın.
İş durumunu sorgulama ve sonuçları alma
Toplu işler, uzun süreli işlemler olarak çalıştırılır ve genellikle tamamlanması zaman alır. İşi başlattıktan sonra, iş tamamlanana kadar işin durumunu sorgulamak için google.longrunning.Operations hizmetinde Operations.GetOperation yöntemini kullanın (veya GoogleAdsService ile batch_job.status sorgulayın).
Toplu iş tamamlandığında, işteki her bir işlemin durumunu ve yanıtını almak için ListBatchJobResults yöntemini çağırın. Örnek için Tüm toplu iş sonuçlarını listeleme bölümüne bakın.