Przetwarzanie wsadowe

Większość usług udostępnia interfejsy API synchroniczne, które wymagają wysłania żądania, a następnie oczekiwania na odpowiedź. BatchJobService umożliwia wykonywanie zbiorczych operacji w wielu usługach bez oczekiwania na ich zakończenie.

W odróżnieniu od operacji przekształcania związanych z konkretną usługą pojedyncze zadanie w BatchJobService może działać na mieszanej kolekcji kampanii, grup reklam, reklam, kryteriów, etykiet i elementów pliku danych. Zgłoszone zadania są wykonywane równolegle, a BatchJobService automatycznie powtarza operacje, które nie powiodły się z powodu tymczasowych błędów, takich jak błędy związane z limitem szybkości. Interfejs Google Ads API nadal zlicza każdą operację do dobowego limitu operacji zgodnie z instrukcjami zliczania operacji API.

Ponadto BatchJobService umożliwia 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.

Interfejs Google Ads API wykonuje wszystkie operacje w zadaniu z włączonym uwzględnieniem częściowych niepowodzeń, więc jeśli zadanie zostanie anulowane lub poszczególne operacje zakończą się niepowodzeniem, operacje, które zakończyły się powodzeniem, niezostaną cofnięte.

Następujące operacje w MutateOperation muszą być niepodzielne, dlatego nie obsługują częściowego niepowodzenia i nie są obsługiwane w zbiorczych zadaniach. Nie dodawaj ich do zadań, ustaw wartość partial_failure na false w żądaniach i użyj metody mutate w GoogleAdsService.

Nieobsługiwane operacje w BatchJobService