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

Ключ

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

...

Parameter

Search methodsSearch method information
Parameter nameValue exampleParameter desription

Parameter title

Value exampleParameter desription
ProviderProviderTaobao

Provider will be defined by other conditions (for example, categories) if provider was not explicitly specified in search methods. Search will be done by default provider if none of conditions defines provider.


Search is impossible and will give an error if different search methods lead to different providers. 

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

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

ProviderTaobaoProvider ID
Search method

 

 

SearchMethodOfficialЕсли не указано, используется определенный в настройках способ поиска по умолчаниюDefault search method defined in settings is used if another one is not set.SearchMethodOfficialSearch method title
DisplayNameBranded goods (Tmall)Displayed search method title (in necessary language)
Flags List of search method features
Goods quantity limitationsUseOptimalFrameSizetrue/false

Feature of using optimal frame size insted of sent one.

frameSize parameter is ignored and OptimalFrameSize parameter will be used from chosen search method if this condition was sent in true value

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

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

   
   OptimalFrameSize40

Optimal number of requested goods (page size).Если использовать страницы данного размера, это обеспечивает максимальную возможную скорость работы поиска, т.к. оно соответствует размерам страниц у провайдера

Maximum possible search speed is available if such size of pages is used because
it meets size of provider's pages.
   MaximumFrameSize200Максимальное число товаров, которое можно получить за 1 запрос. Может работать значительно медленнее, чем при использовании оптимального числа

Maximum quantity of pages received for 1 query.

It can work much faster when using optimum number.

   MaximumItemsCount4000Число товаров, до которого в принципе можно получить по одним и тем же условиям поиска. Чтобы получать больше товаров, надо менять и уточнять условия поиска

Number of goods received by the same search methods. Change and define search conditions to receive more goods.

Goods orderOrderByPrice:AscЕсли не указано, или указанное значение не входит в число допустимых, будет использована определенная в настройках сортировка по умолчанию.AvailableSorts Список допустимых сортировок в способе поиска.

Category

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

Item title

ItemTitle

платье

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

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

   
LanguageOfQueryru

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

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

   

Vendor

VendorId Vendor IDVendortrue/falseПоддерживается ли поиск по продавцу
VendorName Vendor name

Vendor area

VendorAreaId Vendor area IDVendorLocationtrue/falseПоддерживает ли способ поиска местонахождение продавца

Vendor rating

 
   VendorRatingRangetrue/falseПоддерживает ли способ поиска фильтр по рейтингу продавца
MinVendorRating5Minimum value of vendor ratingMinVendorRating1Минимальное значение рейтинга продавца
MaxVendorRating15Maximum value of vendor ratingMaxVendorRating20Максимальное значение рейтинга продавца
BrandBrandId Brand ID
Brand
true/falseПоддерживает ли способ поиска бренды
BrandPropertyValueId Vrand Value ID (old parameter, use BrandId)
PriceMinPrice10Minimum pricePriceRangetrue/false

 

Поддерживает ли способ поиска фильтр по цене товара
MaxPrice1000Maximum price
CurrencyCodeCNY

Currency code for price range
First showcase currency is default one. It is converted by reverse charge and courses into provider currency for search.

 

Sales volume

MinVolume100Minimum sales volumeVolumeRange true/falseПоддерживает ли способ поиска фильтр по объему продаж 
MaxVolume500Maximum sales volume
   VolumeRangeLogicNone / Range / OnlyMin / OnlyMaxЛогика работы условий по объему продаж: диапазон, только минимум, только максимум.
Item status (new, second-hand, unused)StuffStatusNew / Unused / SecondItem statusStuffStatustrue/falseПоддерживает ли способ поиска фильтр по состоянию товара

Item configurations (color, model, etc.)

Configurators 

List of search features provided by structure.

 

Configuratorstrue/false

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

MultipleConfiguratorLogicNone / All / And

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

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

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

 

Item featuresFeatures 

List of item features.

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   

...