Większość usług udostępnia synchroniczne interfejsy API, które wymagają wysłania żądania
i poczekania na odpowiedź. BatchJobService
umożliwia wykonywanie zbiorczych operacji w wielu usługach bez
synchronicznego czekania na ich zakończenie.
W przeciwieństwie do operacji modyfikacji specyficznych dla usługi pojedyncze zadanie w
BatchJobService może działać na mieszanym
zbiorze kampanii, grup reklam, reklam, kryteriów, etykiet i elementów pliku danych.
Przesłane zadania są wykonywane równolegle, a
BatchJobService automatycznie ponawia
operacje, które nie powiodły się z powodu przejściowych błędów, takich jak błędy limitu. Interfejs
Google Ads API nadal liczy każdą operację w ramach
dziennego limitu operacji,
zgodnie z instrukcjami dotyczącymi zliczania
operacji API.
BatchJobService umożliwia też używanie
tymczasowych identyfikatorów w żądaniach, dzięki czemu
możesz przesyłać zależne operacje w ramach jednego zadania.
Operacje
BatchJobService obsługuje wszystkie operacje wymienione w
MutateOperation, z kilkoma ważnymi
wyjątkami.
Ponieważ interfejs Google Ads API wykonuje wszystkie operacje w zadaniu z częściowym niepowodzeniem włączonym, jeśli zadanie zostanie anulowane lub poszczególne operacje nie powiodą się, operacje, które się powiodły, nie zostaną wycofane.
Te operacje w MutateOperation muszą być
niepodzielne, dlatego nie obsługują częściowego niepowodzenia
i nie są obsługiwane w zadaniach zbiorczych. Unikaj dodawania tych operacji do swoich
zadań, ustaw partial_failure na false w żądaniach i zamiast tego użyj metody mutate
w GoogleAdsService.
Nieobsługiwane operacje w BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation