Gestion sémantique des versions
L'API Google Ads suit la gestion sémantique des versions lorsqu'il existe une version majeure et une version mineure. Le format de la version est MAJOR.MINOR ou vMAJOR_MINOR. Par exemple, v16_0 est une version majeure, tandis que v16_1 est une version mineure.
Consultez les notes de version pour en savoir plus sur les anciennes versions.
Versions majeures
Les versions majeures introduisent des modifications destructives et 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. Voici un exemple d'URL où 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 point de terminaison de la nouvelle version majeure. Si vous utilisez nos bibliothèques clientes, passez à la dernière version. Lorsqu'une version majeure sera disponible, nous vous fournirons un guide de migration que vous devrez parcourir pour corriger les modifications destructives de votre code.
Voici quelques exemples de modifications destructives:
- Suppression ou renommage 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
- Modification du format d'un nom de ressource
- Modification du format d'URL dans la définition HTTP.
- Modification des formats de sortie, par exemple en passant de
0à--comme valeur par défaut. - Modification du motif de l'erreur renvoyé de A à B.
Versions mineures
Les versions mineures n'introduisent que des modifications rétrocompatibles. Pour une version mineure, vMAJOR_MINOR aurait 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'entraînera pas le 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 dernière version.
Couchers de soleil
Vous devrez régulièrement abandonner les anciennes versions de l'API Google Ads. Nous publierons des notifications sur le blog des développeurs lorsqu'une version sera sur le point d'être abandonnée. Le planning d'abandon est mis à jour avec les dates d'abandon futures.