Toplu işleme

Çoğu hizmet, istekte bulunup yanıt beklemenizi gerektiren eşzamanlı API'ler sunsa da BatchJobService, işlemlerin tamamlanmasını eşzamanlı olarak beklemeden birden fazla hizmette toplu işlemler gerçekleştirmenize olanak tanır.

Hizmete özgü değiştirme işlemlerinin aksine, BatchJobService içindeki tek bir iş, kampanyalar, reklam grupları, reklamlar, ölçütler, etiketler ve öğelerden oluşan karma bir koleksiyon üzerinde ç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şlemleri sayma talimatlarına uyarak 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şte gönderebilirsiniz.

İşlemler

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

Google Ads API, standart işlemleri kısmi hata etkinleştirilmiş bir işte (atomik alt gruplar hariç) yürüttüğünden bir iş iptal edilirse veya tek tek işlemler başarısız olursa başarılı olan işlemler geri alınmaz.

MutateOperation içindeki aşağıdaki işlemler atomik olmalı ve kısmi hatayı desteklememelidir. Bu nedenle, toplu işlerde desteklenmez. 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 (ve QuoteCampaignsOperation için validate_only true olarak) ayarlanmış şekilde GoogleAdsService.Mutate kullanarak bunları yürütün.

BatchJobService'te desteklenmeyen işlemler

Sonraki
Kullanım akışı