Processamento em lote para campanhas Performance Max

O processamento em lote oferece uma maneira de enviar um conjunto de operações, que podem ser interdependentes, para vários serviços sem esperar de maneira síncrona que as operações sejam concluídas. É possível usar o processamento em lote para criar e gerenciar campanhas Performance Max.

Neste guia, apresentamos detalhes específicos para as campanhas Performance Max ao trabalhar com o processamento em lote. O guia genérico de processamento em lote fornece informações gerais sobre esse assunto, e o Guia de solicitações de estrutura contém detalhes sobre a criação de solicitações para criar ou gerenciar campanhas Performance Max.

Para criar uma campanha Performance Max usando o processamento em lote, siga estas etapas:

Criar um novo job em lote

Siga a etapa de criação do job de processamento em lote geral para criar um recurso BatchJob.

Preparar uma lista de operações mutate

As campanhas Performance Max exigem operações para criar vários recursos relacionados, que são detalhados no Guia de solicitações de estrutura. Crie um MutateOperation para cada recurso que precisar ser incluído no job em lote.

Requisitos de AssetGroupOperation e AssetGroupAssetOperation

As operações do tipo MutateOperation que criam recursos AssetGroup e AssetGroupAsset em um job em lote precisam ser sequenciais sem outras operações intermediárias devido ao modo como elas são agrupadas quando processadas. Caso contrário, a solicitação vai gerar uma AssetGroupError indicando que alguns recursos estão ausentes, mesmo que as operações necessárias para atender aos requisitos mínimos de recursos sejam incluídas posteriormente na lista de operações.

Práticas recomendadas para AssetGroupListingGroupFilterOperation

Ao trabalhar com filtros de grupo de listagens no contexto de uma AssetGroupListingGroupFilter, recomendamos adicionar operações AssetGroupListingGroupFilterOperation que segmentam o mesmo AssetGroup para um job em lote consecutivamente, para que o conjunto de operações seja tratado atomicamente durante a divisão em lote. Para ler mais sobre divisão em lote e outros fatores que afetam os grupos de fichas, consulte o guia de processamento em lote do grupo de fichas.

Adicionar as operações mutate ao trabalho

Adicione as operações mutate da Etapa 2 a uma lista e chame AddBatchJobOperations para adicionar a lista de mutações ao job em lote criado na Etapa 1. Siga a etapa de operações de adição no guia geral de processamento em lote para adicionar a lista de operações mutate.

Executar o job em lote

Permita que os jobs enviados comecem a ser executados chamando RunBatchJob. Para ver um exemplo, consulte a etapa Executar o job em lote no guia geral de processamento em lote.

Recuperar o status do job

Jobs em lote começam como operações de longa duração e geralmente levam tempo para serem concluídos. Depois de iniciar o job, use o método GetOperation da operação de longa duração para pesquisar o status do job até que ele seja concluído.

Quando todos os jobs em lote forem concluídos, chame ListBatchJobResults para imprimir os status e as respostas deles seguindo a etapa Listar todos os resultados de jobs em lote no guia geral de processamento em lote.