Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Parameter

Search methodsSearch method information
Parameter nameValue exampleParameter desription

Parameter title

Value exampleParameter desription
ProviderProviderTaobao

Если в условиях поиска не указан провайдер явно, он будет определен по другим условиям (например, категории). Если ни одно условие не определяет провайдера, поиск будет произведен в провайдере по умолчанию.

Если разные условия поиска ведут к различным провайдерам, то такой поиск невозможен и приведет к ошибке.

ProviderTaobaoИдентификатор провайдераProvider ID
Search method

 

 

SearchMethodOfficialЕсли не указано, используется определенный в настройках способ поиска по умолчанию.SearchMethodOfficialНазвание способа поискаSearch method title
DisplayNameФирменные товары (Tmall)Отображаемое название способа поиска (на нужном языкеDisplayed search method title (in necessary language)
Flags Список особенностей способа поискаList of search method features
Goods quantity limitationsUseOptimalFrameSizetrue/false

Признак использования оптимального размера фрейма вместо переданного.

Если данное условие передано в значении true, то параметр frameSize игнорируется, и будет использовано OptimalFrameSize из выбранного способа поиска.

   
   OptimalFrameSize40

Оптимальное число запрашиваемых товаров (размер страницыOptimal number of requested goods (page size).

Если использовать страницы данного размера, это обеспечивает максимальную возможную скорость работы поиска, т.к. оно соответствует размерам страниц у провайдера.

   MaximumFrameSize200Максимальное число товаров, которое можно получить за 1 запрос. Может работать значительно медленнее, чем при использовании оптимального числа.
   MaximumItemsCount4000Число товаров, до которого в принципе можно получить по одним и тем же условиям поиска. Чтобы получать больше товаров, надо менять и уточнять условия поиска.
Goods orderOrderByPrice:AscЕсли не указано, или указанное значение не входит в число допустимых, будет использована определенная в настройках сортировка по умолчанию.AvailableSorts Список допустимых сортировок в способе поиска.

Category

CategoryId16Идентификатор категории, в которой искать товары.   

Item title

ItemTitle

платье

Поисковая строка по названию товара.

Если в поисковой строке указаны только идентификатор (артикул) товара или ссылка на страницу на сайте провайдера, то будет найден и выдан именно этот единственный товар (или пусто, если таковой товар отсутствует).

   
LanguageOfQueryru

Язык поисковой строки по названию товара. Если не указан, считается равным языку выдачи товаров.

Если не равен языку провайдера, то производится автоперевод на язык провайдера.

   

Vendor

VendorId Идентификатор продавцаVendortrue/falseПоддерживается ли поиск по продавцу
VendorName Имя продавца

Vendor area

VendorAreaId Идентификатор местонахождения продавца (зоны)VendorLocationtrue/falseПоддерживает ли способ поиска местонахождение продавца

Vendor rating

 
   VendorRatingRangetrue/falseПоддерживает ли способ поиска фильтр по рейтингу продавца
MinVendorRating5Минимальное значение рейтинга продавцаMinVendorRating1Минимальное значение рейтинга продавца
MaxVendorRating15Максимальное значение рейтинга продавцаMaxVendorRating20Максимальное значение рейтинга продавца
BrandBrandId Идентификатор искомой торговой марки
Brand
true/falseПоддерживает ли способ поиска бренды
BrandPropertyValueId Идентификатор значения искомой торговой марки (устаревший параметр, используйте BrandId)
PriceMinPrice10Минимальная ценаPriceRangetrue/false

 

Поддерживает ли способ поиска фильтр по цене товара
MaxPrice1000Максимальная цена
CurrencyCodeCNY

Код валюты, в которой указан диапазон цен.
По умолчанию считается первая витринная валюта. Для поиска конвертируется по обратным правилам наценок и курсов в валюту провайдера.

Sales volume

MinVolume100Минимальный объем продажVolumeRange true/falseПоддерживает ли способ поиска фильтр по объему продаж 
MaxVolume500Максимальный объем продаж
   VolumeRangeLogicNone / Range / OnlyMin / OnlyMaxЛогика работы условий по объему продаж: диапазон, только минимум, только максимум.
Item status (new, second-hand, unused)StuffStatusNew / Unused / SecondСостояние товараStuffStatustrue/falseПоддерживает ли способ поиска фильтр по состоянию товара

Item configurations (color, model, etc.)

Configurators 

Список поисковых свойств, представленных структурой.

Configuratorstrue/false

Поддерживает ли способ поиска характеристики товара.

MultipleConfiguratorLogicNone / All / And

Логика работы способа поиска по нескольким значениям одной характеристики.

Использование в поиске нескольких значений одной характеристики.

(например, можно вывести только красное, красное И зеленое, красное ИЛИ зеленое)

 

Item featuresFeatures 

Список искомых фич товара

Features

 

Список специальных фильтров, поддерживаемых способом поиска

Output modeOutputModeFull / TotalCount / Provider

Режим выдачи результатов поиска.

По умолчанию делается обычный поиск, с выдачей товаров и всего сопутствующего. Другие варианты:

  • TotalCount — Выдача только общего количества товаров, без самих данных о товарах. Тем самым можно получить общее количество по данным условиям поиска, и не тратить время на обработку самих товаров.
  • Provider — Выдача только провайдера и способа поиска, которыми бы производился поиск, без самого поиска. Провайдер и способ поиска определяются на основе всех переданных условий поиска и различных настроек.
   
CategoryModeNothing / External / InternalLeaf / CurrentLevel

Режим выдачи категорий в результатах поиска.

В результатах поиска помимо товаров есть еще, хоть и не всегда, список категорий, в которых находятся найденные товары. Обычно они называются уточняющими категориями. Есть несколько вариантов обработки и выдачи данного списка.

  • Nothing — Отсутствие выдачи категорий (если они не нужны)
  • External — Выдача внешних категорий как есть, без приведения к внутренним
  • InternalLeaf — Приведение внешних категорий к внутренним конечным (в любом месте каталога)
  • CurrentLevel — Приведение внешних категорий к внутренним категориям текущего уровня. Если поиск не по категории, то к корневым. Если поиск по категории, то к тем что внутри неё. Тем самым уточняющие категории никогда не выходят за рамки текущего уровня просмотра каталога.
   
IsClearItemTitlestrue/false

Признак очистки заголовков товаров.

По умолчанию true, то есть поиск выдает только оригинальные не-переведенные названия товаров, т.к. в большинстве случаев названия не показываются в списке товаров, то данное поведение сильно экономит ресурсы транслятора и немного ускоряет получение результатов поиска.

При значении false, в каждом товаре также выдается и переведенное название.

   
Old conditionsIsOriginaltrue/falseПризнак выбора только оригинальных товаров   
IsTmalltrue/falseПризнак выбора только товаров из Tmall   

...