La products
recurso permite una gran flexibilidad y control sobre más
más de 60 atributos de producto.Existen varios campos obligatorios,
y debe incluirse para que se apruebe y publique en Google Shopping.
Existen varios campos opcionales
que pueden volverse obligatorios según
condiciones, como la ubicación, el tipo de producto, las variantes del producto y
paquetes. Para obtener más información sobre los más de 60 parámetros opcionales que se pueden
configurados para los productos, consulta el artículo Datos de productos
Especificaciones
El recurso products te permite insert, get, update y delete uno
producto a la vez y list todos los productos de la base de datos de Merchant Center.
El
productstatuses
recurso se puede usar para verificar el estado de aprobación o rechazo de un
producto de un destino. Consulta el estado del producto
guía para conocer más detalles
problemas de calidad de los datos
y cuáles podrían ser esos problemas.
En nuestros ejemplos de API, usamos tres productos: dos camisetas de Google y un
Límite de Google Usamos un conjunto mínimo de datos de productos que se muestra en la siguiente tabla para
Realiza products llamadas a recursos para insertar, obtener, actualizar, enumerar y borrar.
productos individuales y lotes de productos.
Recomendamos configurar la información fiscal y de envío en la cuenta de nivel básico en lugar de a nivel del producto.
Para cuentas secundarias de varios vendedores de
Mercados, todos los productos deben
Incluye el campo external_seller_id. Consulta
IDs de productos para obtener más información.
 |
 |
 |
|
| id | online:en:US:1111111111 | online:en:US:2222222222 | online:en:US:3333333333 |
| offerId | 1111111111 | 2222222222 | 3333333333 |
| título | Camiseta negra de Google | Camiseta verde de Google | Gorra de sarga de Google |
| descripción | Camiseta negra de Google | Camiseta de Google 100% algodón | Gorra clásica de Google |
| ID de grupo de artículos | google_tee | google_tee | |
| vínculo | http://my.site.com/blacktee | http://my.site.com/greentee | http://my.site.com/blackhat |
| de transición | Nuevo | Nuevo | Nuevo |
| precio | 219.90 MXN | 219.90 MXN | 109.90 MXN |
| de disponibilidad | En stock | En stock | En stock |
| imageLink | https://shop.example.com/ |
https://shop.example.com/ |
https://shop.example.com/ |
| gtin [gtin] | 9504000059422 | 9504000059446 | 9504000059452 |
| MPN | 00638NIC | 00638ANG | 00638ABC |
| brand | |||
| Categoría producto google | Indumentaria y Accesorios > Prendas de vestir | Indumentaria y Accesorios > Prendas de vestir | Indumentaria y Accesorios > Accesorios de vestir > Sombreros |
| color | negro | verde | negro |
| tamaño | L | M | M |
| age_group | para adultos | para adultos | para adultos |
| género | masculino | masculino | unisex |
| included_destination | Acciones de Shopping, anuncios de Shopping | Acciones de Shopping, anuncios de Shopping | Shopping Actions |
products.insert
Para insertar un solo producto, usa la siguiente URL de solicitud y especifica tu
el ID del comerciante y un cuerpo JSON de muestra. Un inserción crea el nuevo producto. Valores if
existen para los atributos channel, contentLanguage, offerId y
feedLabel para un producto determinado, este método actualiza esa entrada y reemplaza
todos los datos de llamadas anteriores a la API para el producto determinado.
Aquellos que se excluyen de todos los destinos durante más de 7 días tienen las siguientes características: se borran automáticamente.
En el ejemplo mostrado, se inserta una nueva “camiseta negra de Google” con los productos disponibles.
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products
Ejemplo de llamada al cuerpo de la solicitud para products.insert:
{
"kind": "content#product",
"offerId": "1111111111",
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing.",
"link": "http://my.site.com/blacktee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "black",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531656",
"itemGroupId": "google_tee",
"mpn": "608802531656",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Large"
]
}
Un producto también puede tener atributos personalizados configurados en el cuerpo JSON. Por ejemplo:
podemos establecer un purchase_quantity_limit para un solo producto a fin de limitar
la cantidad de artículos que un cliente puede pedir:
"customAttributes": [
{
"name": "purchase_quantity_limit",
"value": "4"
}
]
Ten en cuenta que el atributo personalizado purchase_quantity_limit establece un límite de compra.
por pedido de cliente a la definición del producto y también es compatible con los feeds. El
actualmente se encuentra en versión beta hasta que la API sea totalmente compatible. Cualquiera
un comercio puede agregar más atributos personalizados, pero esto no
cualquier procesamiento específico que realicen las APIs.
Si la llamada se realiza correctamente, se mostrará un código HTTP 200 y un cuerpo de respuesta que contengan
el recurso de producto insertado solo con id, offerId, contentLanguage
feedLabel y channel propagados:
{
"kind": "content#product",
"id": "online:en:US:1111111111",
"offerId": "1111111111",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online"
}
products.get
Para obtener información sobre un producto específico en la base de datos de Merchant Center, usa
products.get Un producto recién insertado puede tardar unos minutos en aparecer
disponibles a través de esta llamada.
Usa los siguientes parámetros y URL de solicitud HTTP, tu ID del comerciante y el ID del producto (formato de ID de REST) del producto que deseas obtener:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
Una llamada exitosa muestra un HTTP 200 y el "recurso de producto". en la
cuerpo de respuesta. Estos son ejemplos de datos del producto recuperados de un producto con ID
online:en:US:1111111111:
{
"kind": "content#product",
"id": "online:en:US:1111111111",
"offerId": "1111111111",
"source": "api",
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing.",
"link": "http://my.site.com/blacktee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "black",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531656",
"itemGroupId": "google_tee",
"mpn": "608802531656",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Large"
]
}
products.update
Para actualizar un solo producto, usa la siguiente URL de solicitud con el método PATCH:
especifica tu ID del comerciante, el ID del producto y un cuerpo JSON con los datos que
que quieres actualizar para el producto. A diferencia de products.insert, eso requiere
se deben proporcionar todos los campos aplicables; products.update solo requiere que
especifica los campos que quieres cambiar.
Para agregar o modificar un atributo, especifica el campo con el valor nuevo en el archivo JSON
cuerpo. En el ejemplo que se muestra, se actualizarán el title y el description de un
“Camiseta negra de Google” con los datos de productos que se proporcionaron en el cuerpo de la solicitud, dejando
todos los demás campos intactos.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
Ejemplo de llamada al cuerpo de la solicitud para products.update:
{
"title": "Google Tee Black Limited Edition",
"description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}
Solo los campos de nivel superior se pueden actualizar a través de una solicitud products.update.
Si quieres actualizar campos anidados, debes proporcionar el objeto de nivel superior completo.
En el ejemplo que se muestra, se actualizará el objeto salePrice de nivel superior, incluidas las funciones anidadas
campos de un producto existente, con los datos de producto proporcionados en el
el cuerpo de la solicitud y deja los demás campos intactos.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
{
"salePrice": {
"value": "17.99",
"currency": "USD"
}
}
Para seleccionar ciertos campos y actualizarlos sin hacer cambios en los demás incluidos
En el cuerpo de la solicitud, puedes especificar un updateMask. Esta cadena de consulta
debe ser una lista separada por comas de los campos que desees modificar.
Un updateMask es útil cuando quieres confirmar que solo los campos con nombre
se actualizará automáticamente. Si no se especifica un updateMask, equivale a marcarlo todo.
de la solicitud que se actualizará, como se muestra en el ejemplo anterior.
En el ejemplo que se muestra, se actualizarán solo description y availability.
de una "camiseta negra de Google" existente con los datos de producto respectivos que se proporcionan en
el cuerpo de la solicitud y deja intactos todos los demás campos, incluido el title.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability
Ejemplo de llamada al cuerpo de la solicitud para products.update:
{
"title": "Google Tee Black",
"description": "This Limited Edition is out of print.",
"availability": "out of stock"
}
Si se proporciona un campo en la lista updateMask, pero no en el cuerpo de la solicitud,
Ese campo se borrará del recurso Product, si existe.
En el ejemplo que se muestra, se usará updateMask para quitar el valor del campo
salePrice
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice
El cuerpo de la solicitud de ejemplo no debe incluir el campo salePrice para que
borrarlo. También puedes proporcionar ningún cuerpo o un cuerpo vacío. Otros campos
permanecen intactas, siempre que no aparezcan en updateMask.
Para usar updateMask dentro de una solicitud products.custombatch, updateMask
en el cuerpo de la solicitud.
En el ejemplo que se muestra, se actualizarán el price y el availability de un
“Camiseta negra de Google” Se usa products.custombatch con los datos de productos proporcionados
en la entrada del lote y deja todos los demás campos, incluidos title y description
intactos.
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
{
"entries": [{
"batchId": 1,
"merchantId": "MERCHANT_ID",
"productId": "online:en:US:1111111111",
"method": "update",
"product": {
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing.",
"availability": "in stock",
"price": {
"value": "19.99",
"currency": "USD"
}
},
"updateMask": "availability,price"
}]
}
products.delete
Para borrar un solo producto, usa products.delete con la solicitud HTTP de muestra.
URL, tu ID del comerciante y el ID del producto (en formato de ID REST, como
online:en:US:1111111111) para el producto que quieres borrar:
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
Una respuesta correcta muestra una HTTP Status 204 sin cuerpo de respuesta.
products.list
products.list enumera todos los productos que un comercio tiene en Merchant Center.
en la base de datos. Usa la siguiente URL de solicitud:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products
Una llamada exitosa muestra un HTTP 200 y datos JSON de los productos en la
“recursos” .
Se muestran los siguientes tres ejemplos de productos:
{
"kind": "content#productsListResponse",
"resources": [
{
"kind": "content#product",
"id": "online:en:US:1111111111",
"offerId": "1111111111",
"source": "api",
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing.",
"link": "http://my.site.com/blacktee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "black",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531656",
"itemGroupId": "google_tee",
"mpn": "608802531656",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Large"
]
},
{
"kind": "content#product",
"id": "online:en:US:2222222222",
"offerId": "2222222222",
"source": "api",
"title": "Google Tee Green",
"description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
Features the google logo across the chest. Unisex sizing.",
"link": "http://my.site.com/greentee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "green",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531649",
"itemGroupId": "google_tee",
"mpn": "608802531649",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Medium"
]
},
{
"kind": "content#product",
"id": "online:en:US:3333333333",
"offerId": "3333333333",
"source": "api",
"title": "Google Twill Cap",
"description": "Classic urban styling distinguishes this Google cap.
Retains its shape, even when not being worn.",
"link": "http://my.site.com/blackhat/",
"imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-07T13:00:00-08:00",
"brand": "Google",
"color": "black",
"condition": "new",
"gender": "male",
"googleProductCategory": "173",
"gtin": "689355417246",
"mpn": "689355417246",
"price": {
"value": "10.99",
"currency": "USD"
},
"sizes": [
"Medium"
]
}
]
}