L'API Search Ads 360 Reporting utilise la gestion sémantique des versions.
Il existe des versions majeures et mineures, formatées comme suit :
vMAJOR_MINOR Par exemple, v0_0 est la
première version majeure et v0_1 à la première version mineure. Le suffixe du paramètre
Le numéro de version indique le type de version: pour les versions majeures, il est toujours égal à zéro,
et pour les versions mineures,
elle est toujours supérieure à zéro.
Versions majeures
Les versions majeures introduisent des modifications destructives, c'est-à-dire des modifications qui ne sont pas rétrocompatible.
Chaque version majeure possède un point de terminaison distinct, par exemple:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
Lors de la mise à niveau d'une version majeure vers une autre, vous devrez peut-être modifier votre avant de passer au point de terminaison de la nouvelle version majeure.
Si vous utilisez une bibliothèque cliente, procédez comme suit : vous devez passer à la version la plus récente. Les nouvelles versions majeures guide de migration pour vous aider à corriger les modifications destructives apportées à 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 le format d'un nom de ressource
- Modifier le format d'URL dans la définition HTTP.
- Modifier les formats de sortie, par exemple remplacer
0par--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.
Lorsqu'une version mineure est publiée, le point de terminaison déjà utilisé est automatiquement mis à jour. Cela n'entraîne pas l'interruption de votre code. Vous pouvez continuer pour utiliser votre bibliothèque cliente existante.
Les versions mineures incluent les nouvelles fonctionnalités ou mises à jour n'ayant aucune incidence sur vos du code source. Si vous souhaitez utiliser les nouvelles fonctionnalités, vous devez mettre à niveau votre bibliothèque cliente à la dernière version.
Couchers de soleil
Lorsqu'une ancienne version de l'API Search Ads 360 Reporting doit s'arrêter, nous publier une notification dans le groupe Google searchads-api-announcements.