Gestion des versions
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ce guide explique comment l'API Merchant gère le contrôle de version, les versions et le cycle de vie de ses différentes versions.
Schéma de gestion des versions
L'API Merchant utilise une stratégie de gestion des versions au niveau des sous-API. Cela signifie que chaque API, par exemple Products dans l'API Merchant, aura son propre cycle de vie de version.
Versions stables des sous-API : si une sous-API est dans une version stable, toutes ses méthodes le sont également. Une version stable de sous-API est représentée par vX (par exemple, v1, v2). Il s'agit de versions majeures prêtes pour la production.
Versions alpha des sous-API : si une sous-API est en version alpha, toutes ses méthodes le sont également. Une sous-version alpha de l'API est représentée par vXalpha (par exemple, v1alpha, v2alpha). Elles contiennent des fonctionnalités expérimentales en accès anticipé destinées aux tests et à l'itération rapide. Les versions alpha ne sont pas stables, n'ont pas de durée de vie définie et peuvent être modifiées ou arrêtées avec un préavis de 30 jours.
Modifications apportées à la version
Incréments de version majeure (par exemple, de v1 à v2) : ils signalent des modifications destructives et incompatibles avec les versions antérieures, qui nécessitent une action de la part du développeur.
Seules les modifications importantes apportées aux sous-API stables auront un nouveau numéro de version. Par exemple, de la version v1 à la version v2.
Modifications mineures : les ajouts ou les corrections rétrocompatibles sont présentés comme des modifications apportées à la version majeure existante. Ces modifications seront détaillées dans les notes de version de cette version majeure. Les ajouts non destructifs à une sous-API seront publiés dans le canal alpha de la dernière version stable ou directement dans la dernière version stable.
Règles d'arrêt définitif
Nous abandonnons régulièrement les anciennes versions des sous-API Merchant. Nous nous engageons à respecter un délai de 12 mois pour l'arrêt des versions majeures stables (vX), à compter de l'annonce officielle de l'arrêt.
Par exemple, si nous abandonnons la version 1 de la sous-API Products le 15 janvier 2026, elle sera supprimée au plus tôt le 15 janvier 2027. Au-delà de cette date, l'ancienne version de la sous-API ne sera plus disponible.
Version de la sous-API et état du cycle de vie
Le tableau suivant répertorie les dernières versions de chaque sous-API de l'API Merchant :
| Sous-API |
Versions |
État |
| Comptes |
v1
v1beta |
Actif
Sera arrêté le 28 février 2026 |
| Conversions |
v1
v1beta |
Actif
Sera arrêté le 28 février 2026 |
| Sources de données |
v1
v1beta |
Active
Arrêt prévu le 28 février 2026 |
| Stocks |
v1
v1beta |
Actif
Sera arrêté le 28 février 2026 |
| Résolution des problèmes |
v1
v1beta |
Actif
Sera arrêté le 28 février 2026 |
| Partenariat pour les flux en magasin |
v1
v1beta |
Actif
Sera arrêté le 28 février 2026 |
| Notifications |
v1
v1beta |
Actif
Sera arrêté le 28 février 2026 |
| Suivi des commandes | v1
v1beta |
Actif
Sera arrêté le 28 février 2026 |
| Produits |
v1
v1beta |
Actif
Sera arrêté le 28 février 2026 |
| Product Studio |
v1alpha |
Actif |
| Promotions
|
v1
v1beta |
Actif
Sera arrêté le 28 février 2026 |
| Quota |
v1
v1beta |
Actif
Sera arrêté le 28 février 2026 |
| Création de rapports |
v1
v1beta |
Actif
Sera arrêté le 28 février 2026 |
| Avis |
v1alpha
v1 bêta |
Actif
Sera arrêté le 28 février 2026 |
Bonnes pratiques
- Consultez régulièrement les notes de version et les dernières mises à jour pour découvrir les nouvelles versions, les mises à jour majeures, les améliorations et les annonces concernant les lancements et les abandons de sous-API.
- Si une sous-API comporte au moins deux versions stables, nous vous suggérons d'utiliser la dernière version à tout moment.
- Concevez votre application pour qu'elle gère correctement les différentes erreurs de sous-API, y compris les problèmes de réseau, les limites de débit et les nouveaux codes ou messages d'erreur qui peuvent être introduits avec les nouvelles versions de sous-API.
- N'attendez pas qu'une sous-version de l'API soit sur le point d'être abandonnée pour commencer à planifier votre mise à niveau. Commencez à évaluer et à tester les nouvelles versions dès qu'elles sont disponibles.
- Pour toute demande de fonctionnalité ou question concernant la feuille de route d'une sous-API, contactez-nous. Pour savoir comment contacter l'équipe de l'API Merchant afin d'obtenir une assistance technique, consultez Obtenir de l'aide concernant l'API Merchant.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/22 (UTC).
[null,null,["Dernière mise à jour le 2025/08/22 (UTC)."],[],[],null,["# Versioning\n\nThis guide explains how Merchant API handles versioning, releases, and the\nlifecycle of its different versions.\n\nVersioning scheme\n-----------------\n\nMerchant API employs a versioning strategy at the sub-API level. This means that\neach API, for example Products within the Merchant API, will have its own\nversion lifecycle.\n\n### Versioning format and presentation\n\n- **Stable sub-API versions:** If a sub-API is in a stable version then all\n its methods are in a stable version. A stable sub-API version is represented\n as **vX** (for example, **v1** , **v2**). These are production-ready major\n versions.\n\n- **Alpha sub-API versions:** If a sub-API is in an alpha, then all its\n methods are in alpha. An alpha sub-API version is represented as\n **vXalpha** (for example, **v1alpha** , **v2alpha**). They contain\n experimental, early access features intended for testing and rapid\n iteration. Alpha versions come with no stability assurance, have no defined\n lifespan and can be changed or discontinued with a notice period of 30 days.\n\n### Version changes\n\n- **Major version increments** (for example, v1 to v2): These signal\n backward-incompatible and breaking changes, which require developer action.\n Only breaking changes of stable sub-APIs will have a new version number. For\n example, v1 to v2.\n\n- **Minor changes:** Backward compatible additions or fixes are presented as\n changes to the existing major version. Such changes will be detailed in the\n release notes for that major version. Non-breaking additions to a sub-API will\n be released to the alpha channel of the latest stable version or directly to\n the latest stable version.\n\nSunset policy\n-------------\n\nWe periodically sunset older Merchant sub-API versions. We commit to a 12-month\ndeprecation window for stable major versions (vX), starting from the official\ndeprecation announcement.\n\nFor example, if we deprecate v1 of the Products sub-API on January 15, 2026, it\nwill sunset no earlier than January 15, 2027. Beyond this date, the earlier\nversion of the sub-API will no longer be available for use.\n\nSub-API version and lifecycle status\n------------------------------------\n\nThe following table lists the latest versions of each sub-API of Merchant API:\n\n| Sub-API | Versions | Status |\n|-------------------------|----------------|-------------------------------------------|\n| Accounts | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Conversions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Data sources | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Inventories | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Issue resolution | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Local feeds partnership | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Notifications | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Order tracking | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Products | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Product Studio | v1alpha | Active |\n| Promotions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Quota | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reporting | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reviews | v1alpha v1beta | Active To be discontinued on Feb 28, 2026 |\n\nBest practices\n--------------\n\n- Regularly check the release notes and [latest\n updates](/merchant/api/latest-updates) for new versions, major updates, improvements, and announcements about sub-API launches and deprecations.\n- If a sub-API has two or more stable versions, we suggest using the latest version at all times.\n- Design your application to gracefully handle various sub-API errors, including network issues, rate limits, and the new error codes or messages that might be introduced with newer sub-API versions.\n- Don't wait until a sub-API version is about to be sunset to start planning your upgrade. Begin evaluating and testing new versions as soon as they are available.\n- For feature requests or concerns about a sub-API roadmap, [reach out to us\n with questions or feedback](/merchant/api/support/give-feedback). For information about how to contact the Merchant API team for technical support, see [Get help with Merchant API](/merchant/api/support/get-help)."]]
