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.