Коллекции товаров позволяют определять группы товаров для использования с расширенными форматами, такими как изображения с возможностью покупки . Каждая коллекция может включать до 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"
}
]
}