Anúncio da v24.2 da API Google Ads

Quarta-feira, 24 de junho de 2026

Hoje, anunciamos o lançamento da v24.2 da API Google Ads. Esta versão secundária traz atualizações de segurança críticas, novos recursos de transparência de IA, melhorias nos relatórios e insights de planejamento avançados. Para usar esses novos recursos, faça upgrade das bibliotecas de cliente e do código do cliente. Todas as bibliotecas de cliente e exemplos de código atualizados foram publicados.

Também estamos lançando as versões secundárias v23.3, v22.2 e v21.2 da API Google Ads para adicionar suporte às aprovações de outra parte e à rotulagem de conteúdo sintético.

Participe de uma apresentação ao vivo desta versão no nosso evento "Destaques da versão da API Google Ads" no Discord ou na nossa transmissão ao vivo do Ads Developers no YouTube amanhã (25 de junho, às 11h, horário de Brasília). O evento também será gravado e postado no YouTube para quem não puder participar ao vivo. Se você tiver dúvidas ou quiser discutir este post, entre em contato pelo canal #ads-api no Discord.

Novos recursos

Aprovações de outra parte (MPA, na sigla em inglês) para a API Google Ads: agora a API Google Ads é compatível com a aprovação de outra parte. Esse recurso protege ações sensíveis da conta, como convites de usuários e atualizações de nível de acesso, exigindo que um segundo administrador aprove as mudanças.

Transparência da IA: rotulagem de conteúdo sintético: com os recursos gerados com IA se tornando cada vez mais comuns, a transparência é essencial. A API Google Ads v24.2 expõe as estruturas SyntheticContentInfo e SyntheticContentAttestation nos recursos Asset e Ad, permitindo que você rotule de forma programática os criativos de anúncios gerados com IA. Tanto o anunciante quanto os sistemas do Google podem atestar se os recursos e anúncios foram gerados com IA ou não, bem como se foram gerados de forma totalmente automática ou com revisão do anunciante. Se você está se preparando para a Lei de IA da UE, que entra em vigor em 2 de agosto de 2026, conheça esse recurso. Para ajudar você a planejar o trabalho de integração da v25, a interface para modificar os campos de atestado do anunciante está sendo lançada antecipadamente para as versões v22 e mais recentes. A interface fica visível nessas versões, mas os campos synthetic_content_info.advertiser_attestation.status e synthetic_content_info.advertiser_attestation.source permanecem imutáveis.

Se você tentar uma solicitação de mutação em um desses campos, um destes erros será retornado:

"O campo que tentou ser modificado é imutável" ou "Não é possível definir o campo". Esses campos serão totalmente mutáveis a partir da v25. Recomendamos usar a interface agora para criar e testar sua lógica interna, de modo que o sistema esteja pronto para os recursos de gravação completos quando a v25 for lançada.

Relatórios de canais e vinculações de vídeo das campanhas PMax: esta versão também inclui melhorias importantes nos relatórios e nos recursos de vídeo:

  • Segmentação de canais das campanhas PMax: agora é possível segmentar os relatórios de performance_max_placement_view por ad_network_type, o que oferece uma visibilidade detalhada de onde seus anúncios das campanhas PMax estão sendo veiculados nas redes de pesquisa, de display e de parceiros.
  • Links de canais de marca do YouTube: crie links de dados seguros do YouTube associados a um canal de marca específico diretamente pela API Google Ads, permitindo integrações mais ricas de recursos de vídeo.
  • Geração de texto da página de destino: ative a geração automática de recursos de texto com base na sua página de destino usando o novo LANDING_PAGE_TEXT_GENERATION AssetAutomationType.

Novos tipos de experimento: introduzimos novos tipos de experimento para oferecer mais flexibilidade de teste.

  • Experimentos de mix de campanhas: esse novo fluxo de trabalho é compatível com o tipo de experimento COMPARE_CAMPAIGNS, que equivale aos tipos de campanha mista personalizada na interface do Google Ads. Com ele, você pode atribuir campanhas atuais a até cinco grupos experimentais para comparar diversas variáveis e tipos de campanhas em um único experimento. Esse fluxo de trabalho também permite criar testes de Performance Max personalizados.
  • Teste de recursos das campanhas Performance Max: o novo tipo de experimento PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION permite dividir o tráfego em uma única campanha para testar o impacto da personalização de texto (antes conhecida como recursos automáticos) e da expansão de URL final.

Atualizações da documentação

Reformulamos o formato das notas da versão para ajudar você a identificar as mudanças introduzidas em cada versão. As alterações interruptivas agora são listadas separadamente das atualizações de recursos não interruptivas. O guia de descontinuações de recursos e mudanças sem controle de versão ajuda você a acompanhar as desativações de recursos.

Esperamos que esse novo formato ajude você a fazer upgrades de API com mais facilidade. Teste o recurso e envie seu feedback clicando no botão Enviar feedback.

Primeiros passos

A API Google Ads v24.2 é um upgrade direto da v24.1. Se você usa nossas bibliotecas de cliente, baixe a versão mais recente para começar a usar esses recursos. Para conferir uma lista completa de mudanças, consulte as notas da versão oficiais. Para suporte técnico, entre em contato pelo link https://support.google.com/google-ads/contact/google_ads_api.

Retrato do autor - , equipe da API Google Ads

Marcadores: google-ads-api, release