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 a serem consideradas:

• 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 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 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

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 API	Data de lançamento	Data da desativação	Guia de upgrade
Versões lançadas
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
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
Próximas versões
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 festas.

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 a 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.v24.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

Termo	Suspensão de uso	Desativação
Definição	A versão suspensa é 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 suspensas.	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 suspensas até que elas sejam desativadas, mas as referências das versões suspensas 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 3 ou 4 meses. Portanto, a versão fornecida será suspensa após aproximadamente 3 ou 4 meses.	Nosso objetivo é desativar uma versão um ano após o lançamento.
API	Os endpoints da API para as versões suspensas ainda funcionam normalmente. É possível acessar nossos endpoints da API usando nossas bibliotecas de cliente e REST. No entanto, novos recursos não são adicionados às versões suspensas.	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 fins de fornecimento de bibliotecas de cliente compactas, vamos parar de incluir versões suspensas da API em uma nova versão da biblioteca de cliente após a data de suspensão. Isso ajuda você 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 suspensas.	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.

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

Suspensões de uso e mudanças de recursos

Embora esta página se concentre nos ciclos de vida das versões da API, as descontinuações de recursos individuais (como a descontinuação das campanhas inteligentes) e as mudanças de fluxo de trabalho não versionadas (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 de comportamento nas versões ativas, consulte o guia Suspensões de uso de recursos e mudanças não versionadas.