...
Search conditions are also identical. They are sent into xmlParameters and presented by structure OtapiSearchItemsParameters. It has xml format (like other structure parameters). Examples will be described below.
В следующей таблице представлено сравнительное описание условий поиска, как они представлены в структуре параметров, и как они представлены в описании способов поиска.The following table provides a comparative description of search methods as they appear in parameters structure and how they are presented in search methods description.
Parameter | Search methods | Search method information | ||||
|---|---|---|---|---|---|---|
| Parameter name | Value example | Parameter desription | Parameter title | Value example | Parameter desription | |
| Provider | ||||||
Параметр
Название параметра
| Provider | Taobao | Если в условиях поиска не указан провайдер явно, он будет определен по другим условиям (например, категории). Если ни одно условие не определяет провайдера, поиск будет произведен в провайдере по умолчанию. Если разные условия поиска ведут к различным провайдерам, то такой поиск невозможен и приведет к ошибке. | Provider | Taobao | Идентификатор провайдера |
| Search method
| SearchMethod | Official | Если не указано, используется определенный в настройках способ поиска по умолчанию. | SearchMethod | Official | Название способа поиска |
| DisplayName | Фирменные товары (Tmall) | Отображаемое название способа поиска (на нужном языке) | ||||
| Flags | Список особенностей способа поиска |
| Goods quantity limitations | UseOptimalFrameSize | true/false | Признак использования оптимального размера фрейма вместо переданного. Если данное условие передано в значении true, то параметр frameSize игнорируется, и будет использовано OptimalFrameSize из выбранного способа поиска. | |||
| OptimalFrameSize | 40 | Оптимальное число запрашиваемых товаров (размер страницы). Если использовать страницы данного размера, это обеспечивает максимальную возможную скорость работы поиска, т.к. оно соответствует размерам страниц у провайдера. | ||||
| MaximumFrameSize | 200 | Максимальное число товаров, которое можно получить за 1 запрос. Может работать значительно медленнее, чем при использовании оптимального числа. | ||||
| MaximumItemsCount | 4000 | Число товаров, до которого в принципе можно получить по одним и тем же условиям поиска. Чтобы получать больше товаров, надо менять и уточнять условия поиска. |
| Goods order | OrderBy | Price:Asc | Если не указано, или указанное значение не входит в число допустимых, будет использована определенная в настройках сортировка по умолчанию. | AvailableSorts | Список допустимых сортировок в способе поиска. |
Category | CategoryId | 16 | Идентификатор категории, в которой искать товары. |
Item title | ItemTitle | платье | Поисковая строка по названию товара. Если в поисковой строке указаны только идентификатор (артикул) товара или ссылка на страницу на сайте провайдера, то будет найден и выдан именно этот единственный товар (или пусто, если таковой товар отсутствует). | |||
| LanguageOfQuery | ru | Язык поисковой строки по названию товара. Если не указан, считается равным языку выдачи товаров. Если не равен языку провайдера, то производится автоперевод на язык провайдера. |
Vendor | VendorId | Идентификатор продавца | Vendor | true/false | Поддерживается ли поиск по продавцу | |
| VendorName | Имя продавца |
Vendor area | VendorAreaId | Идентификатор местонахождения продавца (зоны) | VendorLocation | true/false | Поддерживает ли способ поиска местонахождение продавца |
Vendor rating | VendorRatingRange | true/false | Поддерживает ли способ поиска фильтр по рейтингу продавца | |||
| MinVendorRating | 5 | Минимальное значение рейтинга продавца | MinVendorRating | 1 | Минимальное значение рейтинга продавца | |
| MaxVendorRating | 15 | Максимальное значение рейтинга продавца | MaxVendorRating | 20 | Максимальное значение рейтинга продавца |
| Brand | BrandId | Идентификатор искомой торговой марки | Brand | true/false | Поддерживает ли способ поиска бренды | |
| BrandPropertyValueId | Идентификатор значения искомой торговой марки (устаревший параметр, используйте BrandId) |
| Price | MinPrice | 10 | Минимальная цена | PriceRange | true/false
| Поддерживает ли способ поиска фильтр по цене товара |
| MaxPrice | 1000 | Максимальная цена | ||||
| CurrencyCode | CNY | Код валюты, в которой указан диапазон цен. |
Sales volume | MinVolume | 100 | Минимальный объем продаж | VolumeRange | true/false | Поддерживает ли способ поиска фильтр по объему продаж |
| MaxVolume | 500 | Максимальный объем продаж | ||||
| VolumeRangeLogic | None / Range / OnlyMin / OnlyMax | Логика работы условий по объему продаж: диапазон, только минимум, только максимум. |
| Item status ( |
| new, second-hand, unused) | StuffStatus | New / Unused / Second | Состояние товара | StuffStatus | true/false | Поддерживает ли способ поиска фильтр по состоянию товара |
Item configurations (color, model, etc.) | Configurators | Список поисковых свойств, представленных структурой. | Configurators | true/false | Поддерживает ли способ поиска характеристики товара. | |
| MultipleConfiguratorLogic | None / All / And | Логика работы способа поиска по нескольким значениям одной характеристики. Использование в поиске нескольких значений одной характеристики. (например, можно вывести только красное, красное И зеленое, красное ИЛИ зеленое)
|
| Item features | Features | Список искомых фич товара | Features | Список специальных фильтров, поддерживаемых способом поиска |
| Output mode | OutputMode | Full / TotalCount / Provider | Режим выдачи результатов поиска. По умолчанию делается обычный поиск, с выдачей товаров и всего сопутствующего. Другие варианты:
| |||
| CategoryMode | Nothing / External / InternalLeaf / CurrentLevel | Режим выдачи категорий в результатах поиска. В результатах поиска помимо товаров есть еще, хоть и не всегда, список категорий, в которых находятся найденные товары. Обычно они называются уточняющими категориями. Есть несколько вариантов обработки и выдачи данного списка.
| ||||
| IsClearItemTitles | true/false | Признак очистки заголовков товаров. По умолчанию true, то есть поиск выдает только оригинальные не-переведенные названия товаров, т.к. в большинстве случаев названия не показываются в списке товаров, то данное поведение сильно экономит ресурсы транслятора и немного ускоряет получение результатов поиска. При значении false, в каждом товаре также выдается и переведенное название. |
| Old conditions | IsOriginal | true/false | Признак выбора только оригинальных товаров | |||
| IsTmall | true/false | Признак выбора только товаров из Tmall |
Примеры параметров с условиями поиска и запросов поиска
...
| Название блока | Описание | ||
|---|---|---|---|
| SubCategories | сразу получить подкатегории, если поиск был по категории | ||
| SearchProperties | сразу получить фильтры по характеристикам/свойствам | ||
| RootPath | сразу получить путь к корню, если поиск был по категории | ||
| Vendor | сразу получить информацию о продавце, если поиск был по продавцу | ||
| Brand | сразу получить информацию о бренде, если поиск был по бренду | ||
| Category | сразу получить информацию о категории, если поиск был по категории | ||
| HintCategories | сразу получить подходящие по названию категории, если поиск был по тексту | ||
| get all subcategories if search by category | |||
| SearchProperties | get filters by characteristics/properties | ||
| RootPath | get path to root if search by category | ||
| Vendor | get information on seller if search by seller | ||
| Brand | get information on brand if search by brand | ||
| Category | get information on category of search by category | ||
| HintCategories | get appropriate categories for title if search by text | ||
| AvailableSearchMethods | get list of appropriate matching data for search methods parameters and all information on them | AvailableSearchMethods | сразу получить список подходящих под данные параметры способов поиска, и всю информацию по ним |