Coleções de produtos

Com as coleções de produtos, você pode definir grupos de produtos para usar com formatos avançados, como imagens com opção de compra. Cada seleção pode ter até 100 produtos. Você pode criar uma coleção com o Google Merchant Center ou a API Content.

Este guia mostra como usar coleções de produtos pela API Content, incluindo exemplos de como criar uma coleção para imagens compráveis e como verificar o status de uma coleção.

Observação: no momento, as imagens com opção de compra são o único formato de anúncio que aceita coleções. No entanto, outros formatos podem ser adicionados para que você possa reutilizar suas coleções em diferentes formatos de anúncio.

Usar coleções de produtos

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

• collections: permite receber, listar, inserir e excluir coleções de produtos.

• collectionstatuses: permite receber e listar o status das coleções para descobrir se uma coleção tem problemas que podem invalidá-la para um destino, como anúncios do Shopping.

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

As imagens com opção de compra são de alta qualidade e mostram um ou mais produtos anotados, sendo configuradas usando coleções. Para usar imagens com opção de compra, especifique valores para os 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 as imagens com opção de compra, crie uma coleção de produtos e use o campo imageLink para especificar uma imagem que contenha até dez produtos. Recomendamos usar imagens quadradas (com proporção de 1:1).

Importante: o campo imageLink para coleções aceita uma matriz de valores de link da imagem. No entanto, apenas o primeiro valor na matriz é usado para o formato de imagens com opção de compra.

Você também precisa especificar os produtos mostrados na imagem usando o 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, inclusive.

Cada coleção pode incluir no máximo 100 produtos. No entanto, para imagens 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 para mostrar as frases de destaque do produto. O campo offerId que faz parte do objeto featuredProduct precisa corresponder ao valor offerId no recurso products, que é diferente do valor id no recurso products.

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

Importante: o campo headline para coleções aceita uma matriz de valores de manchete. No entanto, apenas o primeiro valor na matriz é usado para o formato de imagens com opção de compra.

Para criar uma 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"
}

Aviso: se uma coleção existir com o mesmo id, fazer uma solicitação para collections.insert vai substituir o recurso por completo.

Exemplo: verificar o status de uma coleção

Para descobrir se a coleção criada acima tem problemas que invalidariam a veiculação de anúncios, faça uma solicitação GET ao endpoint collectionsstatuses.get usando o seguinte URL e inclua o id da coleção cujo status você quer recuperar. Não é necessário fornecer um corpo de solicitação.

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

Exemplo de resposta de 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"
    }
  ]
}