Przetwarzanie wsadowe umożliwia wysyłanie zestawu operacji, które mogą być od siebie zależne, do wielu usług bez synchronicznego oczekiwania na zakończenie operacji. Przetwarzania wsadowego możesz używać do tworzenia kampanii Performance Max i zarządzania nimi.
W tym przewodniku znajdziesz szczegółowe informacje dotyczące kampanii Performance Max podczas pracy z przetwarzaniem wsadowym. Ogólne informacje o przetwarzaniu wsadowym znajdziesz w ogólnym przewodniku po przetwarzaniu wsadowym, a szczegółowe informacje o tworzeniu żądań dotyczących tworzenia kampanii Performance Max i zarządzania nimi znajdziesz w przewodniku po żądaniach struktury.
Aby utworzyć kampanię Performance Max za pomocą przetwarzania wsadowego:
Utwórz nowe zadanie wsadowe
Aby utworzyć zasób
BatchJob, wykonaj ogólny krok tworzenia zadania przetwarzania wsadowego
.
Przygotuj listę operacji mutate
Kampanie Performance Max wymagają operacji tworzenia kilku powiązanych
zasobów, które są szczegółowo opisane w
przewodniku po żądaniach struktury. Utwórz a
MutateOperation dla każdego zasobu, który ma
być uwzględniony w zadaniu wsadowym.
Wymagania dotyczące CampaignOperation i CampaignAssetOperation
Gdy w kampanii są włączone wskazówki dotyczące marki (patrz
wskazówki dotyczące marki), musisz połączyć
zasoby marki z kampanią za pomocą CampaignAsset
zasobów. Ponadto w zadaniu wsadowym tworzenie tych CampaignAsset
zasobów musi nastąpić natychmiast po utworzeniu samego Campaign
zasobu. Jeśli zasoby CampaignAsset nie zostaną utworzone natychmiast
po zasobie Campaign (gdy wskazówki dotyczące marki są włączone – patrz
rozwiązywanie problemów),
żądanie zakończy się niepowodzeniem i zwróci CampaignError wskazujący brak komponentów.
Dodanie operacji tworzenia CampaignAsset później na tej samej liście operacji nie zapobiegnie temu błędowi.
Wymagania dotyczące AssetGroupOperation i AssetGroupAssetOperation
Operacje typu MutateOperation, które
tworzą zasoby AssetGroup i
AssetGroupAsset w zadaniu wsadowym, muszą
być wykonywane kolejno bez innych operacji pomiędzy nimi, ponieważ te
operacje są grupowane podczas przetwarzania. W przeciwnym razie żądanie zgłosi
AssetGroupError wskazujący
brak niektórych komponentów
nawet jeśli operacje wymagane do
spełnienia minimalnych wymagań dotyczących komponentów zostaną uwzględnione później
na liście operacji.
Sprawdzone metody dotyczące AssetGroupListingGroupFilterOperation
Podczas pracy z filtrami grup informacji o produktach w kontekście
AssetGroupListingGroupFilter zalecamy dodawanie
AssetGroupListingGroupFilterOperation
operacji kierowanych na tę samą AssetGroup do
zadania wsadowego kolejno, aby zestaw operacji był traktowany jako niepodzielny
podczas dzielenia wsadowego. Więcej informacji o dzieleniu wsadowym i innych czynnikach
wpływających na grupy informacji o produktach znajdziesz w
przewodniku po przetwarzaniu wsadowym grup informacji o produktach.
Dodaj operacje mutate do zadania
Dodaj operacje mutate z kroku 2 do listy i wywołaj
AddBatchJobOperations
aby dodać listę zmian do zadania wsadowego utworzonego w kroku 1.
Aby dodać listę operacji mutate, wykonaj krok dodawania operacji
w ogólnym przewodniku po przetwarzaniu wsadowym.
Uruchom zadanie wsadowe
Aby umożliwić uruchomienie przesłanych zadań, wywołaj
RunBatchJob. Przykład znajdziesz w kroku
Uruchom zadanie wsadowe
w ogólnym przewodniku po przetwarzaniu wsadowym.
Pobierz stan zadania
Zadania wsadowe rozpoczynają się jako długo trwające operacje i zwykle wymagają czasu na zakończenie.
Po rozpoczęciu zadania użyj metody
GetOperation
długo trwającej operacji, aby sondować stan zadania
do momentu jego zakończenia.
Gdy wszystkie zadania wsadowe zostaną zakończone, wywołaj
ListBatchJobResults, aby
wydrukować ich stany i odpowiedzi, wykonując krok
Wyświetl wszystkie wyniki zadań wsadowych w
ogólnym przewodniku po przetwarzaniu wsadowym.