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.

Remarque : Dans la version 2.1 de Content API, le service Local Inventory et les flux supplémentaires remplacent le service Inventory de la version 2. Pour effectuer des mises à jour partielles de données produit qui ne sont pas en magasin avec l'API v2.1, utilisez des flux supplémentaires. Pour effectuer des mises à jour supplémentaires de produits en magasin, utilisez le service localinventory.

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.

  Remarque : Si votre compte Merchant Center n'est pas inscrit à un programme en magasin et que vous définissez le champ channel sur local via la méthode Products.insert, le message d'erreur suivant s'affiche : "Canal channel de distribution non valide : 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 channel sur local. Vous pouvez ensuite utiliser le service Local Inventory pour créer des instances d'inventaire en magasin pour chaque storecode de 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 : 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.

Remarque : Il n'est pas possible de récupérer, de répertorier ou de supprimer des instances d'inventaire en magasin. Pour afficher les données d'inventaire en magasin dans Merchant Center, sélectionnez un produit en magasin sur la page Tous les produits, puis développez la section Inventaire en magasin. Le tableau affiche les données d'inventaire en magasin pour chaque code de magasin.