...
Параметр | Параметр в условиях поиска | Описание условия поиска | Параметр в описании способа поиска | Описание в способе поиска | ||
---|---|---|---|---|---|---|
Провайдер | Provider | Если в условиях поиска не указан провайдер явно, он будет определен по другим условиям (например, категории). Если ни одно условие не определяет провайдера, поиск будет произведен в провайдере по умолчанию. Если разные условия поиска ведут к различным провайдерам, то такой поиск невозможен и приведет к ошибке. | Provider | Идентификатор провайдера | ||
Способ поиска
| SearchMethod | Если не указано, используется определенный в настройках способ поиска по умолчанию. | SearchMethod | Название способа поиска | ||
DisplayName | Отображаемое название способа поиска (на нужном языке) | |||||
Flags | Список особенностей способа поиска | |||||
Ограничения на число товаров | UseOptimalFrameSize | Признак использования оптимального размера фрейма вместо переданного. Если данное условие передано в значении true, то параметр frameSize игнорируется, и будет использовано OptimalFrameSize из выбранного способа поиска. | ||||
OptimalFrameSize | Оптимальное число запрашиваемых товаров (размер страницы). Если использовать страницы данного размера, это обеспечивает максимальную возможную скорость работы поиска, т.к. оно соответствует размерам страниц у провайдера. | |||||
MaximumFrameSize | Максимальное число товаров, которое можно получить за 1 запрос. Может работать значительно медленнее, чем при использовании оптимального числа. | |||||
MaximumItemsCount | Число товаров, до которого в принципе можно получить по одним и тем же условиям поиска. Чтобы получать больше товаров, надо менять и уточнять условия поиска. | |||||
Сортировка товаров | OrderBy | Если не указано, или указанное значение не входит в число допустимых, будет использована определенная в настройках сортировка по умолчанию. | AvailableSorts | Список допустимых сортировок в способе поиска. | ||
Категория | CategoryId | Идентификатор категории, в которой искать товары. | ||||
Название товара | ItemTitle | Поисковая строка по названию товара. Если в поисковой строке указаны только идентификатор (артикул) товара или ссылка на страницу на сайте провайдера, то будет найден и выдан именно этот единственный товар (или пусто, если таковой товар отсутствует). | ||||
LanguageOfQuery | Язык поисковой строки по названию товара. Если не указан, считается равным языку выдачи товаров. Если не равен языку провайдера, то производится автоперевод на язык провайдера. | |||||
Продавец | VendorId | Идентификатор продавца | Vendor | Поддерживается ли поиск по продавцу | ||
VendorName | Имя продавца | |||||
Местонахождение продавца | VendorAreaId | Идентификатор местонахождения продавца (зоны) | VendorLocation | Поддерживает ли способ поиска местонахождение продавца | ||
Рейтинг продавца | VendorRatingRange | Поддерживает ли способ поиска фильтр по рейтингу продавца | ||||
MinVendorRating | Минимальное значение рейтинга продавца | MinVendorRating | Минимальное значение рейтинга продавца | |||
MaxVendorRating | Максимальное значение рейтинга продавца | MaxVendorRating | Максимальное значение рейтинга продавца | |||
Бренд | BrandId | Идентификатор искомой торговой марки | Brand | Поддерживает ли способ поиска бренды | ||
BrandPropertyValueId | Идентификатор значения искомой торговой марки (устаревший параметр, используйте BrandId) | |||||
Цена | MinPrice | Минимальная цена | PriceRange | Поддерживает ли способ поиска фильтр по цене товара | ||
MaxPrice | Максимальная цена | |||||
CurrencyCode | Код валюты, в которой указан диапазон цен. | |||||
Объем продаж | MinVolume | Минимальный объем продаж | VolumeRange | Поддерживает ли способ поиска фильтр по объему продаж | ||
MaxVolume | Максимальный объем продаж | |||||
VolumeRangeLogic | Логика работы условий по объему продаж: диапазон, только минимум, только максимум. | |||||
Состояние товара (новый, б/у, неиспользованый) | StuffStatus | Состояние товара | StuffStatus | Поддерживает ли способ поиска фильтр по состоянию товара | ||
Характеристики товара (цвет, модель и тд) | Configurators | Список поисковых свойств, представленных структурой. | Configurators | Поддерживает ли способ поиска характеристики товара. | ||
MultipleConfiguratorLogic | Логика работы способа поиска по нескольким значениям одной характеристики. Использование в поиске нескольких значений одной характеристики. (например, можно вывести только красное, красное И зеленое, красное ИЛИ зеленое) | |||||
Особенности товара | Features | Список искомых фич товара | Features | Список специальных фильтров, поддерживаемых способом поиска | ||
Управление выдачей | OutputMode | Режим выдачи результатов поиска. По умолчанию делается обычный поиск, с выдачей товаров и всего сопутствующего. Другие варианты:
| ||||
CategoryMode | Режим выдачи категорий в результатах поиска. В результатах поиска помимо товаров есть еще, хоть и не всегда, список категорий, в которых находятся найденные товары. Обычно они называются уточняющими категориями. Есть несколько вариантов обработки и выдачи данного списка.
| |||||
IsClearItemTitles | Признак очистки заголовков товаров | . По умолчанию true, то есть поиск выдает только оригинальные не-переведенные названия товаров, т.к. в большинстве случаев названия не показываются в списке товаров, то данное поведение сильно экономит ресурсы транслятора и немного ускоряет получение результатов поиска. При значении false, в каждом товаре также выдается и переведенное название. | ||||
Устаревшие условия | IsOriginal | Признак выбора только оригинальных товаров | ||||
IsTmall | Признак выбора только товаров из Tmall |
Поиск по всем товарным провайдерам
Кроме того, если у вас к ключу подключено сразу несколько товарных провайдеров, есть вариант поиска сразу для всех товарных провайдеров и всех возможных условиях поиска. Для этого необходимо воспользоваться специальным поиском по OT API. Описание метода: BatchSearchItemsFrame
...
Примеры параметров с условиями поиска и запросов поиска
...тут надо примеры
Описание результатов поиска
...тут надо описание для OtapiItemSearchResult
Дополнительные блоки информации в BatchSearchItemsFrame
Используя метод BatchSearchItemsFrame, можно получить дополнительную информацию за тот же один запрос к OTAPI. Список дополнительных блоков передается в параметре blockList, через запятую. Результатом является BatchItemSearchResult, который включает в себя обычный OtapiItemSearchResult, а также все свойства для дополнительной информации.
Название блока | Описание |
---|---|