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:
- 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 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 as próximas versões. 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 | Alterações interruptivas e upgrade | Recursos e atualizações | Tabela de diferenças de proto |
|---|---|---|---|---|---|
| Versões de lançamento | |||||
| v23 | 28 de janeiro de 2026 | Fevereiro de 2027 | Alterações interruptivas da v23 (guia de upgrade) | Recursos e atualizações da v23 | Diferenças de proto da v22 em relação à v23 |
| v23.1 | 25 de fevereiro de 2026 | Fevereiro de 2027 | Nenhuma (versão secundária) | Recursos e atualizações da v23.1 | Diferenças de proto da v22 em relação à v23 |
| v23.2 | 25 de março de 2026 | Fevereiro de 2027 | Nenhuma (versão secundária) | Recursos e atualizações da v23.2 | Diferenças de proto da v22 em relação à v23 |
| v23.3 | 24 de junho de 2026 | Fevereiro de 2027 | Nenhuma (versão secundária) | Recursos e atualizações da v23.3 | Diferenças de proto da v22 em relação à v23 |
| v24 | 22 abril de 2026 | Maio de 2027 | Alterações interruptivas da v24 (guia de upgrade) | Recursos e atualizações da v24 | Diferenças de proto da v23 em relação à v24 |
| v24.1 | 13 de maio de 2026 | Maio de 2027 | Nenhuma (versão secundária) | Recursos e atualizações da v24.1 | Diferenças de proto da v23 em relação à v24 |
| v24.2 | 24 de junho de 2026 | Junho de 2027 | Nenhuma (versão secundária) | Recursos e atualizações da v24.2 | Diferenças de proto da v23 em relação à v24 |
| v25 | 22 de julho de 2026 | Agosto de 2027 | Alterações interruptivas da v25 (guia de upgrade) | Recursos e atualizações da v25 | Diferenças de proto da v24 em relação à v25 |
| v25.1 | 19 de agosto de 2026 | Agosto de 2027 | Nenhuma (versão secundária) | Recursos e atualizações da v25.1 | Diferenças de proto da v24 em relação à v25 |
| v25.2 | 23 de setembro de 2026 | Agosto de 2027 | Nenhuma (versão secundária) | Recursos e atualizações da v25.2 | Diferenças de proto da v24 em relação à v25 |
| v26 (mais recente) | 14 de outubro de 2026 | Novembro de 2027 | Alterações interruptivas da v26 (guia de upgrade) | Recursos e atualizações da v26 | Diferenças de proto da v25 em relação à 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 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:
- Abra APIs e serviços no console do Google Cloud.
- Clique em API Google Ads na tabela.
- 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.v26.services.GoogleAdsService.Mutate. - (Opcional) Escolha o período que você quer ver para as 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 é 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 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. |
Para usar a API Google Ads, faça upgrade das versões descontinuadas imediatamente.
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 ou 4 meses. Portanto, a versão em questão será descontinuada após aproximadamente 3 ou 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 fornecer bibliotecas de cliente compactas, vamos deixar 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 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 versão principal da API Google Ads (como a v26). Para conferir a versão necessária da biblioteca de cliente para versões secundárias, consulte o registro de alterações vinculado.
Java
API Google Ads |
Biblioteca de cliente para Java |
v26 |
Min: 48.0.0Max: - |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
API Google Ads |
Biblioteca de cliente para .NET |
v26 |
Min: 27.5.0Max: - |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
API Google Ads |
Biblioteca de cliente para PHP |
v26 |
Min: 35.2.0Max: - |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
API Google Ads |
Biblioteca de cliente para Python |
v26 |
Min: 34.0.0Max: - |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
API Google Ads |
Biblioteca de cliente para Ruby |
v26 |
Min: 46.0.0Max: - |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
API Google Ads |
Biblioteca de cliente para Perl |
v26 |
Min: 36.0.0Max: - |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
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 de campanhas inteligentes) e as mudanças de fluxo de trabalho sem versão (como os novos requisitos de orçamento de campanhas Geração de Demanda) são rastreadas separadamente.
Para conferir os próximos ciclos de vida de recursos e as alterações comportamentais nas versões ativas, consulte o guia Descontinuações de recursos e mudanças sem controle de versão.