Gestion des versions

Gestion sémantique des versions

L'API Google Ads suit une gestion sémantique des versions, avec une version majeure et une version mineure. Le format de la version est MAJOR.MINOR ou vMAJOR_MINOR. Par exemple, v25_0 est une version majeure, tandis que v25_1 est une version mineure.

Consultez les notes de version des versions précédentes.

Versions majeures

Les versions majeures présentent des modifications majeures incompatibles avec les versions antérieures. La version se termine par zéro au format vX_0, où X correspond au numéro de la version majeure.

Chaque version majeure possède un point de terminaison distinct. Dans cet exemple d'URL, X correspond au numéro de la version majeure.

https://googleads.googleapis.com/vX

Si vous effectuez une mise à niveau à partir d'une ancienne version majeure, votre code peut nécessiter des modifications lorsque vous passez au nouveau point de terminaison de la version majeure. Si vous utilisez nos bibliothèques clientes, effectuez une mise à niveau vers la version la plus récente. Lorsqu'une version majeure est publiée, nous fournissons un guide de migration que vous devez suivre pour corriger les modifications majeures dans votre code.

Voici quelques exemples de modifications majeures :

• Suppression ou modification du nom du service, d'une interface, d'un champ, d'une méthode ou d'une valeur d'énumération
• Modification du type d'un champ
• Modification d'un format de nom de ressource
• Modification du format de l'URL dans la définition HTTP
• Modification des formats de sortie, par exemple en remplaçant 0 par -- comme valeur par défaut
• Modification de la raison de l'erreur renvoyée de A à B

Versions mineures

Les versions mineures n'introduisent que des modifications rétrocompatibles. Pour une version mineure, vMAJOR_MINOR aura un MINOR numéro supérieur à zéro.

Lorsqu'une version mineure est publiée, le point de terminaison déjà utilisé est automatiquement mis à jour. Cela n'entraînera pas de dysfonctionnement de votre code. Vous pouvez continuer à utiliser vos bibliothèques clientes existantes.

Les versions mineures incluent de nouvelles fonctionnalités ou mises à jour qui n'affectent pas votre code existant. Si vous souhaitez utiliser ces nouvelles fonctionnalités, mettez à niveau vos bibliothèques clientes vers la version la plus récente.

Abandons

De temps en temps, les anciennes versions de l'API Google Ads doivent être abandonnées. Nous publierons des avis sur le blog pour les développeurs lorsqu'une version sera sur le point d'être abandonnée. Le calendrier d'abandon est mis à jour avec les futures dates d'abandon.