Embora a maioria dos serviços forneça APIs síncronas, exigindo 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 a conclusão das operações de forma síncrona.
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 o
BatchJobService tenta novamente 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 seu
limite diário de operações seguindo as
instruções de contagem de operações da API.
Além disso, o BatchJobService permite usar
IDs temporários nas suas solicitações para
enviar operações dependentes em um único job.
Operações
O 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 se operações individuais falharem, as operações que tiveram sucesso 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 trabalhos em lote. Evite adicioná-los aos seus jobs, defina
partial_failure como false nas suas solicitações e use o método mutate em
GoogleAdsService.
Operações sem suporte no BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation