Коллекции продуктов

Коллекции товаров позволяют определять группы товаров для использования с расширенными форматами, такими как изображения для покупок . Каждая коллекция может включать до 100 товаров. Вы можете создать коллекцию с помощью Google Merchant Center или Content API.

В этом руководстве показано, как использовать коллекции продуктов через Content API, включая примеры того, как создать коллекцию для изображений для покупок и как проверить статус коллекции.

Используйте коллекции продуктов

Content API включает две службы для управления коллекциями продуктов:

  • collections : позволяет получать, перечислять, вставлять и удалять коллекции продуктов.

  • collectionstatuses : позволяет получать и перечислять статусы коллекций, чтобы выяснить, есть ли у коллекции какие-либо проблемы, которые могут сделать ее недействительной для назначения, например, для торговых объявлений .

Пример: создание коллекции изображений для покупок

Изображения для покупок — это высококачественные изображения, демонстрирующие один или несколько аннотированных товаров, которые настраиваются с помощью коллекций. Для использования изображений для покупок необходимо указать значения полей imageLink и featuredProduct , а также обязательных полей для всех коллекций. Подробнее об обязательных полях см. в справочной документации Content API .

Чтобы использовать изображения для покупок, необходимо создать коллекцию товаров и указать в поле imageLink изображение, содержащее до десяти товаров. Мы рекомендуем использовать квадратные изображения (с соотношением сторон 1:1).

Необходимо также указать товары, отображаемые на изображении, используя поле featuredProduct , включая координаты товаров на изображении в полях x и y . Эти поля обязательны только для коллекций, используемых с изображениями для покупок. Значения x и y должны находиться в диапазоне от 0 до 1 включительно.

Каждая коллекция может включать не более 100 товаров. Однако для изображений, доступных для покупок, мы рекомендуем указывать координаты не более чем для 10 товаров на одном изображении, чтобы на изображении было достаточно места для отображения выносок товаров. Поле offerId в объекте featuredProduct должно соответствовать значению offerId в ресурсе products , которое отличается от значения id в ресурсе products .

Помимо полей imageLink и featuredProduct , обязательных для изображений, доступных для покупок, вы также можете указать заголовок коллекции, используя необязательное поле headline . Мы рекомендуем добавлять заголовок, чтобы предоставить покупателям дополнительную информацию о коллекции.

Чтобы создать новую коллекцию изображений для покупок, отправьте запрос POST к конечной collections.insert , используя следующий URL-адрес и тело запроса:

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

Пример: проверка статуса коллекции

Чтобы узнать, есть ли в созданной вами выше коллекции проблемы, которые могут помешать ей показывать рекламу, отправьте GET запрос к конечной точке collectionsstatuses.get , используя следующий URL-адрес, указав id коллекции, статус которой вы хотите получить. Текст запроса предоставлять не нужно.

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

Пример ответа о статусе сбора 

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