Descontinuação e desativação

Com o lançamento de uma nova versão, será estipulado um prazo para a desativação da versão descontinuada, que não ficará mais disponível após a data definida. Confira outras diretrizes a serem consideradas:

  • Nosso objetivo é manter no máximo quatro versões principais disponíveis a qualquer momento.
  • As versões principais têm uma vida útil de cerca de 12 meses e as secundárias de 10 meses.
  • Você terá que fazer no máximo dois upgrades por ano, e não é necessário fazer o upgrade em ordem sequencial estrita. Por exemplo, é possível fazer o upgrade da versão (N) diretamente para a versão (N+2).
  • A sobreposição entre a data em que todas as bibliotecas de cliente são lançadas para a versão mais recente e a versão a ser desativada é de pelo menos 20 semanas.

Nossas bibliotecas de cliente oferecem suporte a todas as versões disponíveis de um serviço. Assim, é possível fazer o upgrade gradualmente especificando diferentes versões dos serviços usados.

Horários

A tabela a seguir lista as datas específicas de suspensão e desativação de cada versão disponível, além das datas de lançamento previstas para versões futuras. Recomendamos que você faça upgrade para a versão mais recente assim que possível após o lançamento. A data provisória significa que a desativação pode acontecer a qualquer momento naquele mês, e as datas podem mudar. Inscreva-se no blog para receber lembretes de anúncios de desativação de versões da API.

Versão da APIData de lançamentoData da desativaçãoGuia de upgrade
Versões lançadas
v204 de junho de 2025Junho de 2026 (provisório)Fazer upgrade da v19 para a v20
v20.16 de agosto de 2025Junho de 2026 (provisório)Fazer upgrade da v19 para a v20
v216 de agosto de 2025Agosto de 2026 (provisório)Fazer upgrade da v20 para a v21
v2215 de outubro de 2025Outubro de 2026 (provisório)Fazer upgrade da v21 para a v22
v2328 de janeiro de 2026Fevereiro de 2027Fazer upgrade da v22 para a v23
Próximas versões
v23.1 25 de fevereiro de 2026 Fevereiro de 2027 Fazer upgrade da v23 para a v23.1
v23.2 25 de março de 2026 Fevereiro de 2027 Fazer upgrade da v23.1 para a v23.2
v24 Abril de 2026 Maio de 2027  
v24.1 Maio de 2026 Maio de 2027  
v24.2 Junho de 2026 Maio de 2027  
v25 Julho de 2026 Agosto de 2027  
v25.1 Agosto de 2026 Agosto de 2027  
v25.2 Setembro de 2026 Agosto de 2027  
v26 Outubro de 2026 Novembro de 2027  
v26.1* Novembro de 2026 Novembro de 2027  

* A v26.1 é designada como uma versão opcional devido à sobreposição com a época de fim de ano.

Conferir as versões que seu projeto está usando

É possível conferir uma lista de métodos e serviços que seu projeto chamou recentemente usando o Console do Google Cloud:

  1. Abra APIs e serviços no Console do Google Cloud.
  2. Clique em API Google Ads na tabela.
  3. Na subguia MÉTRICAS, você verá suas solicitações recentes plotadas em cada gráfico. É possível conferir os métodos para os quais você enviou solicitações na tabela Métodos. O nome do método inclui uma versão da API Google Ads, um serviço e um nome de método, como google.ads.googleads.v23.services.GoogleAdsService.Mutate.
  4. (Opcional) Escolha o período que você quer conferir para suas solicitações.

Diferenças entre suspensão de uso e desativação

TermoSuspensão de usoDesativação
Definição A versão descontinuada é uma versão que não é a mais recente. Quando uma nova versão é lançada, todas as versões anteriores serão marcadas como descontinuadas. A versão desativada não pode mais ser usada. As solicitações enviadas a essa versão vão falhar na data de desativação ou após ela.
Implicação Você ainda pode usar as versões descontinuadas até que elas sejam desativadas, mas as referências das versões descontinuadas são desmarcadas para mostrar que não são mais a versão mais recente.

Recomendamos que você faça upgrade para a versão mais recente assim que possível para aproveitar os novos recursos.

 É necessário fazer upgrade das versões desativadas imediatamente para usar a API Google Ads.

Recomendamos que você faça upgrade para a versão mais recente usando o guia de upgrade.
Marcação de tempo Em média, lançamos uma nova versão a cada três ou quatro meses. Portanto, a versão em questão será descontinuada após aproximadamente três ou quatro meses. Nosso objetivo é desativar uma versão um ano após o lançamento.
API Os endpoints de API para as versões descontinuadas ainda funcionam normalmente.

É possível acessar nossos endpoints de API usando nossas bibliotecas de cliente, REST e assim por diante. No entanto, novos recursos não são adicionados às versões descontinuadas.

 Os endpoints da API para as versões desativadas param de funcionar após as datas de desativação. A API Google Ads vai gerar um erro se você tentar acessar os endpoints da API das versões desativadas.
Bibliotecas de cliente Para fornecer bibliotecas de cliente compactas, vamos parar de incluir versões descontinuadas da API em uma nova versão da biblioteca de cliente após a data de descontinuação. Isso ajuda a economizar espaço ao incorporar nossas bibliotecas de cliente nos seus projetos. As bibliotecas de cliente não oferecem mais suporte às versões desativadas da API em qualquer nova versão da biblioteca de cliente após as datas de desativação.
Suporte Oferecemos suporte regular para as versões descontinuadas. As versões desativadas não recebem mais suporte após a data de desativação.

Versões de biblioteca de cliente com suporte

A tabela mostra quais bibliotecas de cliente funcionam com quais versões da API.

Java

Biblioteca de cliente para Java
v23 Min: 42.1.0
Max: -
v22 Min: 41.1.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -

C#

Biblioteca de cliente para .NET
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -

PHP

Biblioteca de cliente para PHP
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 26.1.0
Max: -

Python

Biblioteca de cliente para Python
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Ruby

Biblioteca de cliente para Ruby
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -

Perl

Biblioteca de cliente para Perl
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Suspensões de uso de recursos

Monitore regularmente o blog de desenvolvedores do Google Ads para ser o primeiro a saber sobre as próximas suspensões de uso de recursos.

A tabela a seguir lista as suspensões de uso de recursos específicas planejadas para a API Google Ads. Mais detalhes sobre cada suspensão de uso podem ser encontrados nas postagens do blog vinculadas.

Recurso Descrição Início da vigência Outras observações
Mudanças no suporte à Segmentação por Lista de Clientes

A partir de 1º de abril de 2026, os tokens de desenvolvedor sem solicitações recentes de Segmentação por Lista de Clientes precisarão usar a API Data Manager para os fluxos de trabalho de Segmentação por Lista de Clientes.

1º de abril de 2026 Consulte nossa postagem do blog para mais detalhes.
Mudanças no suporte a atributos de endereço IP e sessão A partir de 2 de fevereiro de 2026, a API Google Ads não vai mais aceitar novos usuários de atributos de sessão ou dados de endereço IP como parte das importações de conversão. Os usuários atuais precisam migrar para a API Data Manager. 2 de fevereiro de 2026 Consulte nossa postagem do blog para mais detalhes.
Suspensão de uso de anúncios só para chamadas A partir de janeiro de 2026, não será possível criar novos anúncios só para chamadas. Os anúncios só para chamadas atuais vão parar de ser veiculados em fevereiro de 2027, e o suporte à API será removido. Os anunciantes precisam usar anúncios responsivos de pesquisa com recursos de ligação em vez disso. Janeiro de 2026 Consulte nossa postagem do blog para mais detalhes.