Gestion des versions

Objectif : comprendre le fonctionnement de la gestion des versions de l'API Google Ads.

Gestion sémantique des versions

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

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

Versions majeures

Les versions majeures introduisent des modifications incompatibles avec les versions antérieures. La version se terminerait par zéro au format vX_0, où X est le numéro de version majeure.

Chaque version majeure possède un point de terminaison distinct. Dans cet exemple d'URL, X correspond au numéro de 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 nouvel point de terminaison de version majeure. Si vous utilisez nos bibliothèques clientes, passez à la version la plus récente. Lorsqu'une version majeure est publiée, nous fournissons un guide de migration que vous devez consulter pour corriger les modifications incompatibles dans votre code.

Voici quelques exemples de modifications majeures :

• Suppression ou modification du nom d'un service, d'une interface, d'un champ, d'une méthode ou d'une valeur d'énumération.
• Modifier le type d'un champ
• Modifier un format de nom de ressource
• Modifier le 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 nombre MINOR supérieur à zéro.

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

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

Couchers de soleil

De temps en temps, les anciennes versions de l'API Google Ads devront être abandonnées. Nous publierons des notifications sur le blog des 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'arrêt.