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 suspensa, que não ficará mais disponível após a data definida. Confira outras diretrizes importantes:

  • Nosso objetivo é manter no máximo cinco 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ê precisará fazer, no máximo, dois upgrades por ano, e não é necessário fazer upgrade em ordem estritamente sequencial. Por exemplo, é possível fazer upgrade da versão (N) diretamente para a versão (N+2).

Nossas bibliotecas de cliente são compatíveis com qualquer versão disponível de um serviço. Assim, é possível fazer upgrade gradualmente especificando versões diferentes dos serviços usados.

Horários

A tabela a seguir lista as datas específicas de descontinuação e suspensã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 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
v2215 de outubro de 2025Outubro de 2026Fazer upgrade da v21 para a v22
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
Próximas versões
v26 Outubro de 2026 Novembro de 2027  
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 opcionais devido à sobreposição com a época de fim de ano.

Ver as versões que seu projeto está usando

É possível ver 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á as solicitações recentes plotadas 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.v25.services.GoogleAdsService.Mutate.
  4. (Opcional) Escolha o período que você quer analisar para suas 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 anteriores sã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 depois dela.
Implicação Você ainda pode usar as versões descontinuadas até que sejam desativadas, mas as referências delas não serão mais destacadas para mostrar que não são mais as versões mais recentes.

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 muito 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 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 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 listada da biblioteca de cliente é suficiente para a versão principal da API Google Ads (como a v25). Para conferir a versão necessária da biblioteca de cliente para lançamentos secundários, consulte o changelog vinculado.

Java

Registro de alterações

Biblioteca de cliente para Java
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
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
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
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
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
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ções de recursos e mudanças sem controle de versão.