Colecciones de productos

Las colecciones de productos te permiten definir grupos de productos para usar con formatos enriquecidos, como Imágenes con puntos de compra. Cada puede incluir hasta 100 productos. Puedes crear una colección con ya sea Google Merchant Center o Content API.

En esta guía, se muestra cómo usar las colecciones de productos a través de Content API. incluidos ejemplos para crear una colección de Imágenes con puntos de compra y cómo para verificar el estado de una colección.

Usa las colecciones de productos

Content API incluye dos servicios para administrar colecciones de productos:

  • collections: Te permite obtener, enumerar, insertar y borrar colecciones de productos.

  • collectionstatuses: Te permite obtener y enumerar el estado de las colecciones para descubrir si una colección tiene algún problema que pueda provocar que se vuelva no ser válidos para un destino, como Shopping Ads [anuncios de Shopping].

Ejemplo: Crea una colección de imágenes con puntos de compra

Las imágenes con puntos de compra son altas imágenes de calidad que muestran uno o más productos con anotaciones, y se configuran mediante colecciones. Para usar imágenes con puntos de compra, debes especificar valores de los campos imageLink y featuredProduct, además de los campos obligatorios para todas las colecciones. Para obtener más información sobre los campos obligatorios, consulta la Documentación de referencia de Content API

Para usar Imágenes con puntos de compra, debe crear una colección de productos y usar la imageLink para especificar una imagen que contenga hasta diez productos. Mié se recomienda usar imágenes cuadradas (con una relación de aspecto de 1:1).

También debes especificar los productos que se muestran en la imagen mediante el Campo featuredProduct, incluidas las coordenadas de los productos de la imagen con los campos x y y. Estos campos solo son obligatorios para las colecciones se usan con imágenes con puntos de compra. Los valores x y y deben estar entre 0 y 1. inclusivas.

Cada colección puede incluir un máximo de 100 productos. Sin embargo, para Imágenes con puntos de compra, te recomendamos especificar coordenadas de no más de 10 productos por imagen a fin de garantizar que haya espacio suficiente en ella para mostrar los textos destacados de productos. El offerId que forma parte del objeto featuredProduct debe coincidir con la offerId de salida en el recurso products, que es diferente del Valor id en el recurso products.

Además de los campos imageLink y featuredProduct, que son obligatorios para las Imágenes con puntos de compra, también puedes especificar el título de una colección con el campo headline opcional. Recomendamos incluir un título para proporcionar a los clientes con detalles adicionales sobre la colección.

Si quieres crear una colección nueva para imágenes con puntos de compra, envía una solicitud POST al Extremo collections.insert con la siguiente URL y cuerpo de la solicitud:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/collections

{
  "id": "exampleCollection"
  "language": "en",
  "productCountry": "UK",
  "imageLink": ["www.imageLink.example"],
  "featuredProduct": [
{
  "offerId": '432',
  "x": 0.11,
  "y": 0.99
},
{ "offerId": '433',
  "x": 0.53,
  "y": 0.89
}
],
  "link": "www.link.example",
  "mobileLink": "www.mobileLink.example",
  "headline": "www.link.example",
  "customLabel0": "Organize",
  "customLabel1": "Your",
  "customLabel2": "Bidding/Reporting",
  "customLabel3": "With",
  "customLabel4": "Me"
}

Ejemplo: Verifica el estado de una colección

Para descubrir si la colección que creaste anteriormente tiene problemas invalidar la recopilación para que no publique anuncios, realiza una solicitud GET al collectionsstatuses.get con la siguiente URL y, además, incluye el extremo id de la colección cuyo estado quieres recuperar. No es necesario que proporciones un cuerpo de solicitud.

https://shoppingcontent.googleapis.com/content/v2.1/merchantID/collectionstatuses/collection ID

Ejemplo de respuesta de estado de la colección

{
  "id": "exampleCollection",
  "creationDate": "2020-09-22T00:26:51Z",
  "lastUpdateDate": "2020-09-22T00:26:51Z",
  "collectionLevelIssues": [
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "link",
      "description": "Invalid URL [link]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    },
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "imageLink",
      "description": "Invalid URL [imageLink]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    }
  ]
}