Większość usług udostępnia synchroniczne interfejsy API, które wymagają wysłania żądania i oczekiwania na odpowiedź. BatchJobService umożliwia wykonywanie partii operacji w wielu usługach bez synchronicznego oczekiwania na ich zakończenie.
W odróżnieniu od operacji zmiany dotyczących konkretnych usług pojedyncze zadanie w BatchJobService może działać na mieszanej kolekcji kampanii, grup reklam, reklam, kryteriów, etykiet i komponentów. Przesłane zadania są uruchamiane równolegle, a BatchJobService automatycznie ponawia operacje, które nie powiodły się z powodu tymczasowych błędów, takich jak błędy związane z limitem liczby żądań. 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 w żądaniach tymczasowych identyfikatorów, dzięki czemu możesz przesyłać zależne operacje w ramach jednego zadania.
Operacje
BatchJobService obsługuje wszystkie operacje wymienione w MutateOperation, których usługa bazowa obsługuje częściowe niepowodzenie, a także AssetGroupOperation i AssetGroupListingGroupFilterOperation, które są wyraźnie zwolnione z tego wymogu i wykonywane (wraz z powiązanymi operacjami zależnymi) w niepodzielnych podgrupach.
Interfejs Google Ads API wykonuje standardowe operacje w zadaniu z włączoną opcją częściowego niepowodzenia (z wyjątkiem atomowych podgrup). 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 i nie obsługują częściowych błędów, więc nie są obsługiwane w przypadku zadań wsadowych. Dodanie którejkolwiek z tych operacji do zadania wsadowego zwraca błąd MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE (lub InternalError.INTERNAL_ERROR w przypadku BookCampaignsOperation i QuoteCampaignsOperation). Zamiast tego wykonaj je za pomocą GoogleAdsService.Mutate z parametrem partial_failure ustawionym na false (i parametrem validate_only ustawionym na true w przypadku QuoteCampaignsOperation).
Nieobsługiwane operacje w usłudze BatchJobService
BookCampaignsOperation(dostępne wMutateOperationod wersji 23)CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperationQuoteCampaignsOperation(dostępne wMutateOperationod wersji 23; wymaga ustawienia parametruvalidate_onlynatrue)