Przetwarzanie wsadowe umożliwia wysyłanie zestawu operacji, które mogą być współzależne, do wielu usług bez synchronicznego oczekiwania na zakończenie operacji. Do tworzenia kampanii Performance Max i zarządzania nimi możesz używać przetwarzania wsadowego.
Ten przewodnik zawiera szczegółowe informacje o kampaniach Performance Max, które są przydatne podczas korzystania z przetwarzania wsadowego. Ogólny przewodnik po przetwarzaniu wsadowym zawiera ogólne informacje o przetwarzaniu wsadowym, a przewodnik po strukturze żądań zawiera szczegółowe informacje o tworzeniu żądań służących do tworzenia kampanii Performance Max i zarządzania nimi.
Aby utworzyć kampanię Performance Max za pomocą przetwarzania wsadowego:
Tworzenie nowego zadania wsadowego
Wykonaj czynności tworzenia zadania ogólnego przetwarzania wsadowego, aby utworzyć zasób BatchJob.
Przygotowywanie listy operacji mutacji
Kampanie Performance Max wymagają operacji tworzenia kilku powiązanych zasobów, które zostały szczegółowo opisane w przewodniku po żądaniach dotyczących struktury. Utwórz MutateOperation dla każdego zasobu, który powinien być uwzględniony w zadaniu wsadowym.
Wymagania dotyczące CampaignOperation i CampaignAssetOperation
Gdy w kampanii Performance Max są włączone wytyczne dotyczące marki Campaign (brand_guidelines_enabled domyślnie ma wartość true, chyba że ustawisz ją na false lub utworzysz kampanię z celami związanymi z podróżami), musisz połączyć z kampanią zasoby marki Asset, korzystając z zasobów CampaignAsset.
Kampanie Performance Max dla Usług lokalnych nie obsługują wskazówek dotyczących marki i pomijają zasoby CampaignAsset marki (podczas tworzenia kampanii ustaw brand_guidelines_enabled na false). Kampanie detaliczne Performance Max (z plikiem danych Merchant Center) mogą pomijać zasoby CampaignAsset marki w tej samej niepodzielnej podgrupie tylko wtedy, gdy tworzysz kampanię bez komponentów i bez niestandardowych zasobów AssetGroupAsset (innych niż komponenty HTML5 MEDIA_BUNDLE) lub gdy parametr brand_guidelines_enabled ma wartość false.
W zadaniu wsadowym utwórz te zasoby CampaignAsset natychmiast po utworzeniu zasobu Campaign (łącznie do 1000 operacji w podzbiorze niepodzielnym).
Operacja Campaign create (resource_name) i kolejne operacje CampaignAsset create (campaign) muszą określać ten sam ujemny tymczasowy identyfikator, a wszystkie wymagane operacje AssetOperation create muszą być umieszczone przed utworzeniem Campaign. 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 nie powiedzie się i zostanie zwrócony błąd CampaignError wskazujący na brakujące zasoby. Uwzględnienie operacji tworzenia CampaignAsset później na tej samej liście operacji nie zapobiegnie temu błędowi.
Wymagania dotyczące AssetGroupOperation i AssetGroupAssetOperation
Gdy tworzysz zasoby AssetGroup z powiązanymi zasobami Asset za pomocą AssetGroupAsset, aby spełnić minimalne wymagania dotyczące komponentów, obiekty MutateOperation, które tworzą zasoby AssetGroup i AssetGroupAsset w zadaniu wsadowym, muszą być sekwencyjne i nie mogą zawierać innych operacji pomiędzy nimi. Wynika to ze sposobu grupowania tych operacji w niepodzielne podzbiory (łącznie do 1000 operacji na podzbiór). Podaj ten sam ujemny tymczasowy identyfikator w operacji AssetGroup create (resource_name) i w jej kolejnych operacjach AssetGroupAsset create (asset_group) oraz umieść wszystkie wymagane operacje AssetOperation create przed utworzeniem AssetGroup. W przeciwnym razie żądanie nie powiedzie się i zostanie zwrócony 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 znajdują się na liście operacji.
AssetGroupListingGroupFilterOperation sprawdzonych metod
Gdy tworzysz, aktualizujesz lub usuwasz zasoby AssetGroupListingGroupFilter, dodawaj do zadania wsadowego kolejno wszystkie operacje AssetGroupListingGroupFilterOperation kierowane na ten sam zasób AssetGroup, aby podczas dzielenia zadania wsadowego operacje te zostały zgrupowane w niepodzielne podzadanie wsadowe. Więcej informacji o dzieleniu na partie i innych czynnikach wpływających na grupy informacji o produktach znajdziesz w przewodniku po przetwarzaniu wsadowym grup informacji o produktach.
Dodawanie do zadania operacji mutacji
Dodaj operacje mutacji z kroku 2 do listy i wywołaj metodę AddBatchJobOperations, aby dodać listę mutacji do zadania wsadowego utworzonego w kroku 1. Aby dodać listę operacji mutacji, wykonaj krok dodawania operacji opisany w ogólnym przewodniku po przetwarzaniu wsadowym.
Uruchamianie zadania wsadowego
Zacznij wykonywać przesłane operacje, wywołując metodę RunBatchJob. Przykład znajdziesz w kroku Uruchamianie zadania wsadowego w ogólnym przewodniku po przetwarzaniu wsadowym.
Sprawdzanie stanu zadania i pobieranie wyników
Zadania wsadowe są wykonywane jako długo trwające operacje i zwykle wymagają czasu na zakończenie. Po rozpoczęciu zadania użyj metody Operations.GetOperation w usłudze google.longrunning.Operations (lub zapytania batch_job.status z GoogleAdsService), aby sprawdzać stan zadania, dopóki nie zostanie ono ukończone.
Po zakończeniu zadania wsadowego wywołaj metodę ListBatchJobResults, aby pobrać stan i odpowiedź dla każdej operacji w zadaniu. Przykład znajdziesz w sekcji Wyświetlanie listy wszystkich wyników zadania wsadowego.