Embora a maioria dos serviços forneça APIs síncronas que exigem que você faça uma solicitação
e aguarde uma resposta, o BatchJobService
oferece uma maneira de realizar lotes de operações em vários serviços sem
aguardar de forma síncrona a conclusão das operações.
Ao contrário das operações de mutação específicas do serviço, um único trabalho em
BatchJobService pode operar em uma coleção
mista de campanhas, grupos de anúncios, anúncios, critérios, rótulos e itens de feed.
Os jobs enviados são executados em paralelo, e o
BatchJobService tenta novamente de forma automática
operações que falham devido a erros temporários, como erros de limitação de taxa. A API Google Ads ainda conta cada operação para o limite diário de operações, seguindo as instruções de contagem de operações da API.
O BatchJobService também permite usar IDs temporários nas solicitações para enviar operações dependentes em um único job.
Operações
O BatchJobService é compatível com todas as operações listadas em
MutateOperation, com algumas exceções
importantes.
Como a API Google Ads executa todas as operações em um job com o erro parcial ativado, se um job for cancelado ou operações individuais falharem, as operações bem-sucedidas não serão revertidas.
As operações a seguir em MutateOperation precisam ser atômicas e, portanto, não aceitam falhas parciais e não são compatíveis com jobs em lote. Evite adicionar essas operações aos seus
jobs, defina partial_failure como false nas solicitações e use o método mutate
em GoogleAdsService.
Operações sem suporte em BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation