Descontinuação e desativação

Com o lançamento de uma nova versão, uma versão descontinuada recebe uma data de desativação, após a qual ela não estará mais disponível. Confira outras diretrizes importantes:

  • Nossa meta é manter no máximo cinco versões principais disponíveis ao mesmo tempo.
  • As versões principais têm uma vida útil de cerca de 12 meses, e as secundárias, de 10 meses.
  • Você precisará realizar, 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).

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

Horários

Confira na tabela abaixo as datas específicas em que cada versão disponível será desativada e suspensa, 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 nesse mês, e as datas podem mudar. Inscreva-se no blog para receber lembretes sobre o anúncio da desativação da versão da API.

Versão da APIData de lançamentoData da desativaçãoGuia de upgrade
Versões de lançamento
v2328 de janeiro de 2026Fevereiro de 2027Fazer upgrade da v22 para a v23
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 22 abril de 2026 Maio de 2027 Fazer upgrade da v23.2 para a v24
v24.1 13 de maio de 2026 Maio de 2027 Fazer upgrade da v24 para a v24.1
v24.2 24 de junho de 2026 Junho de 2027 Fazer upgrade da v24.1 para a v24.2
v25 22 de julho de 2026 Agosto de 2027 Fazer upgrade da v24.2 para a v25
v25.1 19 de agosto de 2026 Agosto de 2027 Fazer upgrade da v25 para a v25.1
v25.2 23 de setembro de 2026 Agosto de 2027 Fazer upgrade da v25.1 para a v25.2
v26 14 de outubro de 2026 Novembro de 2027 Fazer upgrade da v25.2 para a v26
Próximas versões
v26.1 Outubro de 2026 Novembro de 2027  
v26.2 Novembro de 2026 Novembro de 2027  
v26.3* Dezembro de 2026 Novembro de 2027  
v27 Janeiro de 2027 Fevereiro de 2028  
v27.1 Fevereiro de 2027 Fevereiro de 2028  
v27.2 Fevereiro de 2027 Fevereiro de 2028  
v27.3 Março de 2027 Fevereiro de 2028  
v27.4 Março de 2027 Fevereiro de 2028  
v28 Abril de 2027 Maio de 2028  
v28.1 Abril de 2027 Maio de 2028  
v28.2 Maio de 2027 Maio de 2028  
v28.3 Maio de 2027 Maio de 2028  
v28.4 Junho de 2027 Maio de 2028  
v28.5 Junho de 2027 Maio de 2028  
v29 Julho de 2027 Agosto de 2028  
v29.1 Julho de 2027 Agosto de 2028  
v29.2 Agosto de 2027 Agosto de 2028  
v29.3 Agosto de 2027 Agosto de 2028  
v29.4 Setembro de 2027 Agosto de 2028  
v29.5 Setembro de 2027 Agosto de 2028  
v30 Outubro de 2027 Novembro de 2028  
v30.1 Outubro de 2027 Novembro de 2028  
v30.2 Novembro de 2027 Novembro de 2028  
v30.3* Dezembro de 2027 Novembro de 2028  

* As versões v26.3 e v30.3 são designadas como versões opcionais devido à sobreposição com a época de fim de ano.

Ver 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ê vai encontrar seus pedidos recentes representados em cada gráfico. É possível ver para quais métodos 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.v26.services.GoogleAdsService.Mutate.
  4. (Opcional) Escolha o período que você quer ver para as solicitações.

Diferenças entre descontinuação e desativação

TermoSuspensão de usoPôr do sol
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 são marcadas como descontinuadas. A versão desativada não pode mais ser usada. As solicitações enviadas para essa versão vão falhar na data de desativação ou depois dela.
Implicação Você ainda pode usar as versões descontinuadas até que elas sejam desativadas, mas as referências dessas versões não serão mais destacadas para mostrar que elas 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.

 Faça 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.
Velocidade Em média, lançamos uma nova versão a cada 3 a 4 meses. Portanto, a versão informada será descontinuada após aproximadamente 3 a 4 meses. Nosso objetivo é desativar uma versão um ano após o lançamento.
API Os endpoints de API das versões descontinuadas ainda funcionam normalmente.

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

 Os endpoints de API das 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 de API das versões desativadas.
Bibliotecas de cliente Para oferecer 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 novas versões de bibliotecas de cliente após as datas de desativação.
Suporte Oferecemos suporte regular para as versões descontinuadas. As versões descontinuadas não recebem mais suporte após a data de desativação.

Versões compatíveis da biblioteca de cliente

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

A versão mínima da biblioteca de cliente listada é suficiente para a principal versão da API Google Ads (como a v26). Para ver a versão necessária da biblioteca de cliente para versões secundárias, consulte o registro de alterações vinculado.

Java

Registro de alterações

Biblioteca de cliente para Java
v26 Min: 48.0.0
Max: -
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -

C#

Registro de alterações

Biblioteca de cliente para .NET
v26 Min: 27.5.0
Max: -
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -

PHP

Registro de alterações

Biblioteca de cliente para PHP
v26 Min: 35.2.0
Max: -
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -

Python

Registro de alterações

Biblioteca de cliente para Python
v26 Min: 34.0.0
Max: -
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -

Ruby

Registro de alterações

Biblioteca de cliente para Ruby
v26 Min: 46.0.0
Max: -
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -

Perl

Registro de alterações

Biblioteca de cliente para Perl
v26 Min: 36.0.0
Max: -
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -

Mudanças e descontinuações de recursos

Embora esta página se concentre nos ciclos de vida no nível da versão da API, as descontinuações de recursos individuais (como a descontinuação das campanhas inteligentes) e as mudanças de fluxo de trabalho sem versão (como novos requisitos de orçamento da campanha Geração de demanda) são rastreadas separadamente.

Para conferir os próximos ciclos de vida de recursos e alterações comportamentais nas versões ativas, consulte o guia Descontinuação de recursos e mudanças sem versão.