Embora a maioria dos serviços forneça APIs síncronas que exigem que você faça uma solicitação
e aguarde uma resposta, BatchJobService
oferece uma maneira de realizar lotes de operações em vários serviços sem
esperar de forma síncrona que as operações sejam concluídas.
Ao contrário das operações de mutação específicas do serviço, um único job 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
BatchJobService repete automaticamente as
operações que falham devido a erros temporários, como erros de limite de taxa. A
API Google Ads ainda conta cada operação para o
limite de operação diário,
seguindo as instruções de contagem
de operações da API.
BatchJobService também permite usar
IDs temporários nas solicitações para
enviar operações dependentes em um único job.
Operações
BatchJobService oferece suporte a 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 falha parcial ativada, 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 oferecem suporte a 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 mutate
método em GoogleAdsService em vez disso.
Operações não compatíveis no BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation