Większość usług udostępnia synchroniczne interfejsy API, które wymagają wysłania żądania i oczekiwania na odpowiedź, jednak BatchJobService umożliwia wykonywanie wsadów w wielu usługach bez synchronicznego czekania na ich wykonanie.
W odróżnieniu od operacji mutacji poszczególnych usług jedno zadanie w BatchJobService może być stosowane do mieszanego zbioru kampanii, grup reklam, reklam, kryteriów, etykiet i elementów pliku danych.
Przesłane zadania są uruchomione równolegle, a BatchJobService automatycznie powtarza operacje, które nie powiodą się z powodu błędów przejściowych, takich jak błędy ograniczenia liczby żądań. Interfejs Google Ads API wciąż liczy każdą operację zgodnie z Twoim dziennym limitem operacji zgodnie z instrukcjami zliczania operacji API.
Dodatkowo BatchJobService umożliwia używanie tymczasowych identyfikatorów w żądaniach, dzięki czemu możesz przesyłać zależne operacje w jednym zadaniu.
Operacje
BatchJobService obsługuje wszystkie operacje wymienione w MutateOperation, z kilkoma ważnymi wyjątkami.
Interfejs Google Ads API wykonuje wszystkie operacje w ramach zadania z włączoną częściową niepowodzeniem. Jednak poniższe operacje w elemencie MutateOperation nie obsługują częściowej awarii, ponieważ muszą być atomowe. W rezultacie nie są one obsługiwane w zadaniach wsadowych i należy unikać ich dodawania do zadań.
Jeśli chcesz wykonać którąś z tych operacji, użyj metody mutate w GoogleAdsService i ustaw partial_failure na false.