Przetwarzanie wsadowe umożliwia wysyłanie zestawu operacji, które mogą być od siebie zależne, do wielu usług bez synchronicznego oczekiwania na ich zakończenie. Do tworzenia kampanii Performance Max i zarządzania nimi możesz używać przetwarzania zbiorczego.
Ten przewodnik zawiera szczegółowe informacje dotyczące kampanii Performance Max w przypadku przetwarzania wsadowego. Ogólne informacje o przetwarzaniu wsadowym znajdziesz w przewodniku po przetwarzaniu wsadowym, a szczegółowe informacje o tworzeniu żądań dotyczących tworzenia kampanii Performance Max lub zarządzania nimi znajdziesz w przewodniku po strukturze żądań.
Aby utworzyć kampanię Performance Max za pomocą przetwarzania wsadowego:
Tworzenie nowego zadania wsadowego
Aby utworzyć zasób BatchJob, wykonaj ogólny krok tworzenia zadania przetwarzania wsadowego
.
Przygotuj listę operacji modyfikacji
Kampanie Performance Max wymagają utworzenia kilku powiązanych zasobów, które są szczegółowo opisane w przewodniku po żądaniach struktury. Utwórz MutateOperation dla każdego zasobu, który ma być uwzględniony w zadaniu wsadowym.
Wymagania CampaignOperation i CampaignAssetOperation
Jeśli w kampanii włączone są wskazówki dotyczące marki (patrz wskazówki dotyczące marki), musisz połączyć
komponenty marki z kampanią za pomocą CampaignAssetzasobów. Ponadto w przypadku zadania wsadowego tworzenie tych zasobów CampaignAssetmusi nastąpić bezpośrednio po utworzeniu samego zasobu Campaign. Jeśli CampaignAsset zasoby nie zostaną utworzone od razu
po Campaign zasobie (gdy włączone są wytyczne dotyczące marki – patrz rozwiązywanie problemów),
żądanie zakończy się niepowodzeniem i zwróci kod CampaignError wskazujący brakujące komponenty.
Umieszczenie operacji tworzenia CampaignAsset w dalszej części tej samej listy operacji nie zapobiegnie temu błędowi.
Wymagania AssetGroupOperation i AssetGroupAssetOperation
Operacje typu MutateOperation, które tworzą zasoby AssetGroup i AssetGroupAsset w pracy wsadowej, muszą być wykonywane sekwencyjnie bez innych operacji pomiędzy nimi, ponieważ podczas przetwarzania są one grupowane. W przeciwnym razie żądanie zwróci błąd AssetGroupError wskazujący, że brakuje 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.
AssetGroupListingGroupFilterOperation sprawdzone metody,
Podczas pracy z filtrami grup produktów w kontekście AssetGroupListingGroupFilter zalecamy dodawanie operacji AssetGroupListingGroupFilterOperation kierowanych na ten sam AssetGroup do zadania wsadowego kolejno, aby zestaw operacji był traktowany niepodzielnie podczas dzielenia wsadowego. Więcej informacji o dzieleniu partii i innych czynnikach wpływających na grupy plików znajdziesz w przewodniku po przetwarzaniu wsadowym grup plików.
Dodaj do zadania operacje zmiany
Dodaj operacje zmiany z kroku 2 do listy i wywołaj
AddBatchJobOperations
, aby dodać listę zmian do zadania wsadowego utworzonego w kroku 1.
Aby dodać listę operacji modyfikacji, wykonaj krok dodawania operacji w ogólnym przewodniku po przetwarzaniu zbiorczym.
Uruchamianie zadania wsadowego
Zezwól na uruchomienie przesłanych zadań, wywołując funkcję
RunBatchJob. Przykład znajdziesz w kroku Uruchom zadanie wsadowe w ogólnym przewodniku po przetwarzaniu wsadowym.
Pobieranie stanu zadania
Zadania wsadowe rozpoczynają się jako długotrwałe operacje i zwykle wymagają czasu na ukończenie.
Po rozpoczęciu zadania użyj metody sprawdzania stanu zadaniaGetOperation długo trwającej operacji, dopóki nie zostanie ono ukończone.
Po zakończeniu wszystkich zadań w partii wywołaj funkcję
ListBatchJobResults, aby
wydrukować ich stany i odpowiedzi zgodnie z krokiem
wyświetlania wszystkich wyników zadań w partii w ogólnym przewodniku po przetwarzaniu wsadowym.