Gestion sémantique des versions
L'API Google Ads suit la gestion sémantique des versions avec un numéro de version majeure et un numéro de version mineure. Les versions sont écrites sous la forme MAJOR.MINOR ou vMAJOR.MINOR.
Par exemple, v26.0 (ou v26) est une version majeure, tandis que v26.1 est une version mineure.
Consultez les notes de version pour en savoir plus sur les versions actuelles et passées.
Versions majeures
Les versions majeures introduisent des modifications incompatibles avec les versions antérieures. La version initiale d'une version majeure se termine par zéro (vX.0 ou vX, où X est le numéro de version majeure).
Chaque version majeure possède un chemin de point de terminaison REST et gRPC distinct (vX), qui n'inclut pas le suffixe de la version mineure. Dans l'URL suivante, X est le numéro de version majeure (par exemple, v26) :
https://googleads.googleapis.com/vX
Si vous effectuez une mise à niveau à partir d'une version majeure plus ancienne, 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, passez à la version de la bibliothèque cliente compatible avec la nouvelle version majeure. Lorsqu'une version majeure est publiée, nous fournissons un guide de mise à niveau pour vous aider à résoudre les modifications destructives dans votre code.
Voici quelques exemples de modifications destructives :
- Suppression ou changement de 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 le format d'un nom de ressource.
- Modification du format de l'URL dans la définition HTTP.
- Modifier les formats de sortie, par exemple en modifiant les valeurs 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 a un numéro MINOR supérieur à zéro (par exemple, v26.1).
Lorsqu'une version mineure est publiée, le point de terminaison de la version majeure existante (https://googleads.googleapis.com/vX) est automatiquement mis à jour sur place. Tous les appels d'API vers une version majeure spécifique sont toujours dirigés vers la dernière version mineure correspondante. L'API Google Ads ne permet pas d'appeler des versions mineures spécifiques.
Vous n'avez pas besoin de modifier le chemin d'accès à la version dans les URL de vos points de terminaison, et le code existant continue de fonctionner sans interruption. La durée de vie des versions mineures n'est pas suivie séparément. En revanche, les versions mineures partagent la même date d'abandon que leur version majeure correspondante.
Les versions mineures ajoutent des fonctionnalités ou des mises à jour qui n'affectent pas votre code existant. Pour utiliser les champs ou les fonctionnalités d'une version mineure avec une bibliothèque cliente, mettez à niveau votre bibliothèque cliente vers une version incluant les définitions de la version mineure.
Abandon et arrêt
L'API Google Ads gère plusieurs versions majeures actives à tout moment. Régulièrement, les versions antérieures sont obsolètes, puis abandonnées :
- Obsolète : une version n'est considérée comme obsolète que si elle est explicitement marquée comme telle. Les appels d'API vers des versions obsolètes continuent de réussir jusqu'à leur date d'arrêt.
- Abandon : une version est désactivée à sa date d'abandon, et tous les appels d'API vers son point de terminaison échouent.
Nous publions des annonces sur le blog des développeurs avant l'abandon d'une version. Consultez le calendrier d'abandon et d'arrêt pour connaître les dates d'activation, d'abandon et d'arrêt prévues.