L'elaborazione batch fornisce un modo per inviare un insieme di operazioni, che possono essere interdipendenti, a più servizi senza attendere il completamento delle operazioni in modo sincrono. Puoi utilizzare l'elaborazione batch per creare e gestire le campagne Performance Max.
Questa guida fornisce dettagli specifici sulle campagne Performance Max quando si utilizza l'elaborazione batch. La guida generica all'elaborazione batch fornisce informazioni generali sull'elaborazione batch, mentre la guida Richieste di struttura contiene informazioni dettagliate sulla creazione di richieste per creare o gestire le campagne Performance Max.
Per creare una campagna Performance Max utilizzando l'elaborazione batch:
Crea un nuovo job batch
Segui il passaggio di creazione del job di elaborazione batch generale per creare una risorsa BatchJob
.
prepara un elenco di operazioni di modifica
Le campagne Performance Max richiedono operazioni per creare varie risorse correlate, descritte in dettaglio nella Guida alle richieste di struttura. Crea una MutateOperation
per ogni risorsa da includere nel job batch.
Requisiti di AssetGroupOperation
e AssetGroupAssetOperation
Le operazioni di tipo MutateOperation
che
creano risorse AssetGroup
e
AssetGroupAsset
in un job batch devono
essere sequenziali senza altre operazioni intermedie a causa di come queste
operazioni vengono raggruppate quando elaborate. In caso contrario, la richiesta genera un AssetGroupError
che indica che alcuni asset sono mancanti, anche se le operazioni necessarie per soddisfare i requisiti minimi degli asset vengono incluse in un secondo momento nell'elenco delle operazioni.
AssetGroupListingGroupFilterOperation
best practice
Quando lavori con i filtri dei gruppi di schede nel contesto di una AssetGroupListingGroupFilter
, ti consigliamo di aggiungere operazioni AssetGroupListingGroupFilterOperation
che hanno come target lo stesso AssetGroup
a un job batch consecutivamente, in modo che l'insieme di operazioni venga trattato a livello atomico durante la suddivisione del batch. Per ulteriori informazioni sulla suddivisione dei batch e su altri fattori che influiscono sui gruppi di schede, consulta la guida all'elaborazione batch dei gruppi di schede.
Aggiungi le operazioni di modifica al job
Aggiungi le operazioni di mutazione del passaggio 2 a un elenco e chiama
AddBatchJobOperations
per aggiungere l'elenco di mutazioni al job batch creato nel passaggio 1.
Segui il passaggio delle operazioni di aggiunta nella guida generale all'elaborazione batch per aggiungere l'elenco delle operazioni di modifica.
Esegui il job batch
Consenti l'avvio dei job caricati chiamando
RunBatchJob
. Per un esempio, consulta il passaggio Eseguire il job batch nella guida generale all'elaborazione batch.
Recupera lo stato del job
I job batch vengono avviati come operazioni a lunga esecuzione e in genere richiedono tempo per il completamento.
Dopo aver avviato il job, utilizza il metodo GetOperation
dell'operazione a lunga esecuzione per eseguire il polling dello stato del job fino al termine.
Al termine di tutti i job batch, chiama ListBatchJobResults
per stampare i relativi stati e risposte seguendo il passaggio Elenca tutti i risultati dei job batch nella guida generale all'elaborazione batch.