Le service Local Inventory vous permet de créer et de mettre à jour des instances de la ressource Local Inventory. Celles-ci présentent des champs qui peuvent contenir des valeurs différentes selon l'adresse des magasins physiques. Chaque instance d'inventaire en magasin est l'enfant d'une ressource "Product" existante. Elle hérite des champs sur les données produit de la ressource parente. Par exemple, il se peut que le prix et la quantité de l'un de vos produits diffèrent d'un magasin à l'autre, mais que son ID, sa description et d'autres données produit le concernant soient les mêmes pour tous les magasins. Les données de l'inventaire en magasin sont utilisées pour les programmes Inventaire local sur propriétés Google et Annonces produits en magasin.
Ce guide vous présente ce dont vous avez besoin avant de commencer à utiliser le service Local Inventory. Il décrit également les champs et les méthodes disponibles, et fournit un exemple de demande de service.
Conditions préalables
- Pour utiliser le service Local Inventory, vous devez créer une fiche d'établissement, associer votre fiche d'établissement à votre compte Merchant Center, valider votre établissement et configurer les codes de magasin de votre fiche d'établissement.
Votre compte Merchant Center doit être inscrit à l'un de ces deux programmes en magasin : l'inventaire local sur propriétés Google ou les annonces produits en magasin. Pour en savoir plus sur l'utilisation des annonces produits en magasin via Content API, consultez l'article Premiers pas avec les annonces produits en magasin.
Le service Local Inventory crée des instances d'inventaire en magasin pour les produits en magasin existants. Vous devez d'abord créer des produits en magasin à l'aide du service Products API de Content API ou du flux de données de Merchant Center en définissant le champ
channelsurlocal. Vous pouvez ensuite utiliser le service Local Inventory pour créer des instances d'inventaire en magasin pour chaquestorecodede votre fiche d'établissement où le produit est vendu.
Champs
Chaque instance d'inventaire en magasin contient un ensemble de champs qui est associé à un magasin spécifique à l'aide du champ storeCode (que vous définissez dans votre fiche d'établissement). Seuls les champs storecode et productId sont obligatoires pour toutes les requêtes. Tous les autres sont facultatifs :
- Obligatoires pour toutes les requêtes :
storeCodeetproductId(dans l'URL) - Facultatifs :
quantity,price,salePrice,salePriceEffectiveDate,availability,pickupMethod,pickupSla,instoreProductLocation
Pour obtenir la liste complète des champs qui concernent l'inventaire en magasin ainsi qu'une description de chacun, consultez la page de référence localinventory.
Méthodes
Le service Local Inventory ne comprend que deux méthodes :
localinventory.insert
localinventory.insert vous permet de créer une instance d'inventaire en magasin pour un seul produit en magasin.
Cet exemple montre comment utiliser le service Local Inventory pour créer des promotions en magasin du 24 février 2021 à 13h00 (GMT-8) au 28 février 2021 à 15h30 (GMT-8). La requête met également à jour la quantité disponible pour l'instance d'inventaire en magasin. Contrairement aux flux supplémentaires pour les données des produits qui ne sont pas disponibles en magasin, les champs non inclus dans le corps de la requête sont écrasés par l'appel suivant :
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory
{
"storeCode": “1235”,
"salePrice": {
"value": “100.00”,
"currency": “USD”
},
"salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
"quantity": 200,
}
localinventory.custombatch
localinventory.custombatch vous permet de créer plusieurs instances d'inventaire en magasin pour un seul produit en magasin dans plusieurs magasins, ou de créer des instances d'inventaire en magasins pour plusieurs produits en magasin.