Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Nous avons conçu l'API Merchant pour qu'elle soit familière aux développeurs de Content API for Shopping, tout en étant plus simple et plus flexible. Vous trouverez ci-dessous des informations détaillées sur la conception de l'API Merchant.
Sous-API
L'API Merchant est un ensemble de sous-API. Les sous-API sont des groupes de services et de ressources associés. Cette conception signifie que vous pouvez choisir d'utiliser uniquement les sous-API nécessaires à votre intégration unique.
L'API Merchant inclut les sous-API suivantes :
Comptes : gérez les comptes Merchant Center à grande échelle.
Produits : gérez les données produit, comme le prix et la disponibilité.
Sources de données : affichez et gérez les sources de données de vos produits.
Inventaires : présentez vos produits par magasin ou par région sur Google.
Rapports : consultez des données sur vos produits, vos performances et votre environnement concurrentiel sur Google.
Promotions : créez et gérez des promotions pour mettre en avant des offres spéciales sur vos produits.
Il est possible que de nouvelles valeurs soient exposées dans les champs Enum de l'API Merchant. Votre code doit être structuré de manière à pouvoir gérer les valeurs non reconnues de manière fluide. Vous devez surveiller l'occurrence de valeurs d'énumération non reconnues et intervenir pour maintenir le code à jour.
Gestion des versions
Les sous-API sont versionnées séparément. Cela signifie que vous n'avez rien à faire si nous mettons à jour une sous-API que vous n'utilisez pas. Vous ne devez mettre à jour votre code que lorsque de nouvelles versions des sous-API que vous utilisez sont publiées. Pour en savoir plus, consultez Gestion des versions.
Les versions qui se terminent par "bêta" sont susceptibles d'être modifiées ou supprimées.
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/08 (UTC).
[null,null,["Dernière mise à jour le 2025/08/08 (UTC)."],[[["\u003cp\u003eThe Merchant API offers a collection of sub-APIs for managing various aspects of your online product data and presence on Google, including accounts, products, inventory, and reports.\u003c/p\u003e\n"],["\u003cp\u003eIt's designed for flexibility, allowing developers to choose and use only the specific sub-APIs relevant to their needs.\u003c/p\u003e\n"],["\u003cp\u003eThe API supports both gRPC and REST transport mechanisms and features independent versioning for each sub-API, minimizing the impact of updates on existing integrations.\u003c/p\u003e\n"],["\u003cp\u003eAlthough in beta and subject to change, Google provides at least 30 days' notice for breaking changes, ensuring developers have ample time to adapt.\u003c/p\u003e\n"],["\u003cp\u003eThe Merchant API shares similarities with the Content API for Shopping but aims to provide a simpler and more adaptable development experience.\u003c/p\u003e\n"]]],[],null,["# Merchant API design\n\nWe designed Merchant API to be familiar to Content API for Shopping developers,\nyet simpler and more flexible. Here's some detailed information on the design of\nMerchant API.\n\nSub-APIs\n--------\n\nMerchant API is a collection of sub-APIs. The sub-APIs are groups of related\nservices and resources. This design means you can choose to use only the\nsub-APIs needed for your unique integration.\n\nMerchant API includes the following sub-APIs:\n\n- **[Accounts](/merchant/api/guides/accounts/overview)**: Manage Merchant Center accounts at scale.\n- **[Products](/merchant/api/guides/products/overview)**: Manage product data, like price and availability.\n- **[Data sources](/merchant/api/guides/data-sources/overview)**: View and manage the data sources for your products.\n- **[Inventories](/merchant/api/guides/inventories/overview):** Showcase your products by store or region on Google.\n- **[Reports](/merchant/api/guides/reports/overview):** View data on your products, performance, and competitive landscape across Google.\n- **[Promotions](/merchant/api/guides/promotions/overview)**: Create and manage promotions to showcase special offers for your products.\n- **[Local feeds\n partnership](/merchant/api/guides/local-feeds-partnership/overview)**: Upload your local product inventory feed.\n- **[Conversion sources](/merchant/api/guides/conversion-sources/overview)**: Manage conversion sources for your account.\n- **[Notifications](/merchant/api/guides/accounts/notifications)**: Manage notification subscriptions.\n- **[Quota](/merchant/api/reference/rest/quota_v1/accounts.quotas)**: Check the API quota of your accounts.\n\nTransport\n---------\n\nMerchant API's default transport mechanism is [gRPC](//grpc.io/docs/guides/).\nYou can also use\n[REST](//en.wikipedia.org/wiki/Representational_state_transfer).\n\nSee the [quickstart guide](/merchant/api/guides/quickstart#use_grpc_or_rest) for\nmore information.\n\nEnums\n-----\n\nEnum fields across Merchant API might be exposing new values in the future. Your\ncode should be structured in such a way that it can handle unrecognized values\ngracefully. You should monitor the occurrence of unrecognized enum values and\nintervene to keep the code up to date.\n\nVersioning\n----------\n\nSub-APIs are versioned separately. This means you don't need to do anything if\nwe update a sub-API that you don't use. You only need to update your code when\nnew versions of the sub-APIs you use are released. For more information, see\n[Versioning](/merchant/api/guides/versioning).\n\nVersions that end in \"beta\" are subject to change or removal.\n| **Note:** During the Merchant API beta, we might make breaking changes without updating the major version. We'll give at least 30 days of notice before making a breaking change. For the duration of the beta, all sub-APIs will remain on v1beta."]]
