ID del producto

Nos gustaría presentar la versión beta de la API de Merchant. Es la nueva versión de Content API for Shopping y el futuro.

Para obtener información sobre cómo la API de Merchant Center puede mejorar tu integración y cómo puedes ayudar a dar forma al futuro, consulta Anuncio de la versión beta de la API de Merchant Center.

Estos son los diferentes tipos de ID de productos en Content API for Shopping:

ID de la oferta

Un offerId es una cadena que un comercio 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 comercio asigna al producto.

ID de REST

Un ID de REST es el identificador único de un producto que asigna Google.

El ID de REST es el productId para las llamadas a la API de REST.

Los IDs de REST son agregados con el formato online:en:label:1111111111. El ID de REST consta de las siguientes 4 partes, separadas por dos puntos:

1. Canal ("en línea" o "local")
2. Idioma del contenido (con la designación de 2 letras, por ejemplo, en o fr)
3. Etiqueta de feed (puede ser el código de dos letras del país de segmentación del feed, por ejemplo, US o FR)
4. ID de la oferta

Debes reunir esto como channel:contentLanguage:feedLabel:offerId, por ejemplo, online:en:US:1111111111.

ID del vendedor externo (mercados)

Los mercados deben 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 mayúsculas de minúsculas y deben cumplir con los siguientes criterios:

• Entre 1 y 50 caracteres de longitud
• Solo caracteres alfanuméricos ASCII y guion bajo (_), guion (-), punto (.) y tilde (~)

No es lo mismo que el campo seller_id interno.

En la siguiente tabla, se resumen algunos de los IDs que se pueden asociar con un producto:

Atributo	Descripción	Ejemplo	Notas
offerId	Es un ID que un comercio asigna a un producto.	1111111111	Tipo de datos de cadena, identificador único para la oferta de un producto.
ID de REST	Un ID que Google asigna a un producto. Tiene el formato channel:contentLanguage:feedLabel:offerId.	online:en:label:1111111111	ID completo, incluido 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	Es un ID de vendedor que elige Marketplace.	example-Seller1	Obligatorio para las 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 ~.