Çoğu hizmet eşzamanlı API'ler sağladığından, istekte bulunup ardından yanıt beklemenizi gerektirir. Ancak BatchJobService
, eşzamanlı olarak işlemlerin tamamlanmasını beklemeden birden çok hizmet üzerinde toplu işlem gerçekleştirme olanağı sunar.
Hizmete özel değişim işlemlerinin aksine BatchJobService
'teki tek bir iş; kampanyalar, reklam grupları, reklamlar, kriterler, etiketler ve feed öğelerinden oluşan karma bir koleksiyonda çalışabilir.
Gönderilen işler paralel olarak çalışır ve BatchJobService
, hız sınırı hataları gibi geçici hatalar nedeniyle başarısız olan işlemleri otomatik olarak yeniden dener. Google Ads API, API işlemlerini sayma talimatlarını uygulayarak her işlemi günlük işlem sınırınıza dahil eder.
Ayrıca BatchJobService
, isteklerinizde geçici kimlikler kullanmanıza olanak tanır. Böylece tek bir işte bağımlı işlemler gönderebilirsiniz.
İşlemler
BatchJobService
, birkaç önemli istisna dışında MutateOperation
sayfasında listelenen tüm işlemleri destekler.
Google Ads API, bir işteki tüm işlemleri kısmi hata etkin şekilde yürüttüğünden, bir iş iptal edilirse veya bağımsız işlemler başarısız olursa başarılı olan işlemler geri geri çekilmez.
MutateOperation
iş ortağında aşağıdaki işlemler atomik olmalıdır. Bu nedenle, kısmi hataları desteklemez ve toplu işlerde desteklenmez. Bunları işlerinize eklemekten kaçının, isteklerinizde partial_failure
değerini false
olarak ayarlayın ve bunun yerine GoogleAdsService
öğesinde mutate
yöntemini kullanın.
BatchjobService'te desteklenmeyen işlemler
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation