Descontinuação e desativação

Com o lançamento de uma nova versão, uma versão recebe uma data de desativação. Após essa data, ela não será mais disponíveis. Aqui estão algumas outras diretrizes que você deve ter em mente:

• No máximo, três versões principais ficam disponíveis por vez.
• As versões principais têm uma vida útil de cerca de 12 meses. Já as versões secundárias: 10 meses.
• Você vai precisar realizar no máximo dois upgrades por ano e não precisa para fazer upgrade em ordem sequencial rigorosa. Por exemplo, da versão (N) diretamente para a versão (N+2).
• A sobreposição entre a data em que todas as bibliotecas de cliente foram lançadas para o a versão mais recente e a que será desativada há pelo menos 20 semanas.

Nossas bibliotecas cliente oferecem suporte a qualquer versão disponível de um para que você possa fazer upgrade gradualmente, especificando diferentes versões dos objetos serviços.

Horários

A tabela abaixo lista as datas específicas de descontinuação e desativação de cada versão disponível e as datas de lançamento projetadas para versões futuras. Qa incentivamos você a fazer upgrade para a versão mais recente o mais rápido possível, após a lançamento.

Versão da API	Data de lançamento	Data da suspensão do uso	Data da desativação	Guia de upgrade
v18	Set/out de 2024	Janeiro/fevereiro de 2025	Setembro de 2025
v17.1	7 de agosto de 2024	Set/out de 2024	Maio de 2025
v17	5 de junho de 2024	Set/out de 2024	Maio de 2025
v16.1	24 de abril de 2024	5 de junho de 2024	Janeiro de 2025	Fazer upgrade da v16 para a v17
v16	21 de fevereiro de 2024	5 de junho de 2024	Janeiro de 2025	Fazer upgrade da v16 para a v17
v15	18 de outubro de 2023	21 de fevereiro de 2024	25 de setembro de 2024	Fazer upgrade da v15 para a v16

Conferir as versões que o 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 a página APIs e Serviços no console do Google Cloud.
2. Clique em API Google Ads na tabela.
3. Na subguia MÉTRICAS, as solicitações recentes aparecem representadas nos cada gráfico. É possível ver para quais métodos você enviou solicitações na seção Methods. O nome do método inclui uma versão da API do Google Ads, um serviço e um nome de método, como google.ads.googleads.v17.services.GoogleAdsService.Mutate:
4. (Opcional) Escolha o período das suas solicitações.

Diferenças entre a descontinuação e a desativação

Termo	Suspensão de uso	Pôr do sol
Definição	A versão descontinuada não é a mais recente. Após o lançamento de uma nova versão, todas as anteriores serão marcadas suspenso.	A versão da desativação não pode mais ser usada. Solicitações enviadas para vai falhar a partir da data de desativação.
Implicação	Você ainda pode usar as versões descontinuadas até que elas sejam desativadas. mas as referências das versões descontinuadas são removidas para mostrar de que não são mais a versão mais recente. Recomendamos que você faça upgrade para a versão mais recente o quanto antes para aproveitar os novos recursos.	É necessário fazer upgrade das versões de desativação imediatamente em para usar a API Google Ads. É altamente recomendável fazer o upgrade para a versão mais recente anterior, usando o guia de upgrade.
Velocidade	Em média, lançamos uma nova versão a cada três a quatro meses, então será suspensa após aproximadamente três a quatro meses.	Pretendemos desativar uma versão um ano após o lançamento.
API	Os endpoints de API para as versões descontinuadas ainda funcionam como o normal. Você pode acessar os endpoints das nossas APIs usando nossas bibliotecas de cliente, REST e assim por diante. No entanto, novos recursos não são adicionados a versões obsoletas.	Os endpoints da API para as versões desativadas deixam de funcionar após a datas de desativação. A API Google Ads vai gerar um erro se você tentar acessar o Endpoints de API das versões de desativação.
Bibliotecas de cliente	Para fornecer bibliotecas de clientes compactas, vamos interromper incluindo versões descontinuadas de 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 em seus projetos.	As bibliotecas de cliente não são mais compatíveis com as versões da API de desativação em qualquer nova versão da biblioteca de cliente após as datas de desativação.
Suporte	Oferecemos suporte regular para as versões descontinuadas.	As versões de desativação não terão mais suporte após a desativação. data.

Versões compatíveis da biblioteca de cliente

A tabela mostra quais bibliotecas de cliente funcionam com quais versões da API.

Suspensões de uso de recursos

Acompanhe regularmente o blog do desenvolvedor do Google Ads para ser o primeiro a saber sobre futuras descontinuações de recursos.

A tabela abaixo lista as descontinuações de recursos específicos atualmente planejado 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
Estratégia de lances de comissões	API Google Ads não é mais compatível com a criação de campanhas de hotel com COMMISSION estratégia de lances .	30 de abril de 2024	Solicitações para criar novas campanhas de hotel ou aplicar a COMMISSION para campanhas existentes resultará em uma BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED erro. Campanhas atuais com os lances de COMMISSION e vai continuar em execução até 31 de outubro de 2024. Depois deste dia de campanhas deixam de ser veiculadas até que a estratégia de lances seja atualizada.