Tudo Sobre o Google Ads API v20: Funcionalidades Que Deves Conhecer

1,648 visualizações · gostos · 51 partilhas
Partilhar em
Por Unled Network · 5 de abr. de 2026 · 14 min de leitura
Tudo Sobre o Google Ads API v20: Funcionalidades Que Deves Conhecer

O Google Ads API v20 é a primeira versão que inclui controlos AI Max de primeira parte, escritas nativas na biblioteca de assets e o novo endpoint de insights de termos de pesquisa, ao mesmo tempo que retira alguns serviços legados que já estavam depreciados há dois anos. Se operas à escala, a migração para a v20 não é opcional. Os endpoints depreciados da v17 e anteriores deixam de devolver dados nas datas de descontinuação publicadas.

O que há de novo na v20

As principais novidades são o SearchTermInsightService, os métodos de escrita do AssetLibraryService, o AiMaxAdGroupService e um RecommendationService expandido que agora expõe recomendações programaticamente que antes só apareciam na UI. Também são novos os campos de metadados de experiência mais ricos e um método dedicado ConversionActionService.upload_offline_conversions v2 que suporta os novos formatos de identificador.

Depreciações que tens de tratar

O legado AdGroupAdAssetView, os métodos originais de upload de Customer Match que usavam strings de email simples e os campos de relatório da v17 para simuladores de lances de palavra-chave foram todos retirados. O código que ainda os referencia vai devolver erro na v20. A migração é mecânica, mas morosa. Planeia uma semana de trabalho por integração de média dimensão.

Controlos AI Max

O AiMaxAdGroupService finalmente expõe, ao nível da campanha, os toggle para os comportamentos AI Max que antes eram exclusivos da UI. Podes definir o nível de opt-in de assets, listas de exclusão de marcas, sobreposições de exclusão geográfica e sobreposições de janela de conversão por grupo de anúncios. Isto torna o AI Max utilizável em stacks empresariais que precisam de barreiras de proteção orçamentais.

Escritas na Biblioteca de Assets

O AssetLibraryService agora suporta upload, marcação e reutilização programática de assets em várias campanhas. Combinado com o AssetGroupService, permite-te provisionar campanhas de Performance MaxTipo de campanha do Google Ads que aloca automaticamente o orçamento entre Pesquisa, Display, YouTube, Gmail e Maps usando machine learning.Saber mais no glossário → de ponta a ponta a partir do teu próprio DAM. Os assets carregados respeitam a mesma fila de revisão de conteúdo que os uploads feitos pela UI, por isso o asset não fica imediatamente em serviço após a criação.

Caminho de migração desde a v19 e anteriores

O Google garante uma janela de descontinuação de 14 meses por versão principal. A v17 é descontinuada em 2026, a v18 no 4º trimestre de 2026, a v19 em 2027. O caminho de migração suportado é diretamente da v17 para a v20, não da v17 para a v18, v19 e depois v20. Se saltares versões, tens de retestar cada endpoint individualmente. Recomendamos um sprint de migração por versão principal a cada 12 meses, não uma maratona a cada 4 anos.

Precisas de uma Estratégia de Conteúdo SEO-Safe?

A nossa equipa constrói estratégias de conteúdo que aproveitam a eficiência da IA, mantendo a qualidade, experiência e originalidade que o Google recompensa. Conteúdo que posiciona E converte.

Pelos Números

+186%
Aumento do pipeline num plano testado de 90 dias
12
Canais que avaliamos antes de nos comprometermos
<7d
Tempo desde o arranque até ao primeiro aumento mensurável
7 dígitos
Maior orçamento que gerimos pessoalmente

Como nos Comparámos

DimensãoPlano Unled ★Agência GenéricaSolo In House
Cobertura de canais12 + avaliados3 a 41 a 2
CadênciaSprints de 90 diasSlides trimestraisAd hoc
Testes de incrementalidadePadrãoRaroNão executado
Profundidade de relatóriosPor canal e combinadoApenas canalFolha de cálculo
Operador práticoSimGestor de contaFundador
Elasticidade orçamentalModeladaLinearSuposição

Glossário

Métrica Norte
Resultado único de negócio que todo o plano de media é desenhado para mover.
MER
Rácio de Eficiência de Marketing. Receita dividida pelo gasto total de marketing em todos os canais.
LTV para CAC
Valor vitalício de um cliente dividido pelo custo de aquisição. Decide quão agressivo o teto de lance pode ser.
Incrementalidade
Aumento nas conversões causado pelo anúncio, isolado da linha de base orgânica através de testes com grupo de controlo.
Stack de Canais
Conjunto ordenado de canais nos quais o orçamento é aplicado, classificados por retorno marginal.
Sprint de 90 Dias
Cadência operacional que fixa objetivos, orçamentos e KPIs em blocos de doze semanas.
Sempre Ligado vs Rajada
Decisão de manter um canal a funcionar continuamente ou ativá-lo em janelas concentradas à volta de lançamentos.
Pacing Orçamental
Disciplina de aplicar o orçamento diário de forma a atingir o gasto mensal planeado sem o concentrar no início ou deixar faltar no final do mês.
Hand Raiser
Lead que realizou uma ação explícita de alta intenção, como um pedido de demonstração ou marcação de chamada de vendas.
Modelo de Atribuição
Regra que atribui crédito de conversão através dos pontos de contacto que precederam a venda.

Perguntas Frequentes

Quanto tempo até "tudo sobre o google ads api v20: funcionalidades que deves conhecer" começar a produzir resultados mensuráveis?

O primeiro sinal mensurável chega dentro de sete dias quando o trabalho é estruturado, não improvisado. Uma melhoria material é consistentemente visível dentro de 30 a 60 dias. Quem promete resultados durante a noite está a vender fumo ou a brincar com as janelas de atribuição.

O que é que a Unled Network entrega de diferente em "tudo sobre o google ads api v20: funcionalidades que deves conhecer"?

Tratamos "tudo sobre o google ads api v20: funcionalidades que deves conhecer" como um sistema operativo, não como uma lista de verificação. Isso significa um único responsável pelo criativo, media, infraestrutura e relatórios, com uma janela de resposta no Telegram e WhatsApp dentro de 24 horas, e 100% de paridade local nos nossos 18 mercados suportados.

"Tudo sobre o google ads api v20: funcionalidades que deves conhecer" é arriscado para a minha conta ou reputação do domínio?

O risco só aparece quando o trabalho é descuidado. Fazemos uma pré-avaliação de cada campanha e de cada página contra a cláusula de política e regra da plataforma relevante. A única exposição significativa que resta é a instabilidade do lado da plataforma, contra a qual nos protegemos com um plano de continuidade e um MCCConta de Gestor. Um guarda-chuva do Google Ads que te permite criar e gerir sub-contas ilimitadas sob uma única relação de faturação.Saber mais no glossário → antigo pronto para absorver o gasto.

"Tudo sobre o google ads api v20: funcionalidades que deves conhecer" pode funcionar em conjunto com a minha agência ou equipa interna existente?

Sim. Estruturamos propositadamente a equipa para a entrega. Documentamos cada alteração, disponibilizamos um dashboard partilhado e operamos como o dono do canal ou a camada técnica por detrás da tua equipa existente. O modelo é decidido na primeira semana e nunca renegociado a meio de um sprint.

Comentários

Tem uma pergunta ou experiência? Junte-se à conversa. O seu email fica privado.

    Chris T.

    Great article. Any case studies showing ROI?

    Author

    Great question! This is something we see frequently with our clients. The key is consistency rather than a one-time fix.

Juntar-se à conversa

Sem HTML. Comentários moderados.

What You Get

High Trust Score

Pre-established account with positive activity history and cleared standing

Ready to Spend

Skip the warm-up phase - accounts are ready for immediate campaign launch

High Spend Ceiling

Elevated daily and monthly spend limits from day one

30-Day Replacement

Full replacement if account triggers suspension within 30 days

24h Delivery

Credentials delivered within 24 hours of payment confirmation

Dedicated Support

Direct Telegram/WhatsApp line to your account manager

WhatsApp Telegram