Для того, чтобы разобраться в том, как выполняется поиск товаров и какие настройки поиска можно сделать, необходимо изучить информацию, предложенную ниже.
Товарный провайдер
Товарный провайдер — это сервис (или площадка) для торговли. Именно от товарного провайдера поступает информация о товарах (названия, настройки, конфигурации и тд) и товарных категориях в OT API и потом, с помощью ключа, транслируется на сайт владельца ключа.
На данный момент доступны для подключения Taobao (включая Tmall), Yahoo.co.jp, 1688.com .
Получить список доступных провайдеров и некоторую информацию о них можно методом GetProviderInfoList.
Таобао и Tmall
Поиск по Таобао может осуществляться по разным направлениям. Направление напрямую зависит от задач сайта, на котором устанавливается ключ.
| Название | Идентификатор | Как работает |
|---|---|---|
| Расширенный поиск | Extended | Поиск осуществляется по всему каталогу Таобао, не включая товары Tmall |
| Tmall поиск | Official | В результатах поиска только товары Tmall |
Yahoo.co.jp
Содержит в себе 2 провайдера:
- Обычная продажа товаров.
- Аукционные товары.
Каждый провайдер имеет один поиск.
Свой каталог
С помощью дополнительного модуля «Товары на складе» появится провайдер «Склад», для которого можно создать и заполнить свой каталог товаров.
Подробнее о модуле и его подключении: http://key.otcommerce.com/ru/service-payments-rates
Способы поиска
У каждого товарного провайдера есть свой набор условий поиска. Этот набор можно варьировать под цели сайта. Получить список доступных способов поиска и полную информацию о том, что они поддерживают, можно методом GetProviderSearchMethodInfoList.
Условие поиска | Параметр для описания способа поиска | Применение условия поиска |
|---|---|---|
| Способ поиска | SearchMethod | Название способа поиска (Тип используемого поискового метода) Тип String |
Название способа поиска (на нужном языке) | DisplayName | Отображаемое название способа поиска (на нужном языке) Тип String |
Особенности выбранного способа поиска | Flags | Список особенностей способа поиска Тип ProviderSearchFlag[] |
| UseOptimalFrameSize | Признак использования оптимального размера фрейма вместо переданного Тип Nullable<Boolean> : Boolean | |
Количество выводимых товаров на одну страницу (влияет на скорость загрузки страницы и работу скорости поиска) | OptimalFrameSize | Оптимальное число запрашиваемых товаров (размер страницы) Тип Int32 |
| Максимальное количество товаров на страницу (влияет на скорость загрузки страницы и работу скорости поиска) | MaximumFrameSize | Максимальное число запрашиваемых товаров (размер страницы) Тип Int32 |
| Максимальное количество товаров выбранного способа поиска (влияет на скорость загрузки страницы и работу скорости поиска) | MaximumItemsCount | Максимальное число товаров, до которых может выдать способ поиска Тип Int32 |
| Сортировки в выбранном способе поиска | AvailableSorts | Список допустимых сортировок в способе поиска (OrderBy в параметрах поиска) Тип ProviderSearchSortInfo[] |
| Товарный провайдер | Provider | Тип провайдера Nullable<ItemProviderType> Тип ItemProviderType |
Поиск в категории | CategoryId | Идентификатор категории, в которой искать товары Тип String |
| CategoryMode | Режим выдачи категорий в результатах поиска Тип Nullable<SearchCategoryMode> : SearchCategoryMode | |
Название товара | нет параметра (доступен всегда) | |
| ItemTitle | Поисковая строка по названию товара Тип String | |
| Язык поиска | LanguageOfQuery | Язык поисковой строки по названию товара Тип String |
| Артикул товара | нет параметра (доступен всегда) | |
| Ссылка на товар | нет параметра (доступен всегда) | |
| Поиск товаров внутри категории | нет параметра (доступен всегда) | |
Имя продавца | Vendor | Поддерживает ли способ поиска продавца (VendorId в параметрах поиска) Тип Boolean |
| VendorName | Имя продавца Тип String | |
| VendorId | Идентификатор продавца Тип String | |
Местонахождение продавца | VendorLocation | Поддерживает ли способ поиска местонахождение продавца (VendorAreaId в параметрах поиска) Тип Boolean |
| VendorAreaId | Идентификатор местонахождения продавца (зоны) Тип String | |
По рейтингу продавца | VendorRatingRange | Поддерживает ли способ поиска фильтр по рейтингу продавца (MinVendorRating и MaxVendorRating в параметрах поиска) Тип Boolean |
| MinVendorRating | Минимальное значение рейтинга продавца Nullable<Int32> Тип Int32 | |
| MaxVendorRating | Максимальное значение рейтинга продавца Nullable<Int32> Тип Int32 | |
Название бренда | Brand | Поддерживает ли способ поиска бренды (BrandId в параметрах поиска) Тип Boolean |
| BrandId | Идентификатор искомой торговой марки Тип String | |
| BrandPropertyValueId | Идентификатор значения искомой торговой марки (устаревший параметр, используйте BrandId) Тип String | |
В диапазоне цен | PriceRange | Поддерживает ли способ поиска фильтр по цене товара (MinPrice и MaxPrice в параметрах поиска) Тип Boolean |
| MinPrice | Минимальная цена Тип Nullable<Decimal> : Decimal | |
| MaxPrice | Максимальная цена Тип Nullable<Decimal> : Decimal | |
По объему продаж | VolumeRange | Поддерживает ли способ поиска фильтр по объему продаж (MinVolume и MaxVolume в параметрах поиска) Тип Boolean |
| MinVolume | Минимальный объем продаж Тип Nullable<Int64> : Int64 | |
| MaxVolume | Максимальный объем продаж Тип Nullable<Int64> : Int64 | |
| По состоянию товара (новый, б/у, неиспользованый) | StuffStatus | Поддерживает ли способ поиска фильтр по состоянию товара (StuffStatus в параметрах поиска) Тип Boolean |
Характеристики товара (цвет, модель и тд) | Configurators | Список поисковых свойств, представленных структурой. Тип OtapiValuedConfigurator[] Поддерживает ли способ поиска характеристики товара (Configurators в параметрах поиска) Тип Boolean |
| Features | Список искомых фич товара Тип OtapiSearchFeature[] | |
| Аукционные товары | Features/Auction | Список специальных фильтров, поддерживаемых способом поиска (Features в параметрах поиска) Тип ProviderSearchFeatureInfo[] |
| Товары со скидками | Features/Discount | Список специальных фильтров, поддерживаемых способом поиска (Features в параметрах поиска) Тип ProviderSearchFeatureInfo[] |
Использование в поиске нескольких значений одной характеристики (например, можно вывести только красное, красное И зеленое, красное ИЛИ зеленое) | MultipleConfiguratorLogic | Логика работы способа поиска по нескольким значениям одной характеристики Тип SearchMethodConfiguratorLogic |
| OrderBy | Параметры сортировки Тип String | |
| OutputMode | Режим выдачи результатов поиска Тип Nullable<SearchOutputMode> : SearchOutputMode | |
| IsOriginal | Признак выбора только оригинальных товаров Тип Nullable<Boolean> : Boolean | |
| IsTmall | Признак выбора только товаров из Tmall Тип Nullable<Boolean> : Boolean | |
| StuffStatus | Состояние товара Тип Nullable<OtapiStuffStatus> : OtapiStuffStatus | |
| IsClearItemTitles | Признак очистки заголовков товаров Тип Nullable<Boolean> : Boolean |
Поиск по всем товарным провайдерам
Кроме того, если у вас к ключу подключено сразу несколько товарных провайдеров, есть вариант поиска сразу для всех товарных провайдеров и всех возможных условиях поиска. Для этого необходимо воспользоваться специальным поиском по OT API. Описание метода: BatchSearchItemsFrame
Что получаем еще вместе с поиском товара