L'API Search Ads 360 Reporting utilise la gestion sémantique des versions.
Il existe des versions majeures et mineures, au format vMAJOR_MINOR. Par exemple, v0_0 correspond à la première version majeure et v0_1 à la première version mineure. Le suffixe du numéro de version indique le type de version. Il est toujours égal à zéro pour les versions majeures et supérieur à zéro pour les versions mineures.
Versions majeures
Les versions majeures introduisent des modifications radicales, c'est-à-dire des modifications qui ne sont pas rétrocompatibles.
Chaque version majeure dispose d'un point de terminaison distinct, par exemple:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
Lorsque vous passez d'une version majeure à une autre, vous devrez peut-être modifier votre code avant de passer au point de terminaison de la nouvelle version majeure.
Si vous utilisez une bibliothèque cliente, vous devez passer à la dernière version. Les nouvelles versions majeures fournissent un guide de migration pour vous aider à corriger les modifications destructives dans votre code.
Voici quelques exemples de modifications destructives:
- 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.
- Modification des formats de sortie, par exemple en remplaçant
0par--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.
Lorsqu'une version mineure est publiée, le point de terminaison déjà utilisé est automatiquement mis à jour. Cela n'entraînera pas la corruption de votre code. Vous pouvez continuer à utiliser votre bibliothèque cliente existante.
Les versions mineures incluent les nouvelles fonctionnalités ou mises à jour qui n'affectent pas votre code existant. Si vous souhaitez utiliser les nouvelles fonctionnalités, vous devez mettre à niveau votre bibliothèque cliente vers la dernière version.
Couchers de soleil
Lorsqu'une ancienne version de l'API Search Ads 360 Reporting est prévue pour être abandonnée, nous publions une notification dans le groupe Google searchads-api-announcements.