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:
- Nosso objetivo é manter no máximo cinco versões principais disponíveis a qualquer momento.
- As versões principais têm um ciclo de vida de aproximadamente 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 estritamente sequencial. Por exemplo, é possível fazer 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 descontinuação pode acontecer a qualquer momento naquele mês, e as datas podem mudar. Inscreva-se no blog para receber lembretes sobre o anúncio da desativação de versões da API.
| Versão da API | Data de lançamento | Data da desativação | Guia de upgrade |
|---|---|---|---|
| Versões lançadas | |||
| v22 | 15 de outubro de 2025 | Outubro de 2026 (provisório) | Fazer upgrade da v21 para a v22 |
| v23 | 28 de janeiro de 2026 | Fevereiro de 2027 | Fazer 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* | Novembro de 2026 | Novembro de 2027 | |
* A v26.1 foi designada como uma versão opcional devido à sobreposição com a temporada 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:
- Abra APIs e serviços no console do Google Cloud.
- Clique em API Google Ads na tabela.
- Na subguia MÉTRICAS, você vai encontrar seus pedidos recentes representados em cada gráfico. Na tabela Métodos, você pode conferir quais métodos receberam solicitações. 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. - (Opcional) Escolha o período que você quer ver para suas solicitações.
Diferenças entre descontinuação e desativação
| Termo | Suspensão de uso | Pôr do sol |
|---|---|---|
| Definição | A versão descontinuada 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 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 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. |
É necessário fazer 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 como
de costume.
É 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 descontinuadas 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 oferecer bibliotecas de cliente compactas, vamos parar de incluir versões de API descontinuadas 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 de biblioteca de cliente compatíveis
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 v25). Para conferir a versão necessária da biblioteca de cliente para lançamentos secundários, consulte o changelog vinculado.
Java
API Google Ads |
Biblioteca de cliente para Java |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
v22 |
Min: 41.0.0Max: - |
C#
API Google Ads |
Biblioteca de cliente para .NET |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
v22 |
Min: 24.1.0Max: - |
PHP
API Google Ads |
Biblioteca de cliente para PHP |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
v22 |
Min: 31.0.0Max: - |
Python
API Google Ads |
Biblioteca de cliente para Python |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
v22 |
Min: 28.1.0Max: 32.0.0
|
Ruby
API Google Ads |
Biblioteca de cliente para Ruby |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
v22 |
Min: 36.0.0Max: - |
Perl
API Google Ads |
Biblioteca de cliente para Perl |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
v22 |
Min: 29.0.0Max: - |
Suspensões de uso e mudanças 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 mudanças comportamentais nas versões ativas, consulte o guia Descontinuação de recursos e mudanças sem versão.