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:
- Abra APIs e serviços no console do Google Cloud.
- Clique em API Google Ads na tabela.
- 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
. - (Opcional) Escolha o período das 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 é 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
API Google Ads |
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#
API Google Ads |
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
API Google Ads |
Biblioteca de cliente para PHP |
v16 |
Min: 22.1.0 Max: – |
v15 |
Min: 21.1.0 Max: – |
Python
API Google Ads |
Biblioteca de cliente para Python |
v16 |
Min: 23.1.0 Max: – |
v15 |
Min: 22.1.0 Max: – |
Ruby
API Google Ads |
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
API Google Ads |
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.
|