L'API Merchant introduit deux nouvelles méthodes de gestion de l'inventaire :
list : permet de lister l'inventaire local et régional de vos produits.
delete : permet de supprimer l'inventaire local et régional de vos produits.
Voici une comparaison des méthodes disponibles pour gérer les inventaires :
Méthode
Content API for Shopping
API Merchant
customBatch
Oui
Non
insert
Oui
Oui
list
Non
Oui
delete
Non
Oui
Ressources
Voici ce qui a changé pour les inventaires locaux et régionaux :
Content API for Shopping
API Merchant
Description
Non compatible
name:string
Ce champ permet de différencier les ressources LocalInventory et RegionalInventory au sein d'un product. Content API for Shopping identifie l'inventaire en magasin par storeCode et productId, et l'inventaire régional par regionId et productId.
Non compatible
account:string
Ajout d'un champ permettant d'identifier le compte Merchant Center auquel appartiennent product et LocalInventory.
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/11 (UTC).
[null,null,["Dernière mise à jour le 2025/08/11 (UTC)."],[[["\u003cp\u003eThe Merchant API allows management of both local (in-store) and regional inventory for products.\u003c/p\u003e\n"],["\u003cp\u003eIt introduces new methods for inventory management like listing and removing local and regional inventory, replacing the Content API for Shopping for these operations.\u003c/p\u003e\n"],["\u003cp\u003eThere are key differences in how local and regional inventory are handled in the Merchant API compared to the Content API, including new fields and data types.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ename\u003c/code\u003e field is introduced to uniquely identify inventory resources, and \u003ccode\u003eaccount\u003c/code\u003e is added to link products and inventory to the merchant account.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eprice\u003c/code\u003e, \u003ccode\u003esalePrice\u003c/code\u003e, and \u003ccode\u003esalePriceEffectiveDate\u003c/code\u003e fields have been updated with new data types and structures in the Merchant Inventories API.\u003c/p\u003e\n"]]],["The Merchant API manages local and regional inventory, using the Inventories sub-API. Key actions include listing and removing both local and regional inventories. The API uses `POST` requests with a specific URL format. New fields like `name` and `account` were added for local and regional inventory. The `price` definition has been modified. `salePriceEffectiveDate` now uses the `TimePeriod` type and `quantity` is now an integer. Methods such as `list` and `delete` are now supported. The `customBatch` method is not.\n"],null,["# Migrate inventory management\n\nYou can use the Merchant API to manage local (in-store) and regional inventory.\n\nRequests\n--------\n\nUse the following request URL format for the [Merchant Inventories API](/merchant/api/guides/inventories/overview): \n\n POST https://merchantapi.googleapis.com/inventories/v1/\u003cvar translate=\"no\"\u003e{PARENT}\u003c/var\u003e/regionalInventories\n\n POST https://merchantapi.googleapis.com/inventories/v1/\u003cvar translate=\"no\"\u003e{PARENT}\u003c/var\u003e/localInventories\n\n\u003cvar translate=\"no\"\u003e{PARENT}\u003c/var\u003e will have the format:\naccounts/\u003cvar translate=\"no\"\u003e{ACCOUNT_ID}\u003c/var\u003e/products/\u003cvar translate=\"no\"\u003e {PRODUCT_ID}\u003c/var\u003e.\n| **Note:** In Merchant API, the Merchant Inventories API and its related endpoints are referred using the plural form \"inventories\".\n\nHere's a sample comparison for local inventory requests:\n\n| Item | Content API for Shopping | Merchant API |\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|\n| **URL** | https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e/products/\u003cvar translate=\"no\"\u003e{PRODUCT_ID}\u003c/var\u003e/localinventory | https://merchantapi.googleapis.com/inventories/v1/\u003cvar translate=\"no\"\u003e{PARENT}\u003c/var\u003e/localInventories |\n| **Identifiers** | `{MERCHANT_ID}/products/{PRODUCT_ID}` | `{NAME}` |\n\nMethods\n-------\n\nThe Merchant API introduces two new methods for inventory management:\n\n- `list`: Lets you list local and regional inventory for your products.\n- `delete`: Lets you delete local and regional inventory for your products.\n\nHere's a comparison of the available methods to manage inventories:\n\n| Method | Content API for Shopping | Merchant API |\n| `customBatch` | Yes | No |\n| `insert` | Yes | Yes |\n| `list` | No | Yes |\n| `delete` | No | Yes |\n|---------------|:------------------------:|:------------:|\n\nResources\n---------\n\nHere's what's changed for local and regional inventories:\n\n| Content API for Shopping | Merchant API | Description |\n|-------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Not supported | `name:string` | The field differentiates `LocalInventory` and `RegionalInventory` resources within a `product`. The Content API for Shopping identifies local inventory by `storeCode` and `productId`, and regional inventory by `regionId` and `productId`. |\n| Not supported | `account:string` | Added new field to identify the Merchant Center account the `product` and `LocalInventory` belong to. |\n| ` price: { `[object (Price)](/merchant/api/guides/compatibility/overview#price)` } ` | `price: {` ` `[object (Price)](/merchant/api/guides/compatibility/overview#price) `}` | [Price](/merchant/api/guides/compatibility/overview#price) definition has changed. |\n| `salePrice: {` ` `[object (Price)](/merchant/api/guides/compatibility/overview#price) `}` | `salePrice: {` ` `[object (Price)](/merchant/api/guides/compatibility/overview#price) `}` | [Price](/merchant/api/guides/compatibility/overview#price) definition has changed. |\n| `salePriceEffectiveDate: string` | `salePriceEffectiveDate: {` ` object (TimePeriod)` ` }` | `salePriceEffectiveDate` uses the new `TimePeriod` object in the Merchant Inventories API. |\n| `kind:string` | Not supported | The API doesn't support `kind`. |\n| `quantity:string` | `quantity:integer` | `quantity` takes an integer instead of string in the local inventory. |\n| Not supported | `localShippingLabel:string` | Added new field to identify the merchant center account the `product` and `regionalInventory` belong to. |\n| `\"regionId\": string` | `\"region\": string` | `regionID` is now called `region` for the regional inventory. |\n| `string` type fields with defined set of values | `enum` type fields with defined set of values | Fields within inventory attributes with defined set of values (for example `availability`, `pickupMethod`) are now `enum` type. |\n\n| **Note:** The `channel` field within product identifier is no longer present in Merchant API. Products with `LOCAL` channel in Content API for Shopping should instead set the `legacy_local` field to true."]]
