llamadas a recursos de productos

Nos gustaría presentar la versión beta de la API de Merchant. Es la nueva versión del 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 definir la en el futuro, consulta Cómo anunciar la versión beta de la API de Merchant Center.

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/store/20160512512/assets/items/images/GGOEGXXX1100.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX0906.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGHPB071610.jpg
gtin [gtin]	9504000059422	9504000059446	9504000059452
MPN	00638NIC	00638ANG	00638ABC
brand	Google	Google	Google
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.

Nota: La actualización de un producto se comporta de manera similar a products.insert y lleva hasta un unos minutos para que se procesen los cambios. Si products.update tiene éxito sin errores, la actualización se realizó correctamente. Es posible que se devuelvan las siguientes llamadas a products.get el valor anterior hasta que se haya procesado la actualización.

Advertencia: Los cambios realizados con product.update no persisten si el producto con el mismo ID de producto se vuelve a enviar mediante el feed principal y el complementario o API. Si quieres que un valor persista después de que se vuelva a enviar, asegúrate de que tu se incluye en el feed o mediante la llamada a la API de products.insert.

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.

Advertencia: Cuando uses updateMask, ten cuidado de proporcionar el valor correcto para todos campos enumerados en el updateMask. Si no incluyes el valor en el cuerpo de la solicitud equivaldrá a borrar el campo.

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"
   ]
  }
 ]
}