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ê precisará fazer no máximo dois upgrades por ano, e não é necessário fazer isso em ordem sequencial. Por exemplo, você pode 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 |
|---|---|---|---|---|
| v18 | 16 de outubro de 2024 | Fevereiro de 2025 | 24 de setembro de 2025 | |
| 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 |
| 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 conferir uma lista de métodos e serviços que o projeto chamou recentemente usando o Console do Google Cloud:
- Abra APIs e serviços no Console do Google Cloud.
- Clique em API Google Ads na tabela.
- Na subguia METRICS, 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 do Google Ads, um serviço e um nome de método, como
google.ads.googleads.v18.services.GoogleAdsService.Mutate. - (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 desativada 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 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 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. | 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 às 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
API Google Ads |
Biblioteca de cliente para Java |
v18 |
Min: 34.0.0Max: - |
v17 |
Min: 32.0.0Max: - |
v16 |
Min: 30.0.0Max: - |
C#
API Google Ads |
Biblioteca de cliente para .NET |
v18 |
Min: 21.1.0Max: - |
v17 |
Min: 20.1.0Max: - |
v16 |
Min: 18.1.0Max: - |
PHP
API Google Ads |
Biblioteca de cliente para PHP |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.1.0Max: - |
v16 |
Min: 22.1.0Max: - |
Python
API Google Ads |
Biblioteca de cliente para Python |
v18 |
Min: 25.1.0Max: - |
v17 |
Min: 24.1.0Max: - |
v16 |
Min: 23.1.0Max: - |
Ruby
API Google Ads |
Biblioteca de cliente para Ruby |
v18 |
Min: 31.0.0Max: - |
v17 |
Min: 29.0.0Max: - |
v16 |
Min: 27.0.0Max: - |
Perl
API Google Ads |
Biblioteca de cliente para Perl |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.0.0Max: - |
v16 |
Min: 21.0.0Max: - |
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 |
|---|---|---|---|
| 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. |
| Estratégia de lances de CPC otimizado | A API Google Ads não oferece mais suporte à configuração do 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. Depois dessa data, elas serão migradas automaticamente para o custo por clique (CPC) manual.
|