Descontinuação e desativação

Com o lançamento de uma nova versão, será definida uma data de desativação da versão obsoleta. Após essa data, ela não estará mais disponível. Lembre-se destas diretrizes:

  • No máximo, três versões principais estão disponíveis ao mesmo tempo.
  • As versões principais têm uma vida útil de aproximadamente 12 meses. As versões secundárias: 10 meses.
  • Você vai precisar realizar no máximo dois upgrades por ano e não precisará 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 que será desativada é de pelo menos 20 semanas.

Nossas bibliotecas de cliente são compatíveis com qualquer versão disponível de um serviço. Assim, você pode fazer o upgrade gradual especificando diferentes versões dos serviços usados.

Horários

A tabela abaixo lista as datas específicas de suspensão de uso e desativação de cada versão disponível, além das datas de lançamento projetadas 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.

Versão da API Data de lançamento Data da suspensão do uso Data da desativação Guia de upgrade
v18 Setembro/outubro de 2024 Janeiro/fevereiro de 2025 Setembro de 2025
v17.1 Julho/agosto de 2024 Setembro/outubro de 2024 Maio de 2025
v17 Maio/junho de 2024 Setembro/outubro de 2024 Maio de 2025
v16.1 Abr/maio 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 seu projeto está usando

Veja 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. Na tabela, clique em API Google Ads.
  3. Na subguia MÉTRICAS, você encontra suas solicitações recentes representadas em cada gráfico. Na tabela Métodos, você pode ver para quais métodos enviou solicitações. 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.v16.services.GoogleAdsService.Mutate.
  4. (Opcional) Escolha o período das suas solicitações que você quer ver.

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

TermoSuspensão de usoPôr do sol
Definição A versão descontinuada é uma versão que não é a mais recente. Depois que uma nova versão for lançada, todas as versões anteriores serão marcadas como obsoletas. 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 após essa data.
Implicação Você ainda pode usar as versões obsoletas até que elas sejam desativadas, mas as referências delas serão removidas 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 imediatamente das versões desativadas 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. Por isso, o uso da versão especificada será suspenso após aproximadamente três a quatro meses. Nosso objetivo é desativar uma versão um ano após o lançamento.
API Os endpoints de API das versões obsoletas ainda funcionam normalmente.

Acesse nossos endpoints de API usando nossas bibliotecas de cliente, REST e outros. No entanto, novos recursos não são adicionados às versões obsoletas.

Os endpoints da API das versões desativadas pararão de funcionar após as datas de desativação. A API Google Ads vai exibir um erro se você tentar acessar os endpoints de API das versões desativadas.
Bibliotecas de cliente Para fornecer bibliotecas de cliente compactas, não vamos mais incluir as versões descontinuadas da 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 aos seus projetos. As bibliotecas de cliente não são mais compatíveis com as versões da API desativadas em novas versões da biblioteca de cliente após a data de desativação.
Suporte Oferecemos suporte regular para as versões obsoletas. Após a data de desativação, não há mais suporte para as versões 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: -

C#

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

PHP

Biblioteca de cliente para PHP
v16 Min: 22.1.0
Max: -
v15 Min: 21.1.0
Max: -
v14 Min: 19.2.0
Max: -

Python

Biblioteca de cliente para Python
v15 Min: 22.1.0
Max: -
v14 Min: 21.2.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: -

Perl

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

Suspensões de uso de recursos

Acompanhe regularmente o blog de desenvolvedores do Google Ads para saber em primeira mão sobre as próximas descontinuações de recursos.

Veja na tabela abaixo as descontinuações de recursos específicos que estão planejadas para a API Google Ads. Mais detalhes de cada descontinuação podem ser encontrados 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 atuais que usam a estratégia de lances COMMISSION vão continuar sendo veiculadas até 31 de outubro de 2024. Após esse dia, as campanhas deixarão de ser veiculadas até que a estratégia de lances seja atualizada.