Descontinuação e desativação

Com o lançamento de uma nova versão, a versão obsoleta recebe uma data de desativação. Após essa data, a versão não estará mais disponível. 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ê terá que realizar no máximo dois upgrades por ano e não precisa fazer upgrade em ordem sequencial estrita. 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 dão suporte a todas as versões disponíveis de um serviço. Dessa forma, é possível fazer upgrade gradualmente especificando diferentes versões dos serviços usados.

Horários

A tabela abaixo lista as datas específicas de descontinuação e desativação de cada versão disponível, além das datas de lançamento projetadas para versões futuras. Incentivamos você a fazer upgrade para a versão mais recente assim que possível após o 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 Julho/agosto de 2024 Set/out de 2024 Maio de 2025
v17 Maio/junho de 2024 Set/out de 2024 Maio de 2025
v16.1 24 de abril de 2024 Maio/junho de 2024 Janeiro de 2025
v16 21 de fevereiro de 2024 Maio/junho de 2024 Janeiro de 2025
v15 18 de outubro de 2023 21 de fevereiro de 2024 25 de setembro de 2024 Fazer upgrade da v15 para a v16
v14.1 9 de agosto de 2023 18 de outubro de 2023 5 de junho de 2024
v14 7 de junho de 2023 18 de outubro de 2023 5 de junho de 2024 Fazer upgrade da v14 para a v15

Conferir as versões que o 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:

  1. Abra 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 em cada gráfico. Veja 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.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. Quando uma nova versão é lançada, todas as versões anteriores são marcadas como obsoletas. A versão da desativação não pode mais ser usada. As solicitações enviadas para essa versão vão falhar a partir da data de desativação.
Implicação Você ainda pode usar as versões obsoletas até que elas sejam desativadas, mas as referências dessas versões são removidas 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 o quanto antes e aproveite os novos recursos.

É necessário fazer upgrade das versões de desativação imediatamente para usar a API Google Ads.

É altamente recomendável fazer upgrade para a versão mais recente usando o guia de upgrade.

Tempo Em média, lançamos uma nova versão a cada três a quatro meses, então a versão em questão será descontinuada após aproximadamente esse período. Pretendemos desativar uma versão um ano após o lançamento.
API Os endpoints da API para as versões obsoletas ainda funcionam normalmente.

É possível acessar os endpoints da API usando as bibliotecas de cliente, REST e assim por diante. No entanto, novos recursos não são adicionados às versões obsoletas.

Os endpoints da API para as versões de desativação param de funcionar após essas datas. 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, deixamos de incluir versões descontinuadas de API em uma nova versão da biblioteca de cliente após a data de suspensão de uso. Isso ajuda você a economizar espaço ao incorporar nossas bibliotecas de cliente nos seus projetos. As bibliotecas de cliente não são mais compatíveis com as versões da API de desativação em nenhuma nova versão delas 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 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.

Java

Biblioteca de cliente para Java
v16 Min: 30.0.0
Max: –
v15 Min: 28.0.0
Max: –
v14 Min: 26.0.0
Max: 30.0.0

C#

Biblioteca de cliente para .NET
v16 Min: 18.1.0
Max: –
v15 Min: 17.1.0
Max: –
v14 Min: 16.1.0
Max: 19.0.1

PHP

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

Python

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

Ruby

Biblioteca de cliente para Ruby
v16 Min: 27.0.0
Max: –
v15 Min: 25.0.0
Max: –
v14 Min: 23.0.0
Max: 27.0.0

Perl

Biblioteca de cliente para Perl
v16 Min: 21.0.0
Max: –
v15 Min: 19.0.0
Max: –
v14 Min: 17.0.0
Max: 21.0.0

Suspensões de uso de recursos

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

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

Engenharia de Descrição Início da vigência Outras observações
Estratégia de lances de comissões A API Google Ads não é mais compatível com a criação de campanhas de hotel com a estratégia de lances COMMISSION . 30 de abril de 2024 As solicitações para criar novas campanhas de hotel ou aplicar a estratégia de lances COMMISSION a campanhas atuais vão resultar em um erro BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. As campanhas com a estratégia de lances COMMISSION vão continuar sendo veiculadas até 31 de outubro de 2024. Após esse dia, as campanhas vão deixar de ser veiculadas até que a estratégia de lances seja atualizada.