Identifiants produit

Il existe différents types d'identifiants produit dans Content API for Shopping.

Identifiant de l'offre
L'offerID est attribué à un produit par un marchand. Cet identifiant est une chaîne représentant une offre particulière. L'offerId est unique pour chaque offre figurant dans la base de données Merchant Center et se compose d'une suite de chiffres. Il peut également représenter un code SKU interne attribué par le marchand au produit.
Identifiant REST

L'identifiant REST est un identifiant unique attribué à un produit par Google. Il est utilisé comme productId dans les appels d'API REST. L'identifiant REST se présente sous le format combiné online:en:US:1111111111 et se compose des quatre parties suivantes, séparées par des deux-points :

  1. Le canal ("online" ou "local")
  2. La langue du contenu (en utilisant l'abréviation à deux lettres, par exemple "en" ou "fr")
  3. Le pays cible (en utilisant l'abréviation à deux lettres, par exemple "US" ou "FR")
  4. L'identifiant de l'offre

Vous l'obtenez en combinant channel:contentLanguage:targetCountry:offerId, par exemple : online:en:US:1111111111.

Identifiant de vendeur externe (places de marché)

Les places de marché doivent attribuer un external_seller_id aux offres importées dans un compte multivendeur. Ce champ représente un vendeur particulier.

Les valeurs external_seller_id sont sensibles à la casse et doivent répondre aux critères suivants :

  • 1-50 caractères
  • Uniquement des caractères ASCII alphanumériques et des traits de soulignement (_), des traits d'union (-), des points (.) et des tildes (~)

Ce champ est différent du champ seller_id interne.

Le tableau suivant récapitule certains des identifiants pouvant être associés à un produit :

Attribut Description Exemple Notes
id Utilisation générique d'un identifiant. online:en:US:6 Utilisé dans le corps JSON du produit pour faire référence à productId.
offerId Autre nom pour l'ID de l'article. 6 Type de données de chaîne, identifiant unique pour une offre de produit.
Identifiant REST Chaîne mixte composée du canal, de la langue, du pays et de l'ID de l'offre. online:en:US:6 Identifiant mixte utilisé avec productId.
productId Chaîne de l'identifiant REST. online:en:US:6 Il s'agit d'un identifiant REST.
external_seller_id Identifiant de vendeur choisi par la place de marché. exemple-Vendeur1 Obligatoire pour les comptes multivendeurs. Doit comporter entre 1 et 50 caractères. Sensible à la casse. Les chiffres et les caractères spéciaux _, -, . et ~ sont acceptés.