Toplu işleme

Çoğu hizmet, istekte bulunmanızı ve ardından yanıt beklemenizi gerektiren eşzamanlı API'ler sağlarken BatchJobService, işlemlerin tamamlanmasını eşzamanlı olarak beklemeden birden fazla hizmette toplu işlem yapma olanağı sunar.

Hizmete özel mutasyon işlemlerinin aksine, BatchJobService içindeki tek bir iş; kampanyalar, reklam grupları, reklamlar, ölçütler, etiketler ve öğelerden oluşan karma bir koleksiyon üzerinde işlem yapabilir. Gönderilen işler paralel olarak çalışır ve BatchJobService, sıklık sınırlaması hataları gibi geçici hatalar nedeniyle başarısız olan işlemleri otomatik olarak yeniden dener. Google Ads API, API işlemleri sayma talimatlarını uygulayarak her işlemi günlük işlem sınırınıza dahil etmeye devam eder.

BatchJobService, isteklerinizde geçici kimlikler kullanmanıza da olanak tanır. Böylece bağımlı işlemleri tek bir iş olarak gönderebilirsiniz.

İşlemler

BatchJobService, temel hizmeti kısmi hatayı destekleyen MutateOperation içinde listelenen tüm işlemleri destekler. Ayrıca, açıkça muaf tutulan ve atomik alt gruplar halinde (ilgili birbirine bağlı işlemlerle birlikte) yürütülen AssetGroupOperation ve AssetGroupListingGroupFilterOperation işlemlerini de destekler.

Google Ads API, standart işlemleri kısmi hata etkinleştirilmiş bir işte yürüttüğünden (atomik alt gruplar hariç), bir iş iptal edilirse veya tek tek 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 ve kısmi hatayı desteklemez. Bu nedenle, toplu işlerde desteklenmezler. Bu işlemlerden herhangi birini toplu işe eklemek MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE hatası (veya BookCampaignsOperation ve QuoteCampaignsOperation için InternalError.INTERNAL_ERROR) döndürür. Bunun yerine, partial_failure false olarak ayarlanmış şekilde GoogleAdsService.Mutate kullanarak bunları yürütün (ve QuoteCampaignsOperation için validate_only true olarak ayarlanmış şekilde).

BatchJobService'te desteklenmeyen işlemler

Sonraki
Kullanım akışı