Çoğu hizmet eşzamanlı API'ler sunar ancak istekte bulunmanızı ve ardından yanıt beklemenizi gerektirir. BatchJobService ise işlemlerin tamamlanmasını beklemeden birden fazla hizmet üzerinde toplu işlem gerçekleştirme yolu sunar.
Hizmete özgü değiştirme işlemlerinden farklı olarak, BatchJobService'teki tek bir iş kampanya, reklam grubu, reklam, ölçüt, etiket 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ız kapsamında saymaya devam eder.
Ayrıca BatchJobService, istekleriniz içinde geçici kimlikler kullanmanıza olanak tanıyarak bağımlı işlemleri tek bir işte gönderebilmenizi sağlar.
İşlemler
BatchJobService, birkaç önemli istisna dışında MutateOperation içinde listelenen tüm işlemleri destekler.
Google Ads API, bir işteki tüm işlemleri kısmi hata etkinken 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 çekilmez.
MutateOperation içindeki aşağıdaki işlemler atomik olmalıdır. Bu nedenle, kısmi hataları desteklemez ve toplu işler içinde desteklenmez. Bunları işlerinize eklemekten kaçının, isteklerinizde partial_failure değerini false olarak ayarlayın ve bunun yerine GoogleAdsService içindeki mutate yöntemini kullanın.
BatchJobService'te desteklenmeyen işlemler
AssetGroupOperationCampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation