Для того, чтобы разобраться в том, как выполняется поиск товаров и какие настройки поиска можно сделать, необходимо изучить информацию, предложенную ниже.
Товарный провайдер
Товарный провайдер — это сервис (или площадка) для торговли. Именно от товарного провайдера поступает информация о товарах (названия, настройки, конфигурации и тд) и товарных категориях в 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 | Идентификатор категории, в которой искать товары. | ||
Название товара | ItemTitle | Поисковая строка по названию товара. Если в поисковой строке указаны только идентификатор (артикул) товара или ссылка на страницу на сайте провайдера, то будет найден и выдан именно этот единственный товар (или пусто, если таковой товар отсутствует). | ||
| LanguageOfQuery | Язык поисковой строки по названию товара. Если не указан, считается равным языку выдачи товаров. Если не равен языку провайдера, то производится автоперевод на язык провайдера. | |||
Продавец | VendorId | Идентификатор продавца | Vendor | Поддерживается ли поиск по продавцу |
| VendorName | Имя продавца | |||
Местонахождение продавца | VendorAreaId | Идентификатор местонахождения продавца (зоны) | VendorLocation | Поддерживает ли способ поиска местонахождение продавца |
Рейтинг продавца | MinVendorRating | Минимальное значение рейтинга продавца | VendorRatingRange | Поддерживает ли способ поиска фильтр по рейтингу продавца |
| MaxVendorRating | Максимальное значение рейтинга продавца | |||
| Бренд | BrandId | Идентификатор искомой торговой марки | Brand | Поддерживает ли способ поиска бренды |
| BrandPropertyValueId | Идентификатор значения искомой торговой марки (устаревший параметр, используйте BrandId) | |||
| Цена | MinPrice | Минимальная цена | PriceRange | Поддерживает ли способ поиска фильтр по цене товара |
| MaxPrice | Максимальная цена | |||
| CurrencyCode | Код валюты, в которой указан диапазон цен. | |||
Объем продаж | MinVolume | Минимальный объем продаж | VolumeRange | Поддерживает ли способ поиска фильтр по объему продаж |
| MaxVolume | Максимальный объем продаж | |||
| VolumeRangeLogic | Логика работы условий по объему продаж: диапазон, только минимум, только максимум. | |||
| Состояние товара (новый, б/у, неиспользованый) | StuffStatus | Состояние товара | StuffStatus | Поддерживает ли способ поиска фильтр по состоянию товара |
Характеристики товара (цвет, модель и тд) | Configurators | Список поисковых свойств, представленных структурой. | Configurators | Поддерживает ли способ поиска характеристики товара. |
| MultipleConfiguratorLogic | Логика работы способа поиска по нескольким значениям одной характеристики. Использование в поиске нескольких значений одной характеристики. (например, можно вывести только красное, красное И зеленое, красное ИЛИ зеленое) | |||
| Особенности товара | Features | Список искомых фич товара | Features | Список специальных фильтров, поддерживаемых способом поиска |
| Управление выдачей | OutputMode | Режим выдачи результатов поиска | ||
| CategoryMode | Режим выдачи категорий в результатах поиска | |||
| IsClearItemTitles | Признак очистки заголовков товаров | |||
| Устаревшие условия | IsOriginal | Признак выбора только оригинальных товаров | ||
| IsTmall | Признак выбора только товаров из Tmall |
Поиск по всем товарным провайдерам
Кроме того, если у вас к ключу подключено сразу несколько товарных провайдеров, есть вариант поиска сразу для всех товарных провайдеров и всех возможных условиях поиска. Для этого необходимо воспользоваться специальным поиском по OT API. Описание метода: BatchSearchItemsFrame
Что получаем еще вместе с поиском товара