Controle de versões

Controle de versão semântico

A Google Ads API segue o controle de versões semântico quando há um uma versão maior e uma menor. O formato da versão é MAJOR.MINOR ou vMAJOR_MINOR. Por exemplo, v17_0 é uma versão principal, enquanto v17_1 é uma versão secundária.

Consulte as notas da versão para ver as versões anteriores.

Versões principais

As principais versões de lançamento introduzem algumas alterações interruptivas e incompatíveis com versões anteriores. A versão terminaria em zero com o formato vX_0, em que X é o principal. número da versão.

Cada versão principal tem um endpoint separado. Este é um exemplo de URL em que X é o número da versão principal.

https://googleads.googleapis.com/vX

Se estiver fazendo upgrade de uma versão principal mais antiga, seu código pode exigir quando você muda para o novo endpoint da versão principal. Se você estiver usando nossa bibliotecas de cliente e faça upgrade para a versão mais recente. Quando houver uma versão principal lançada, forneceremos um guia de migração que você deve corrigir todas as alterações interruptivas no código.

Exemplos de alterações interruptivas:

• Remover ou renomear um serviço, interface, campo, método ou valor de enumeração.
• Alterar o tipo de um campo.
• Alterar o formato de um nome de recurso.
• Alterar o formato do URL na definição de HTTP.
• Mudar formatos de saída, por exemplo, de 0 para -- como valor padrão.
• Alterar o motivo do erro retornado de A para B.

Versões secundárias

As versões secundárias introduzem apenas mudanças compatíveis com versões anteriores. Para uma versão secundária, vMAJOR_MINOR teria um número de MINOR maior que zero.

Quando uma versão secundária for lançada, o endpoint que já está em uso serão atualizadas automaticamente. Isso não causará falhas no código. Você pode continuar usando as bibliotecas de cliente atuais.

As versões secundárias incluem novos recursos ou atualizações que não afetam sua código existente. Se quiser usar esses novos recursos, faça upgrade do bibliotecas de cliente para a versão mais recente.

Elementos desativados

Periodicamente, as versões mais antigas da API Google Ads precisarão ser desativadas. Postaremos avisos no blog do desenvolvedor quando uma versão está prestes a ser desativada. A A programação de descontinuação é atualizada com a futura desativação datas