Gestion des versions

Gestion sémantique des versions

L'API Google Ads suit la 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, v18_0 est une version majeure, tandis que v18_1 est une version mineure.

Pour en savoir plus sur les versions précédentes, consultez les notes de version.

Versions majeures

Les versions majeures introduisent des modifications non rétrocompatibles et cassantes. La version se termine par un zéro au format vX_0, où X correspond au numéro de version majeur.

Chaque version majeure dispose d'un point de terminaison distinct. Voici un exemple d'URL où X correspond au numéro de version majeure.

https://googleads.googleapis.com/vX

Si vous passez d'une ancienne version majeure, votre code peut nécessiter des modifications lorsque vous passez au point de terminaison de la nouvelle version majeure. Si vous utilisez nos bibliothèques clientes, passez à la dernière version. Lorsqu'une version majeure est publiée, nous vous fournissons un guide de migration que vous devez suivre pour corriger les modifications non compatibles de 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 d'A à B.

Versions mineures

Les versions mineures n'introduisent que des modifications rétrocompatibles. Pour une version mineure, vMAJOR_MINOR a 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 ne cassera pas votre code. 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 à niveau vos bibliothèques clientes vers la dernière version.

Couchers de soleil

De temps en temps, les anciennes versions de l'API Google Ads doivent être abandonnées. Nous publierons des avis 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 dates d'abandon à venir.