Service d'inventaire en magasin

Le service d'inventaire en magasin vous permet de créer et de mettre à jour des instances de la ressource d'inventaire en magasin. Celles-ci présentent des champs qui peuvent contenir des valeurs différentes selon l'emplacement 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 d'inventaire en magasin. 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 d'inventaire en magasin, vous devez créer un compte Google My Business (GMB), l'associer à votre compte Merchant Center, faire valider votre entreprise et configurer vos codes de magasin GMB.
  • 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 d'inventaire en magasin 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 channel sur local. Vous pouvez ensuite utiliser le service Local Inventory pour créer des instances d'inventaire en magasin pour chaque storecode GMB où le produit est vendu.

Champs de l'inventaire en magasin

Chaque instance d'inventaire en magasin contient un ensemble de champs qui est associé à un emplacement spécifique de magasin à l'aide du champ storeCode (que vous définissez dans votre compte Google My Business). 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 de Local Inventory

Le service d'inventaire en magasin ne comprend que deux méthodes :

  • insert vous permet de créer une instance d'inventaire en magasin pour un seul produit en magasin.
  • 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.

Exemple : localinventory.insert

Cet exemple montre comment utiliser le service d'inventaire en magasin pour créer des soldes 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 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,
}