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, e as secundárias, de 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).
• 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. 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	16 de outubro de 2024	Fevereiro de 2025	24 de setembro de 2025
v17.1	7 de agosto de 2024	Set/out de 2024	4 de junho de 2025	Fazer upgrade da v17 para a v18
v17	5 de junho de 2024	Set/Out 2024	4 de junho de 2025	Fazer upgrade da v17 para a v18
v16.1	24 de abril de 2024	5 de junho de 2024	5 de fevereiro de 2025	Fazer upgrade da v16 para a v17
v16	21 de fevereiro de 2024	5 de junho de 2024	5 de fevereiro de 2025	Fazer upgrade da v16 para a v17

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 METRICS, 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 do Google Ads, um serviço e um nome de método, como google.ads.googleads.v18.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

Termo	Suspensão de uso	Pô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 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 assim que possível para aproveitar os novos recursos.	Você precisa 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.
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.	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 deixam 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 descontinuadas.
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 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 essa 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 saber sobre as futuras descontinuações de recursos.

A tabela a seguir 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.

Recurso	Descrição	Início da vigência	Outras observações
Mudanças no tamanho da página na API Google Ads	Quando a v16 for desativada, não será mais possível definir o campo page_size ao fazer solicitações GoogleAdsService.Search.	Janeiro de 2025	Quando a v16 for desativada, todas as solicitações GoogleAdsService.Search vão assumir um tamanho de página fixo de 10.000 linhas.
Estratégia de lances de CPC otimizado	A API Google Ads não é mais compatível com a definição de ECPC como estratégia de lances para campanhas de pesquisa e de display.	Outubro de 2024	As solicitações para definir o campo enhanced_cpc_enabled como TRUE em uma estratégia de lances resultam em um erro BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. As campanhas atuais com a estratégia de lances de ECPC vão continuar sendo veiculadas até 15 de março de 2025. Após esse dia, eles serão migrados automaticamente para o custo por clique (CPC) manual.