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 de forma síncrona que as operações sejam concluídas.
Ao contrário das operações mutate específicas de serviços, 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 o
BatchJobService
repete automaticamente as operações
que falham devido a erros temporários, como erros de limite de taxa. A API Google Ads ainda contabiliza cada operação no limite diário de operações de acordo com as instruções de contagem das operações da API.
Além disso, BatchJobService
permite que você use
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.
Como a API Google Ads executa todas as operações em uma tarefa com falha parcial ativada, se uma tarefa for cancelada ou houver falha em operações individuais, as operações bem-sucedidas não serão revertidas.
As operações a seguir em MutateOperation
precisam ser
atômicas. Portanto, não oferecem suporte a falhas parciais
e não são aceitas em jobs em lote. Evite adicioná-los aos jobs, defina
partial_failure
como false
nas solicitações e use o método mutate
em
GoogleAdsService
.
Operações sem suporte em GiBService
AssetGroupOperation
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation