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