Gestion des versions sémantique
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, v13_0 est une version majeure, tandis que v13_1 est une version mineure.
Consultez les notes de version pour connaître les anciennes versions.
Versions majeures
Les versions majeures introduisent des modifications destructives incompatibles avec les versions antérieures.
La version se termine par zéro au format vX_0, où X est le numéro de la version majeure.
Chaque version majeure possède un point de terminaison distinct. Voici un exemple d'URL où X est le 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, passez à la dernière version. Lorsqu'une version majeure est publiée, nous vous fournissons un guide de migration pour corriger les modifications importantes dans votre code.
Exemples de modifications importantes:
- Supprimer ou renommer un service, une interface, un champ, une méthode ou une valeur d'énumération
- Modifier le type d'un champ
- Modifier un format de nom de ressource
- Modifier le format d'URL dans la définition HTTP
- Modifier les formats de sortie (par exemple, passer de
0à--) comme valeur par défaut - Modification du motif d'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'aura aucune incidence sur 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 version la plus récente.
Couchers de soleil
De temps à autre, 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 est sur le point d'être abandonnée. Le calendrier d'abandon est mis à jour avec les prochaines dates d'abandon.