Descontinuação e desativação

Com o lançamento de uma nova versão, uma versão descontinuada recebe uma data de desativação, após a qual ela não estará mais disponível. Confira outras diretrizes a serem consideradas:

  • No máximo, três versões principais estão disponíveis por vez.
  • As versões principais têm uma vida útil de cerca de 12 meses, enquanto as secundárias têm 10 meses.
  • Você precisará fazer no máximo dois upgrades por ano, e não é necessário fazer isso em ordem sequencial. Por exemplo, é possível fazer upgrade da versão (N) diretamente para a versão (N + 2).
  • O período de sobreposição entre a data de lançamento de todas as bibliotecas de cliente para a versão mais recente e a versão que será desativada é de pelo menos 20 semanas.

Nossas bibliotecas de cliente oferecem suporte a todas as versões disponíveis de um serviço. Assim, você pode fazer upgrade gradualmente especificando diferentes versões dos serviços usados.

Horários

Confira na tabela a seguir as datas específicas de desativação e suspensão de cada versão disponível e as datas de lançamento previstas para versões futuras. Recomendamos que você faça upgrade para a versão mais recente assim que possível depois do lançamento.

Versão da API Data de lançamento Data da suspensão do uso Data da desativação Guia de upgrade
v19 26 de fevereiro de 2025
v18 16 de outubro de 2024 Junho de 2025 Setembro de 2025 Fazer upgrade da v18 para a v19
v17.1 7 de agosto de 2024 16 de outubro de 2024 4 de junho de 2025 Fazer upgrade da v17 para a v18
v17 5 de junho de 2024 16 de outubro de 2024 4 de junho de 2025 Fazer upgrade da v17 para a v18

Conferir as versões que o projeto está usando

É possível conferir uma lista de métodos e serviços que o 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, você vai encontrar as solicitações recentes representadas em cada gráfico. É possível conferir os métodos para os quais você enviou solicitações na tabela Methods. 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.v19.services.GoogleAdsService.Mutate.
  4. (Opcional) Escolha o período que você quer consultar para 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 for lançada, todas as versões anteriores serão marcadas como descontinuadas. A versão com uso suspenso 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 elas sejam desativadas, mas as referências delas não são mais destacadas 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 assim que possível para aproveitar os novos recursos.

 É necessário fazer upgrade das versões descontinuadas imediatamente para usar a API Google Ads.

É altamente recomendável 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 três ou quatro meses. Portanto, a versão será descontinuada após aproximadamente três ou quatro meses. Nosso objetivo é desativar uma versão um ano após o lançamento.
API Os endpoints da API para as versões descontinuadas ainda funcionam normalmente.

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

 Os endpoints da API para as versões desativadas deixam de funcionar após as datas de desativação. A API Google Ads vai gerar um erro se você tentar acessar os endpoints da API das versões descontinuadas.
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 da API desativadas em novas versões da biblioteca de cliente após as datas de desativação.
Suporte Oferecemos suporte regular para as versões descontinuadas. As versões desativadas não têm mais suporte após a data de desativação.

Versões de biblioteca de cliente com suporte

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

Java

Biblioteca de cliente para Java
v18 Min: 34.0.0
Max: -
v17 Min: 32.0.0
Max: -
v16 Min: 30.0.0
Max: 34.0.0

C#

Biblioteca de cliente para .NET
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: -
v17 Min: 20.1.0
Max: -
v16 Min: 18.1.0
Max: 21.1.0

PHP

Biblioteca de cliente para PHP
v18 Min: 25.0.0
Max: -
v17 Min: 23.1.0
Max: -
v16 Min: 22.1.0
Max: -

Python

Biblioteca de cliente para Python
v19 Min: 25.2.0
Max: -
v18 Min: 25.1.0
Max: -
v17 Min: 24.1.0
Max: -
v16 Min: 23.1.0
Max: -

Ruby

Biblioteca de cliente para Ruby
v18 Min: 31.0.0
Max: -
v17 Min: 29.0.0
Max: -
v16 Min: 27.0.0
Max: -

Perl

Biblioteca de cliente para Perl
v18 Min: 25.0.1
Max: -
v17 Min: 23.0.0
Max: -
v16 Min: 21.0.0
Max: -

Suspensões de uso de recursos

Monitore regularmente o blog de desenvolvedores do Google Ads para saber em primeira mão sobre a descontinuação de recursos.

A tabela a seguir lista as suspensões de uso de recursos específicos que estão planejadas 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
Atualização do relatório de insights de termos de pesquisa da API e dos scripts do Google Ads a partir de 3 de março de 2025 A partir de 3 de março de 2025, os relatórios de insights de termos de pesquisa da API e dos scripts do Google Ads vão retornar todas as subcategorias de pesquisa como vazias. A interface do Google Ads já removeu esse campo, e a API também está lançando essa mudança para manter a consistência no Google Ads. 3 de março de 2025 A partir de 3 de março de 2025, todos os valores de segments.search_subcategoryvão estar vazios. Se você consultar segments.search_subcategory nos relatórios campaign_search_term_insight ou customer_search_term_insight, verifique se o código pode processar um valor vazio em segments.search_subcategory. Uma string vazia já é um coletor, então seu código já deve estar processando isso. Recomendamos remover segments.search_subcategory da consulta.
Mudanças no tamanho da página na API Google Ads Quando a v16 for descontinuada, não será mais possível definir o campo page_size ao fazer solicitações GoogleAdsService.Search. Fevereiro de 2025 Quando a v16 for desativada, todas as solicitações de GoogleAdsService.Search vão considerar um tamanho de página fixo de 10.000 linhas.
Atualização da validade da associação à Segmentação por lista de clientes A partir de 7 de abril de 2025, o campo UserList.membership_life_span não vai mais permitir valores maiores que 540. 7 de abril de 2025 De 7 a 15 de abril de 2025, vamos lançar gradualmente uma mudança no campo UserList.membership_life_span. As solicitações para definir o campo como maior que 540 vão retornar um erro RangeError.TOO_HIGH. Qualquer lista de usuários com um valor de campo maior que 540 será migrada automaticamente para ter uma duração máxima de associação de 540 dias. Consulte Atualização da expiração de associação da Segmentação por lista de clientes para mais informações.