Coleções de produtos

As coleções de produtos permitem que você defina grupos de produtos a serem usados com formatos aprimorados, como Imagens com opção de compra. Cada pode incluir até 100 produtos. Você pode criar uma coleção com o Google Merchant Center ou a API Content.

Neste guia, mostramos como usar as coleções de produtos com a API Content, incluindo exemplos de como criar uma coleção de imagens com opção de compra e como para verificar o status de uma coleta.

Usar coleções de produtos

A API Content inclui dois serviços para gerenciar coleções de produtos:

• collections: permite que você receba, liste, insira e exclua coleções de produtos.

• collectionstatuses: permite receber e listar o status de coleções para descobrir se uma coleção tem problemas que podem fazer com que ela ser inválido para um destino, como Anúncios do Shopping.

Exemplo: criar uma coleção de imagens com opção de compra

As imagens com opção de compra têm alto imagens de alta qualidade que mostram um ou mais produtos anotados e são configuradas usando coleções. Para usar imagens com opção de compra, é necessário especificar valores para o Campos imageLink e featuredProduct, além dos campos obrigatórios para todas as coleções. Para mais informações sobre os campos obrigatórios, consulte a documentação de referência da API Content.

Para usar imagens com opção de compra, você precisa criar uma coleção de produtos e usar o imageLink para especificar uma imagem que contém até dez produtos. Qa (recomendamos usar imagens quadradas com proporção de 1:1).

Você também deve especificar os produtos exibidos na imagem usando o campo Campo featuredProduct, incluindo as coordenadas dos produtos na imagem usando os campos x e y. Esses campos são obrigatórios apenas para coleções usadas com imagens com opção de compra. Os valores x e y precisam estar entre 0 e 1. inclusivos.

Cada coleção pode ter até 100 produtos. No entanto, para com opção de compra, recomendamos que você especifique coordenadas para no máximo 10 produtos por imagem para garantir que haja espaço suficiente na imagem para mostrar os frases de destaque de produtos. A offerId que faz parte do objeto featuredProduct precisa corresponder ao offerId no recurso products, que é diferente do valor Valor id no recurso products.

Além dos campos imageLink e featuredProduct, que são obrigatórios para imagens com opção de compra, também é possível especificar o título de uma coleção usando o atributo campo headline opcional. Recomendamos incluir um título para fornecer aos clientes com mais detalhes sobre a coleta.

Para criar uma nova coleção de imagens com opção de compra, faça uma solicitação POST ao Endpoint collections.insert usando o seguinte URL e corpo da solicitação:

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

Exemplo: verificar o status de uma coleção

Para descobrir se a coleção que você criou acima tem problemas que poderiam invalidar a coleção para veicular anúncios, faça uma solicitação GET para o endpoint collectionsstatuses.get usando o seguinte URL e inclua o id da coleção cujo status você quer recuperar. Você não precisa fornecer um corpo de solicitação.

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

Exemplo de resposta do status da coleta

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