rocket
Conoce la
API de Merchant
(el sucesor oficial de Content API for Shopping).
update
Obtén las últimas novedades
sobre las nuevas funciones, las correcciones de errores y las actualizaciones de la API de Merchant.
add_alert
Nota: Content API for Shopping dejará de estar disponible el 18 de agosto de 2026.
ID del producto
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Estos son los diferentes tipos de ID de producto en la Content API for Shopping:
- ID de la oferta
- Un
offerId es una string que un comercio le asigna a un producto. Este ID representa un producto individual.
offerId es único para el conjunto de ofertas en la base de datos de Merchant Center y, por lo general, es un número secuencial numérico.offerId puede ser un número de SKU interno que un comerciante asigna al producto.- ID de REST
- Un ID de REST es el identificador único de un producto que Google asigna.
- El ID de REST es
productId para las llamadas a la API de REST.
Los ID de REST se agregan con el formato online:en:label:1111111111. El ID de REST consta de las siguientes 4 partes, separadas por dos puntos:
- Canal ("en línea" o "local")
- Idioma del contenido (con la designación de dos letras, por ejemplo,
en o fr)
- Etiqueta del feed (puede ser el código de dos letras del país de destino del feed, por ejemplo,
US o FR)
- ID de la oferta
Debes combinar esto como channel:contentLanguage:feedLabel:offerId, por ejemplo, online:en:US:1111111111.
- ID de vendedor externo (mercados)
Marketplaces debe asignar un external_seller_id a las ofertas subidas a una cuenta de varios vendedores. Este campo representa a un vendedor individual.
Los valores external_seller_id distinguen entre mayúsculas y minúsculas, y deben cumplir con los siguientes criterios:
- 1 a 50 caracteres
- Solo los caracteres ASCII alfanuméricos y el guion bajo (_), el guion (-), el punto (.) y la virgulilla (~)
No es lo mismo que el campo interno seller_id.
En la siguiente tabla, se resumen algunos de los ID que se pueden asociar con un producto:
| Atributo |
Descripción |
Ejemplo |
Notas |
offerId |
Es el ID que un comercio le asigna a un producto. |
1111111111 |
Tipo de datos de string, identificador único de la oferta de un producto. |
| ID de REST |
Un ID que Google le asignó a un producto. En el formato channel:contentLanguage:feedLabel:offerId. |
online:en:label:1111111111 |
ID completo que incluye offerId. |
productId |
Se usa para hacer referencia al ID de REST en las llamadas a la API |
online:en:label:1111111111 |
Este es el ID de REST de un producto. |
id |
El mismo valor que el ID de REST y productId. |
online:en:label:1111111111 |
Se usa dentro del cuerpo JSON de un producto para hacer referencia a su productId. |
external_seller_id |
Un ID de vendedor elegido por Marketplace. |
example-Seller1 |
Obligatorio para cuentas de varios vendedores. Debe tener entre 1 y 50 caracteres. Distingue mayúsculas de minúsculas. Se aceptan dígitos y caracteres especiales _, -, . y ~.
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-13 (UTC)
[null,null,["Última actualización: 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. |"]]
