Коллекции товаров позволяют определять группы товаров для использования с расширенными форматами, такими как изображения, доступные для покупки . Каждая коллекция может включать до 100 товаров. Вы можете создать коллекцию либо через Google Merchant Center, либо через Content API.
В этом руководстве показано, как использовать коллекции товаров через Content API, включая примеры создания коллекции для изображений, доступных для покупки, и проверки статуса коллекции.
Используйте коллекции товаров.
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"
}
]
}