Colecciones de productos

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

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

Nota: Actualmente, las imágenes con puntos de compra son el único formato de anuncio que admite colecciones. Sin embargo, es posible que se agreguen formatos adicionales para que puedas volver a usar tus colecciones en diferentes formatos de anuncios.

Cómo usar colecciones de productos

La API de Content 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 tienen problemas que puedan invalidarlas para un destino, como los anuncios de Shopping.

Ejemplo: Crea una colección para las Imágenes con puntos de compra

Las Imágenes con puntos de compra son imágenes de alta calidad en las que se muestra uno o más productos anotados, y se configuran con colecciones. Para usar las Imágenes con puntos de compra, debes especificar valores para 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 la API de Content.

Para usar las Imágenes con puntos de compra, debes crear una colección de productos y usar el campo imageLink para especificar una imagen que contenga hasta diez productos. Te recomendamos que uses imágenes cuadradas (con una relación de aspecto de 1:1).

Punto clave: El campo imageLink para las colecciones acepta un array de valores de vínculos de imágenes. Sin embargo, solo se usa el primer valor del array para el formato de imágenes con puntos de compra.

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

Cada colección puede incluir un máximo de 100 productos. Sin embargo, en el caso de las imágenes con puntos de compra, te recomendamos que especifiques coordenadas para no más de 10 productos por imagen para asegurarte de que haya suficiente espacio en la imagen para mostrar los textos destacados de los productos. El campo offerId que forma parte del objeto featuredProduct debe coincidir con el valor offerId del recurso products, que es diferente del valor id del 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 un encabezado de la colección con el campo opcional headline. Te recomendamos que incluyas un título para brindarles a los clientes detalles adicionales sobre la colección.

Punto clave: El campo headline para las colecciones acepta un array de valores de encabezado. Sin embargo, solo se usa el primer valor del array para el formato de imágenes con puntos de compra.

Para crear una colección nueva para las Imágenes con puntos de compra, realiza 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"
}

Advertencia: Si existe una colección con el mismo id, hacer una solicitud a collections.insert reemplaza el recurso por completo.

Ejemplo: Verifica el estado de una colección

Para descubrir si la colección que creaste anteriormente tiene problemas que invalidarían la publicación de anuncios de la colección, realiza una solicitud GET al extremo de collectionsstatuses.get con la siguiente URL e incluye el id de la colección cuyo estado deseas recuperar. No es necesario que proporciones un cuerpo de solicitud.

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

Ejemplo de respuesta del estado de la recopilació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"
    }
  ]
}