Для того, чтобы разобраться в том, как выполняется поиск товаров и какие настройки поиска можно сделать, необходимо изучить информацию, предложенную ниже.
Товарный провайдер
Товарный провайдер — это сервис (или площадка) для торговли. Именно от товарного провайдера поступает информация о товарах (названия, настройки, конфигурации и тд) и товарных категориях в 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 | Максимальное значение рейтинга продавца | |||
Название бренда | BrandId | Идентификатор искомой торговой марки | Brand | Поддерживает ли способ поиска бренды (BrandId в параметрах поиска) |
BrandPropertyValueId | Идентификатор значения искомой торговой марки (устаревший параметр, используйте BrandId) | |||
В диапазоне цен | MinPrice | Минимальная цена | PriceRange | Поддерживает ли способ поиска фильтр по цене товара (MinPrice и MaxPrice в параметрах поиска) |
MaxPrice | Максимальная цена | |||
По объему продаж | MinVolume | Минимальный объем продаж | VolumeRange | Поддерживает ли способ поиска фильтр по объему продаж (MinVolume и MaxVolume в параметрах поиска) |
MaxVolume | Максимальный объем продаж | |||
По состоянию товара (новый, б/у, неиспользованый) | StuffStatus | Состояние товара | StuffStatus | Поддерживает ли способ поиска фильтр по состоянию товара (StuffStatus в параметрах поиска) |
Характеристики товара (цвет, модель и тд) | Configurators | Список искомых свойств товара | Список поисковых свойств, представленных структурой. Поддерживает ли способ поиска характеристики товара (Configurators в параметрах поиска) | |
Аукционные товары | Features/Auction | Features | Список специальных фильтров, поддерживаемых способом поиска (Features в параметрах поиска) | |
Товары со скидками | Features/Discount | |||
Использование в поиске нескольких значений одной характеристики (например, можно вывести только красное, красное И зеленое, красное ИЛИ зеленое) | OrderBy | Параметры сортировки | MultipleConfiguratorLogic | Логика работы способа поиска по нескольким значениям одной характеристики |
OutputMode | Режим выдачи результатов поиска | |||
IsOriginal | Признак выбора только оригинальных товаров | |||
IsTmall | Признак выбора только товаров из Tmall | |||
IsClearItemTitles | Признак очистки заголовков товаров | |||
Поиск по всем товарным провайдерам
Кроме того, если у вас к ключу подключено сразу несколько товарных провайдеров, есть вариант поиска сразу для всех товарных провайдеров и всех возможных условиях поиска. Для этого необходимо воспользоваться специальным поиском по OT API. Описание метода: BatchSearchItemsFrame
Что получаем еще вместе с поиском товара