Enquanto a maioria dos serviços oferece APIs síncronas, que exigem que você faça uma solicitação
e aguarde uma resposta, o BatchJobService
oferece uma maneira de executar lotes de operações em vários serviços sem
esperar que as operações sejam concluídas de maneira síncrona.
Diferentemente de operações de mutação específicas de serviço, um único job em BatchJobService
pode operar em um conjunto misto de campanhas, grupos de anúncios, anúncios, critérios, rótulos e itens do feed.
Os jobs enviados são executados em paralelo, e
BatchJobService
repete automaticamente as operações
que falham devido a erros transitórios, como erros de limite de taxa. A API Google Ads ainda conta cada operação para seu limite de operações diárias seguindo as instruções de contagem de operações da API.
Além disso, BatchJobService
permite usar
IDs temporários nas suas 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.
A Google Ads API executa todas as operações em um job com falha parcial ativada. No entanto, as
operações a seguir em MutateOperation
não são compatíveis com falha parcial
porque precisam ser atômicas. Por isso, elas não são aceitas em jobs em lote, e você deve evitar adicioná-las aos seus jobs.
Se você precisar executar qualquer uma dessas operações, use o método mutate
de
GoogleAdsService
e defina
partial_failure
como false
nas solicitações.