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:
- Abra APIs e serviços no console do Google Cloud.
- Na tabela, clique em API Google Ads.
- 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
. - (Opcional) Escolha o período das suas solicitações que você quer ver.
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 é 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
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: - |
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: - |
PHP
API Google Ads |
Biblioteca de cliente para PHP |
v16 |
Min: 22.1.0 Max: - |
v15 |
Min: 21.1.0 Max: - |
v14 |
Min: 19.2.0 Max: - |
Python
API Google Ads |
Biblioteca de cliente para Python |
v15 |
Min: 22.1.0 Max: - |
v14 |
Min: 21.2.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: - |
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: - |
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.
|