Le flux d'inventaire de produits en magasin est une liste des produits que vous vendez dans vos magasins. Certains attributs sont obligatoires pour tous les articles, tandis que d'autres sont requis pour un type d'article spécifique ou simplement recommandés.
Le prix et la disponibilité des produits d'un inventaire peuvent changer fréquemment selon les magasins. Vous pouvez augmenter la fréquence d'importation de votre flux pour mettre à jour vos données d'inventaire plus fréquemment. Si vous rencontrez des difficultés au niveau de la fréquence d'importation de votre flux, contactez notre équipe d'assistance à l'aide de ce formulaire. Sachez également que la synchronisation de vos établissements dans votre compte Merchant Center peut prendre jusqu'à 24 heures. Nous vous recommandons donc d'importer votre flux d'inventaire 24 heures après l'association des comptes, ou après la modification ou la mise à jour d'un code de magasin dans vos fiches d'établissement.
Pour envoyer des données produit via l'API, consultez le guide sur Google Content API.
Envoyer des flux d'inventaire de produits en magasin
Type de fichier : le flux d'inventaire de produits en magasin est disponible sous forme de fichier texte délimité par des tabulations ou fichier XML, ou via une API.
Créer un flux d'inventaire de produits en magasin : pour créer et enregistrer un flux d'inventaire de produits en magasin, suivez ces instructions.
Important : Certains attributs des spécifications du flux d'inventaire de produits en magasin contiennent des espaces et des traits de soulignement. Pour vous assurer d'envoyer des attributs avec des caractères et des espaces corrects, suivez les instructions ci-dessous selon votre type de fichier :
- Flux délimités par des tabulations : les espaces sont obligatoires. Si l'attribut présente des traits de soulignement, utilisez un espace au lieu de "_".
- API XML ou API JSON : les traits de soulignement sont obligatoires et sont convertis en espaces blancs une fois le fichier reçu.
Récapitulatif des attributs obligatoires
| Attribut | Utilisation de l'attribut | |
|---|---|---|
| Détails obligatoires sur l'inventaire |
Code de magasin |
Obligatoire pour tous les produits. Remarque : La valeur de l'attribut code de magasin |
| Détails facultatifs sur l'inventaire |
Période de validité du prix soldé Quantité |
Recommandé, car applicable à chaque article de votre flux pour fournir plus de détails sur le prix, la quantité et la livraison le même jour. Le prix est facultatif s'il s'agit du prix par défaut pour le pays concerné. Il est obligatoire s'il est différent pour un magasin donné. |
| Détails facultatifs sur le retrait en magasin |
Méthode de retrait en magasin Disponibilité pour retrait |
Recommandé, car applicable à tous les articles de votre flux qui peuvent être retirés en magasin. Important : À partir du 1er septembre 2024, l'attribut méthode de retrait en magasin |
| Détails facultatifs sur la livraison en magasin | Étiquette de livraison en magasin [local_shipping_label] |
Obligatoire dans votre flux si vous souhaitez activer la livraison le même jour lorsque seuls certains produits d'un magasin donné peuvent être livrés le même jour. |
Détails obligatoires sur l'inventaire
Ces attributs donnent des informations de base sur l'inventaire par article et par magasin.
[store_code] : identifiant de magasin dans les fiches d'établissement
Code alphanumérique propre à chaque établissement local. Cet attribut est sensible à la casse et doit correspondre aux codes de magasin que vous avez indiqués dans vos fiches d'établissement.
Utilisation de l'attribut : obligatoire pour tous les articles de votre flux.
| Type | Texte (chaîne de caractères) |
| Format texte/délimité par des tabulations | Magasin123 |
| Exemple de code XML | <g:store_code>Magasin123</g:store_code> |
[id] : identifiant de l'article
Code produit alphanumérique unique désignant un même article dans tous vos magasins.
Si vous vendez le même article dans plusieurs magasins, la valeur de l'attribut identifiant sera identique pour les différents codes de magasin. Vous devez inclure un attribut identifiant [id] par magasin et utiliser l'attribut disponibilité [availability] pour indiquer si un article est en stock dans ce magasin.
Si vous possédez plusieurs flux du même type pour un pays, les identifiants des articles contenus dans les différents flux doivent tout de même être uniques. Si vos SKU n'apparaissent qu'une fois dans votre inventaire et qu'ils sont conformes aux exigences indiquées ci-dessous, nous vous conseillons de les utiliser pour cet attribut.
Utilisation de l'attribut : obligatoire pour tous les articles de votre flux.
| Type | Texte (chaîne de caractères) |
| Format texte/délimité par des tabulations | 421486 |
| Exemple de code XML | <g:id>421486</g:id> |
Important :
- Les valeurs de l'attribut identifiant doivent être les mêmes pour vos flux principaux et vos flux d'inventaire de produits en magasin.
- Les retours chariot (0x0D) ainsi que les espaces en début et en fin de texte doivent être supprimés.
- Chaque séquence de retours chariot (0x0D) et de caractères d'espace (caractères Unicode avec la propriété d'espace) doit être remplacée par une espace simple (0x20).
- Seuls les caractères Unicode valides sont acceptés, à l'exception des caractères suivants :
- Caractères de contrôle (à l'exception du retour chariot 0x0D)
- Caractères de fonction
- Caractères de zone à usage privé
- Paires de substitution
- Points de code non assignés (en particulier tout point de code supérieur à 0x10FFFF)
- Lors de l'envoi d'un article, vous ne devez pas modifier son attribut identifiant
[id]lorsque vous mettez à jour votre flux de données. Vous ne devez pas non plus l'utiliser ultérieurement pour un autre produit. - N'incluez que les produits disponibles en magasin.
[availability] : indique la disponibilité de l'article
- in stock [en stock] : l'article est en stock dans votre magasin.
- out of stock [non disponible] : l'article n'est plus disponible dans votre magasin.
- limited availability [disponibilité limitée] : il ne reste plus que quelques articles en stock dans votre magasin.
- on display to order [exposé et disponible sur commande] : l'article est disponible sur commande dans votre magasin (par exemple, un réfrigérateur qui doit être expédié depuis un entrepôt). Si vous définissez également l'attribut quantité
[quantity], indiquez la valeur "1" pour les articles exposés et disponibles sur commande.
| Type | Texte (chaîne). Seules quatre valeurs sont acceptées : "in stock", "out of stock", "limited availability" ou "on display to order". |
| Format texte/délimité par des tabulations | en stock |
| Exemple de code XML | <g:availability>en stock</g:availability> |
Détails facultatifs sur l'inventaire
Vous pouvez utiliser ces attributs pour donner des informations supplémentaires sur le prix, la quantité et la disponibilité de vos articles.
[price] : prix de l'article
Il s'agit du prix standard de votre article. Si vous fournissez une valeur pour cet attribut dans le flux d'inventaire et dans le flux principal, le prix indiqué dans le flux d'inventaire remplacera celui indiqué dans le flux principal pour le magasin associé.
Utilisation de l'attribut : obligatoire pour tous les articles de votre flux.
| Type | Nombre (La devise utilisée est celle du pays où se trouve votre magasin.) |
| Format texte/délimité par des tabulations | 299.99 |
| Exemple de code XML | <g:price>299.99</g:price> |
[sale_price] : prix soldé annoncé de l'article
Prix soldé annoncé pendant une période limitée qui remplace dans un magasin donné l'attribut prix [price] défini dans ce flux et dans le flux de produits en magasin.
Nous vous recommandons de définir l'attribut période de validité du prix soldé [sale_price_effective_date] pour tous les articles dont les prix sont soldés, car cela détermine la période pendant laquelle ces articles affichent un prix soldé. Si aucune valeur n'est définie pour l'attribut période de validité du prix soldé, le prix soldé reste appliqué pour l'article concerné tant qu'il est inclus dans votre flux.
| Type | Nombre |
| Format texte/délimité par des tabulations | 279.99 |
| Exemple de code XML | <g:sale_price>279.99</g:sale_price> |
[sale_price_effective_date].[sale_price_effective_date] : période au cours de laquelle l'article est soldé
Dates de validité du prix soldé annoncé.
En savoir plus sur la définition du prix soldé
| Type | Texte (chaîne de caractères), ISO 8601, en séparant les dates de début et de fin par une barre oblique (/) |
| Format texte/délimité par des tabulations |
Exemple UTC : Toutes les heures sont exprimées au format 24 heures. |
| Exemple de code XML | <g:sale_price_effective_date>2021-07-19T09:00-0800/2021-07-26T21:00-0800</g:sale_price_effective_date> |
[quantity] : nombre d'articles en stock
Nombre d'articles en stock dans le magasin. Si vous incluez des articles qui sont temporairement indisponibles, vous devez indiquer la valeur "0" pour cet attribut.
L'attribut quantité n'est plus obligatoire. Assurez-vous plutôt d'indiquer la disponibilité pour l'ensemble de votre inventaire.
| Type | Entier |
| Format texte/délimité par des tabulations | 4 |
| Exemple de code XML | <g:quantity>4</g:quantity> |
Important :
- Pour Google, les articles "en stock" sont disponibles en au moins trois exemplaires, les articles en "disponibilité limitée" sont disponibles en un ou deux exemplaires, et les articles "non disponibles" ne sont plus disponibles.
- Si vous choisissez d'indiquer la quantité et la disponibilité, l'inventaire est classé selon la valeur la plus faible entre la disponibilité et la quantité.
Détails facultatifs sur le retrait en magasin
Ajoutez ces attributs à votre flux d'inventaire de produits en magasin pour fournir des informations de retrait spécifiques au magasin.
Méthode de retrait en magasin[pickup_method] : option de retrait en magasin pour l'article
[pickup_method] ne sera plus obligatoire.Indiquez l'option de retrait en magasin pour l'article.
- buy [acheter] : la transaction est effectuée intégralement en ligne.
- reserve [réservation] : l'article est réservé en ligne, et la transaction est effectuée en magasin.
- ship to store [livraison en magasin] : l'article est acheté en ligne et livré dans un magasin pour y être retiré par le client.
- not supported [non disponible] : le retrait en magasin n'est pas disponible pour cet article.
| Type | Texte (chaîne). Doit correspondre à l'une des quatre valeurs acceptées :
"buy" [acheter], "reserve" [réservation], "ship to store" [livraison en magasin] ou "not supported" [non disponible] |
| Format texte/délimité par des tabulations | buy |
| Exemple de code XML | <g:pickup_method>buy</g:pickup_method> |
[pickup_sla] : chronologie du retrait en magasin pour l'article
Indiquez la date à laquelle la commande pourra être retirée en magasin en fonction du moment où elle a été passée.
- same day [même jour] : indique que l'article peut être retiré le jour même où la commande est passée, à condition qu'elle soit effectuée avant l'heure limite.
- next day [jour suivant] : indique que l'article peut être retiré le lendemain de la commande.
- 2-day [2 jours] : indique que l'article sera livré dans un magasin pour y être retiré par le client dans un délai de deux jours.
- 3-day [3 jours] : indique que l'article sera livré dans un magasin pour y être retiré par le client dans un délai de trois jours.
- 4-day [4 jours] : indique que l'article sera livré dans un magasin pour y être retiré par le client dans un délai de quatre jours.
- 5-day [5 jours] : indique que l'article sera livré dans un magasin pour y être retiré par le client dans un délai de cinq jours.
- 6-day [6 jours] : indique que l'article sera livré dans un magasin pour y être retiré par le client dans un délai de six jours.
- multi-week [plus d'une semaine] : indique que l'article sera livré dans un magasin pour y être retiré par le client dans un délai supérieur à une semaine.
| Type | Texte (chaîne). Doit correspondre à l'une des huit valeurs acceptées :
"same day" [même jour], "next day" [jour suivant], "2-day" [2 jours], "3-day" [3 jours], "4-day" [4 jours], "5-day" [5 jours], "6-day" [6 jours] ou "multi-week" [plus d'une semaine] |
| Format texte/délimité par des tabulations | same day |
| Exemple de code XML | <g:pickup_sla>same day</g:pickup_sla> |
Détails facultatifs sur la livraison en magasin
Ajoutez cet attribut à votre flux d'inventaire de produits en magasin pour fournir des informations sur la livraison en magasin.
Étiquette de livraison en magasin [local_shipping_label]
Si vous souhaitez activer la livraison le même jour lorsque seule une partie de votre inventaire en magasin dans un magasin donné est disponible pour la livraison le même jour, vous devez ajouter l'attribut étiquette de livraison en magasin [local_shipping_label] à vos flux d'inventaire de produits en magasin.
La valeur indiquée pour cet attribut doit correspondre au nom du ou des étiquettes de livraison le même jour que vous avez créées dans vos paramètres de livraison le même jour au niveau du compte. Chaque étiquette de livraison le même jour représente un groupe unique de paramètres de livraison le même jour et est ajoutée aux produits éligibles sélectionnés dans votre flux d'inventaire de produits en magasin.
Pour configurer encore davantage vos articles disponibles pour une livraison le même jour, vous pouvez définir votre rayon de livraison maximal en miles ou en kilomètres. Vous pouvez également spécifier une heure limite pour commander afin de profiter d'une livraison au cours de la journée (en indiquant un nombre d'heures avant la fermeture du magasin ou en renseignant une heure précise). Enfin, vous pouvez signaler si vos articles disponibles pour une livraison le même jour seront livrés le lendemain lorsqu'ils sont commandés après l'heure limite.
Cet attribut est facultatif si tous vos magasins et tous vos produits proposent la livraison le même jour, ou si tous vos produits d'une liste de magasins éligibles proposent la livraison le même jour. En savoir plus sur la livraison le même jour