A maioria dos serviços oferece APIs síncronas, que exigem que você faça uma solicitação
e aguarde uma resposta, mas o BatchJobService
oferece uma maneira de executar lotes de operações em vários serviços sem
esperar de maneira síncrona que as operações sejam concluídas.
Ao contrário das operações mutate específicas do 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 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 os de limitação de taxa. A Google Ads API ainda contabiliza cada operação no seu limite diário de operações seguindo as instruções de contagem das operações da API.
Além disso, BatchJobService
permite usar IDs temporários nas suas solicitações para que você possa enviar operações dependentes em um único job.
Operações
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 job com a 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 são compatíveis com falhas parciais 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
.
Operações sem suporte em FlaskService
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation