Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Embora a maioria dos serviços forneça APIs síncronas que exigem que você faça uma solicitação
e aguarde uma resposta, o BatchJobService
oferece uma maneira de realizar lotes de operações em vários serviços sem
aguardar de forma síncrona a conclusão das operações.
Ao contrário das operações de mutação específicas do serviço, um único trabalho 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 de forma automática
operações que falham devido a erros temporários, como erros de limitação de taxa. A API Google Ads ainda conta cada operação para o limite diário de operações, seguindo as instruções de contagem de operações da API.
O BatchJobService também permite usar IDs temporários nas 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 API Google Ads executa todas as operações em um job com o erro parcial ativado, 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 aceitam falhas parciais e não são compatíveis com jobs em lote. Evite adicionar essas operações aos seus
jobs, defina partial_failure como false nas solicitações e use o método mutate
em GoogleAdsService.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-13 UTC."],[[["`BatchJobService` enables asynchronous execution of multiple operations across various Google Ads services, reducing the need for synchronous waiting."],["It supports a wide range of operations, allowing you to manage campaigns, ad groups, ads, criteria, labels, and feed items within a single job."],["Failed operations due to transient errors like rate limits are automatically retried, ensuring higher reliability."],["Although it minimizes API requests and retries failed operations, using `BatchJobService` does not inherently guarantee improved performance; experimentation is crucial to determine its suitability for specific use cases."],["Certain atomic operations like `CampaignConversionGoalOperation`, `ConversionGoalCampaignConfigOperation`, `CustomConversionGoalOperation`, `CustomerConversionGoalOperation`, and `CustomerOperation` are not supported in batch jobs and should be executed using `GoogleAdsService` instead."]]],[]]