rocket
Scopri l'
API Merchant, il successore ufficiale dell'API Content for Shopping.
add_alert
Nota: l'API Content for Shopping verrà ritirata il 18 agosto 2026.
ID prodotto
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Ecco i diversi tipi di ID prodotto nella Content API for Shopping:
- ID offerta
- Un
offerId è una stringa assegnata a un prodotto da un commerciante. Questo ID
rappresenta un singolo prodotto.
offerId è univoco per l'insieme delle offerte nel database di Merchant Center e
di solito è un numero sequenziale.offerId può essere un codice SKU interno assegnato dal commerciante al prodotto.- ID REST
- Un ID REST è l'identificatore univoco di un prodotto assegnato da Google.
- L'ID REST è l'
productId per le chiamate API REST.
Gli ID REST sono aggregati nel formato online:en:label:1111111111. L'ID REST è costituito dalle quattro parti seguenti, separate dai due punti:
- Canale ("online" o "locale")
- Lingua dei contenuti (utilizzando la designazione di due lettere, ad esempio
en o fr)
- Etichetta del feed (potrebbe essere il codice di due lettere del paese di destinazione del feed, ad esempio
US o FR)
- ID offerta
La componiamo come channel:contentLanguage:feedLabel:offerId, ad esempio, online:en:US:1111111111.
- ID esterno del venditore (Marketplace)
I Marketplace devono assegnare un valore external_seller_id alle offerte caricate in un account multi-venditore. Questo campo rappresenta un singolo venditore.
I valori external_seller_id sono sensibili alle maiuscole e devono soddisfare i seguenti criteri:
- Lunghezza: 1-50 caratteri
- Solo caratteri ASCII alfanumerici e trattini bassi (_), trattini (-),
punti (.) e tilde (~)
Non corrisponde al campo
seller_id interno.
La tabella seguente riassume alcuni degli ID che possono essere associati a un prodotto:
| Attributo |
Descrizione |
Esempio |
Note |
offerId |
L'ID assegnato a un prodotto da un commerciante. |
1111111111 |
Tipo di dati stringa, identificatore univoco dell'offerta di un prodotto. |
| ID REST |
L'ID assegnato a un prodotto da Google. Nel formato channel:contentLanguage:feedLabel:offerId. |
online:en:label:1111111111 |
ID completo comprensivo di offerId. |
productId |
Utilizzato per fare riferimento all'ID REST nelle chiamate API. |
online:en:label:1111111111 |
Questo è l'ID REST di un prodotto. |
id |
Stesso valore dell'ID REST e di productId. |
online:en:label:1111111111 |
Utilizzato all'interno del corpo JSON di un prodotto per fare riferimento alla sua productId. |
external_seller_id |
Un ID venditore scelto dal Marketplace. |
example-Seller1 |
Obbligatorio per gli account multi-venditore. Deve avere una lunghezza compresa tra 1 e 50 caratteri. Distinzione tra maiuscole e minuscole. Si accettano numeri e caratteri speciali _, -, . e ~.
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-13 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]
