Większość usług udostępnia synchroniczne interfejsy API, które wymagają wysłania żądania, a następnie oczekiwania na odpowiedź, jednak BatchJobService
umożliwia wykonywanie operacji zbiorczych na wielu usługach bez oczekiwania na zakończenie synchronizacji.
W przeciwieństwie do określonych mutacji usług, jedno zadanie w BatchJobService
może działać na mieszanym zbiorze kampanii, grup reklam, reklam, kryteriów, etykiet i elementów kanału.
Przesłane zadania są uruchomione równolegle, a BatchJobService
automatycznie ponawia próby zakończone niepowodzeniem z powodu błędów przejściowych, takich jak błędy limitu liczby żądań. Interfejs Google Ads API wciąż zlicza wszystkie operacje, zgodnie z limitem dziennym, zgodnie z instrukcjami liczenia operacji interfejsu API.
Dodatkowo w BatchJobService
możesz używać tymczasowych identyfikatorów w żądaniach, aby przesyłać zależne operacje w jednym zadaniu.
Operacje
BatchJobService
obsługuje wszystkie operacje wymienione w MutateOperation
, z kilkoma istotnymi wyjątkami.
Interfejs Google Ads API wykonuje wszystkie działania w ramach zadania z włączonym częściowym niepowodzeniem, dlatego jeśli zadanie zostanie anulowane lub nieudane operacje, operacje, które się nie powiodą, nie zostaną wycofane.
Te operacje w polu MutateOperation
muszą być atomowe, dlatego nie obsługują częściowej awarii i nie są obsługiwane w zadaniach wsadowych. Unikaj dodawania ich do zadań, ustaw dla żądań partial_failure
wartość false
w żądaniach i użyj metody mutate
w GoogleAdsService
.