3 марта 2022 г.

Изменения, не связанные с выходом новых версий.

API Marketing

Группы товаров

Изменение фильтров поиска в каталоге

С 3 марта 2022 г. изменен порядок работы фильтров для создания групп товаров в каталоге. Эти изменения влияют на то, какие товары попадают в группу при ее создании.

Сроки внедрения
Поведение поля и оператора изменится через 90 дней. Если после 1 июня 2022 г. в вашем каталоге останутся группы, в которых используются затронутые изменениями фильтры, товары в этих группах могут измениться. Это значит, что в ваших объявлениях и магазинах с этими группами могут показываться другие товары. Кроме того, запросы с помощью этих фильтров могут возвращать другую группу товаров.

Дополнительную информацию о фильтрах для групп товаров можно найти здесь.

Список изменяемых операторов

Оператор	Изменение
`contains` / `not_contains`	Теперь запрос должен соответствовать всему слову, а не только его части. Например, запрос `name: {"contains": "red car"}` возвратит все товары, содержащие эти два слова, например, "red car" и "red fast car", но не возвратит “red carpet”. Слова, написанные через дефис, считаются отдельными словами. Например, если используется запрос `name: {"contains": "shirt"}`, слова “shirt” и “T-shirt” будут поисковыми совпадениями. Каждое слово из вашего запроса должно присутствовать в поле, которое вы хотите увидеть в результатах поиска. При этом порядок слов значения не имеет. Например, если используется запрос `name: {"contains": "jeans blue"}`, фраза “blue cropped jeans” будет показываться в результатах поиска, а отдельные слова “jeans” или “blue” не будут.
`lt`	Этот параметр фильтра больше не доступен для полей `custom_label`.
`lte`	Этот параметр фильтра больше не доступен для полей `custom_label`
`gt`	Этот параметр фильтра больше не доступен для полей `custom_label`
`gte`	Этот параметр фильтра больше не доступен для полей `custom_label`
`starts_with`	Этот параметр фильтра теперь доступен только для поля категорий товаров. Для других полей следует использовать фильтр `contains`.

Список изменяемых полей

Поле	Описание
`custom_label_0`	Значение пользовательского ярлыка товара, отеля, места назначения, транспортного средства или объекта недвижимости. Значение рассматривается как строка. Числовые операторы (`gt`, `gte`, `lt` и `lte`) недоступны в этом поле. Вместо них следует использовать оператор `custom_number_0 field`, который поддерживает целые числа.
`custom_label_1`	Значение пользовательского ярлыка товара, отеля, места назначения, транспортного средства или объекта недвижимости. Значение рассматривается как строка. Числовые операторы (`gt`, `gte`, `lt` и `lte`) недоступны в этом поле. Вместо них следует использовать оператор `custom_number_1`, который поддерживает целые числа.
`custom_label_2`	Значение пользовательского ярлыка товара, отеля, места назначения, транспортного средства или объекта недвижимости. Значение рассматривается как строка. Числовые операторы (`gt`, `gte`, `lt` и `lte`) недоступны в этом поле. Вместо них следует использовать поле `custom_number_2`, которое поддерживает целые числа.
`custom_label_3`	Значение пользовательского ярлыка товара, отеля, места назначения, транспортного средства или объекта недвижимости. Значение рассматривается как строка. Числовые операторы (`gt`, `gte`, `lt` и `lte`) недоступны в этом поле. Вместо них следует использовать поле `custom_number_3`, которое поддерживает целые числа.
`custom_label_4`	Значение пользовательского ярлыка товара, отеля, места назначения, транспортного средства или объекта недвижимости. Значение рассматривается как строка. Числовые операторы (`gt`, `gte`, `lt` и `lte`) недоступны в этом поле. Вместо них следует использовать поле `custom_number_4`, которое поддерживает целые числа.
`custom_number_0`	Пользовательское целое значение товара, отеля, места назначения, транспортного средства или объекта недвижимости.
`custom_number_1`	Пользовательское целое значение товара, отеля, места назначения, транспортного средства или объекта недвижимости.
`custom_number_2`	Пользовательское целое значение товара, отеля, места назначения, транспортного средства или объекта недвижимости.
`custom_number_3`	Пользовательское целое значение товара, отеля, места назначения, транспортного средства или объекта недвижимости.
`custom_number_4`	Пользовательское целое значение товара, отеля, места назначения, транспортного средства или объекта недвижимости.

Разбивка на страницы по сдвигу

Теперь значение для конечной точки GET /{product-catalog-id}/products?filter=.....&offset=...&limit=...&bulk_pagination=false не должно превышать 2000.

Что изменяется?

Сейчас отсутствуют ограничения для значения offset + limit. С сегодняшнего дня при использовании параметра bulk_pagination = false значение offset + limit не может быть больше 2000. Пример:

значения offset = 1000, limit = 1500 недопустимы, так как offset + limit = 2500
значения offset = 100, limit = 1500 допустимы, так как offset + limit = 1600

Чтобы разбивать каталог на страницы без ограничений, следует использовать параметр bulk_pagination = true.