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

TermoSuspensão de usoPô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.

Java

Biblioteca de cliente para Java
v17 32.0.0
Min: Max:
v16 30.0.0
Min: Max:
v15 Min: 28.0.0
Max: 32.0.0

C#

Biblioteca de cliente para .NET
v17 20.1.0
Min: Max:
v16 18.1.0
Min: Max:
v15 Min: 17.1.0
Max: 20.1.0

PHP

Biblioteca de cliente para PHP
v17 23.1.0
Min: Max:
v16 22.1.0
Min: Max:
v15 Min: 21.1.0
Max: 23.1.0

Python

Biblioteca de cliente para Python
v17 24.1.0
Min: Max:
v16 23.1.0
Min: Max:
v15 22.1.0
Min: Max:

Ruby

Biblioteca de cliente para Ruby
v17 29.0.0
Min: Max:
v16 27.0.0
Min: Max:
v15 25.0.0
Min: Max:

Perl

Biblioteca de cliente para Perl
v17 23.0.0
Min: Max:
v16 21.0.0
Min: Max:
v15 19.0.0
Min: Max:

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.