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 wsadowego.
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 strukturalnych. Utwórz MutateOperation dla każdego zasobu, który ma być uwzględniony w zadaniu wsadowym.
Wymagania CampaignOperation i CampaignAssetOperation
Gdy w kampanii są włączone 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 utworzeniu zasobu Campaign (gdy włączone są wskazówki 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 plikó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 modyfikacji
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ługo trwające operacje i zwykle wymagają czasu na ukończenie.
Po rozpoczęciu zadania użyj metody sprawdzania stanu zadania
GetOperation
długo trwającej operacji, dopóki nie zostanie ono ukończone.
Gdy wszystkie zadania wsadowe zostaną ukończone, wywołaj
ListBatchJobResults, aby
wydrukować ich stany i odpowiedzi zgodnie z krokiem wyświetlania wszystkich wyników zadań wsadowych w ogólnym przewodniku po przetwarzaniu wsadowym.