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
aguardar a conclusão síncrona das operações.
Ao contrário de operações mutate específicas de serviços, 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 o BatchJobService
repete automaticamente as operações que falham devido a erros temporários, como erros de limite de taxa. A Google Ads API ainda conta cada operação de acordo com seu limite de operações diário de acordo com 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
O BatchJobService
é compatível com todas as operações listadas em
MutateOperation
, com algumas exceções
importantes.
Como a Google Ads API executa todas as operações em um trabalho com falha parcial ativada, se um trabalho for cancelado ou operações individuais falharem, as operações bem-sucedidas não serão revertidas.
As seguintes operações em MutateOperation
precisam ser atômicas. Portanto, não são compatíveis com falha parcial e não são aceitas em jobs em lote. Evite adicioná-las aos jobs, defina partial_failure
como false
nas solicitações e use o método mutate
em GoogleAdsService
.