Descontinuação e desativação

Com o lançamento de uma nova versão, uma versão em desuso 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 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 versões secundárias, de 10 meses.
• É preciso 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).
• 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 qualquer versão disponível 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 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 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 de desativação da versão da API.

Versão da API	Data de lançamento	Data da desativação	Guia de upgrade
Versões lançadas
v19	26 de fevereiro de 2025	Fevereiro de 2026 (provisório)	Fazer upgrade da v18 para a v19
v19.1	16 de abril de 2025	Fevereiro de 2026 (provisório)	Fazer upgrade da v18 para a v19
v19.2	6 de agosto de 2025	Fevereiro de 2026 (provisório)	Fazer upgrade da v18 para a v19
v20	4 de junho de 2025	Junho de 2026 (provisório)	Fazer upgrade da v19 para a v20
v20.1	6 de agosto de 2025	Junho de 2026 (provisório)	Fazer upgrade da v19 para a v20
v21	6 de agosto de 2025	Agosto de 2026 (provisório)	Fazer upgrade da v20 para a v21
v22	15 de outubro de 2025	Outubro de 2026 (provisório)	Fazer upgrade da v21 para a v22
Próximas versões
v23	Janeiro de 2026	Fevereiro de 2027
v23.1	Fevereiro de 2026	Fevereiro de 2027
v23.2	25 de março de 2026	Fevereiro de 2027
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 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:

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. 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.v22.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

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 for lançada, todas as 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 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 bibliotecas de cliente, REST e assim por diante. 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 da API das versões desativadas.
Bibliotecas de cliente	Para fornecer 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. Importante:as versões de API descontinuadas ainda estão disponíveis em versões lançadas anteriormente da biblioteca de cliente. Você ainda poderá fazer o download e usar essas versões até a desativação das versões da API.	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.

Java

API Google Ads	Biblioteca de cliente para Java
v22	Min: 41.1.0 Max: -
v21	Min: 39.0.0 Max: -
v20	Min: 38.0.0 Max: -
v19	Min: 36.0.0 Max: -

C#

API Google Ads	Biblioteca de cliente para .NET
v22	Min: 24.1.0 Max: -
v21	Min: 24.0.0 Max: -
v20	Min: 23.0.0 Max: -
v19	Min: 22.1.0 Max: -

PHP

API Google Ads	Biblioteca de cliente para PHP
v22	Min: 31.0.0 Max: -
v21	Min: 28.0.0 Max: -
v20	Min: 26.1.0 Max: -
v19	Min: 25.0.0 Max: 30.0.0

Python

API Google Ads	Biblioteca de cliente para Python
v22	Min: 28.1.0 Max: -
v21	Min: 28.0.0 Max: -
v20	Min: 27.0.0 Max: -
v19	Min: 25.2.0 Max: -

Ruby

API Google Ads	Biblioteca de cliente para Ruby
v22	Min: 36.0.0 Max: -
v21	Min: 35.0.0 Max: -
v20	Min: 34.0.0 Max: -
v19	Min: 32.0.0 Max: -

Perl

API Google Ads	Biblioteca de cliente para Perl
v22	Min: 29.0.0 Max: -
v21	Min: 28.0.0 Max: -
v20	Min: 27.0.0 Max: -
v19	Min: 26.0.0 Max: -

Suspensões de uso de recursos

Monitore regularmente o blog de desenvolvedores do Google Ads para saber em primeira mão sobre as futuras descontinuações de recursos.

A tabela a seguir lista as suspensões de uso de recursos específicos planejadas para a API Google Ads. Confira mais detalhes sobre cada descontinuação nas postagens do blog vinculadas.

Recurso	Descrição	Início da vigência	Outras observações
Ambiente de conversão para afetar a performance da campanha para apps	A partir de 30 de setembro de 2025, vamos começar a lançar gradualmente uma mudança nos modelos de lances, permitindo que eles usem dados do ambiente de conversão incluídos nas conversões importadas para otimizar a performance da campanha.	3 de outubro de 2025	Confira mais detalhes nesta postagem do blog.
As conversões podem incluir valores de "gclid" e "gbraid".	A partir de 3 de outubro de 2025, as conversões importadas não vão mais retornar um erro "VALUE_MUST_BE_UNSET" se os campos "gclid" e "gbraid" estiverem definidos.	3 de outubro de 2025	Confira mais detalhes nesta postagem do blog.