Service Local Inventory

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

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 : storeCode et productId (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.