Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Voici les différents types d'identifiants produit disponibles dans Content API for Shopping :
Identifiant de l'offre
Un identifiant offerId est une chaîne attribuée à un produit par un marchand. Il représente un produit individuel.
L'identifiant offerId est unique pour chaque offre figurant dans la base de données Merchant Center. Il se compose d'une suite de chiffres.
L'identifiant offerId peut être un code SKU interne attribué au produit par le marchand.
Identifiant REST
Un identifiant REST est un identifiant unique attribué à un produit par Google.
C'est l'identifiant productId utilisé pour les appels d'API REST.
Il se présente sous le format combiné online:en:label:1111111111 et se compose des quatre parties suivantes, séparées par des deux-points :
Le canal ("online" ou "local")
La langue du contenu (en utilisant l'abréviation à deux lettres, par exemple en ou fr)
Le libellé du flux (il peut s'agir du code à deux lettres correspondant au pays cible du flux, par exemple US ou FR)
L'identifiant de l'offre
Vous l'obtenez en combinant channel:contentLanguage:feedLabel: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
Remarques
offerId
Un identifiant attribué à un produit par un marchand.
1111111111
Type de données de chaîne, identifiant unique pour une offre de produit.
Identifiant REST
Un identifiant attribué à un produit par Google, au format channel:contentLanguage:feedLabel:offerId.
online:en:label:1111111111
Identifiant complet, y compris offerId.
productId
Utilisé pour faire référence à l'identifiant REST dans les appels d'API.
online:en:label:1111111111
L'identifiant REST d'un produit.
id
Valeur identique à l'identifiant REST et productId.
online:en:label:1111111111
Utilisé dans le corps JSON d'un produit pour faire référence à son productId.
external_seller_id
Identifiant de vendeur choisi par la place de marché.
example-Seller1
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/13 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/13 (UTC)."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of product data integration with Google.\u003c/p\u003e\n"],["\u003cp\u003eThe beta version of the Merchant API is now available for developers to explore and help shape its future development.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can learn more about the benefits and features of the Merchant API, including how it can enhance integrations, in the official announcement blog post.\u003c/p\u003e\n"],["\u003cp\u003eProducts in the Merchant API are identified using various IDs, such as \u003ccode\u003eofferId\u003c/code\u003e, REST ID, \u003ccode\u003eproductId\u003c/code\u003e, and \u003ccode\u003eexternal_seller_id\u003c/code\u003e, each with specific characteristics and usage contexts.\u003c/p\u003e\n"],["\u003cp\u003eA comprehensive table provides detailed explanations and examples of different product ID attributes, outlining their purpose and format.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. Merchants assign an `offerId` to products. Google assigns a unique REST ID in the format `channel:contentLanguage:feedLabel:offerId`; this is also the `productId` and `id` in API calls. Marketplaces assign `external_seller_id` to offers for multi-seller accounts, it has specific format requirements. The Merchant API offers integration improvements; details on this and providing feedback are available via a linked article.\n"],null,["# Product IDs\n\nHere are the different kinds of product IDs in the Content API for Shopping:\n\nOffer ID\n: An `offerId` is a string assigned to a product by a merchant. This ID\n represents an individual product.\n: `offerId` is unique to the set of offers in the Merchant Center database, and\n is usually a numeric sequential number.\n: `offerId` can be an internal SKU number that a merchant assigns to the product.\n\nREST ID\n: A REST ID is the unique identifier for a product assigned by Google.\n: REST ID is the `productId` for REST API calls.\n\n: REST IDs are aggregates with the format `online:en:label:1111111111`. The\n REST ID consists of the following 4 parts, separated by colons:\n\n 1. Channel (\"online\" or \"local\")\n 2. Content Language (using the 2-letter designation, for example `en` or `fr`)\n 3. Feed label (might be the two-letter code for the feed's target country, for example `US` or `FR`)\n 4. Offer ID\n\n: You put this together as `channel:contentLanguage:feedLabel:offerId`, for\n example, `online:en:US:1111111111`.\n\nExternal Seller ID (Marketplaces)\n\n: [Marketplaces](//support.google.com/merchants/answer/6363319)\n must assign an `external_seller_id` to offers uploaded to a multi-seller\n account. This field represents an individual seller.\n\n `external_seller_id` values are case-sensitive, and must meet the following\n criteria:\n\n - 1-50 characters in length\n - Only alphanumeric ASCII characters, and underscore (_), hyphen (-), period (.), and tilde (\\~)\n\n This isn't the same as the internal\n [`seller_id`](/shopping-content/reference/rest/v2.1/accounts) field.\n\nThe following table summarizes some of the IDs that can be associated with a\nproduct:\n\n| Attribute | Description | Example | Notes |\n|----------------------|---------------------------------------------------------------------------------------------------|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| `offerId` | An ID assigned to a product by a merchant. | `1111111111` | String data type, unique identifier for a product's offer. |\n| REST ID | An ID assigned to a product by Google. In the format `channel:contentLanguage:feedLabel:offerId`. | `online:en:label:1111111111` | Full ID including `offerId`. |\n| `productId` | Used to refer to the REST ID in API calls. | `online:en:label:1111111111` | This is the REST ID of a product. |\n| `id` | Same value as REST ID and `productId`. | `online:en:label:1111111111` | Used inside JSON body of a product to refer to its `productId`. |\n| `external_seller_id` | A seller ID chosen by the Marketplace. | `example-Seller1` | Required for multi-seller accounts. Must be 1-50 characters. Case-sensitive. Digits, and special characters _, -, ., and \\~ are accepted. |"]]