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

Ключ

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

...

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

 

 

SearchMethodOfficialDefault 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.

   
   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

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Если не указано, или указанное значение не входит в число допустимых, будет использована определенная в настройках сортировка по умолчаниюDefault sorting set in settings will be used if value is not set or is not included into available.AvailableSorts Список допустимых сортировок в способе поискаList of available sorting in search method.

Category

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

Item title

ItemTitle

платье

dress

Search box for item title.

If only item ID (item code) or link to provider's website page is indicated then only this item will be found and shown in search results (or empty if there is no such product

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

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

   
LanguageOfQueryru

Search box language by item title. It is equal to language of goods query if not set.

Autotranslation to provider language is done if it is not equal to provider language

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

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

   

Vendor

VendorId Vendor IDVendortrue/falseПоддерживается ли поиск по продавцуIf search by vendor is supported.
VendorName Vendor name

Vendor area

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

Vendor rating

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

 

Поддерживает ли способ поиска фильтр по цене товара
If search method supports filter by item price.
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Поддерживает ли способ поиска фильтр по объему продаж If search method supports filter by sales volume. 
MaxVolume500Maximum sales volume
   VolumeRangeLogicNone / Range / OnlyMin / OnlyMaxЛогика работы условий по объему продаж: диапазон, только минимум, только максимум
The logic of conditions by sales volume: range, only minimum, only maximum.
Item status (new, second-hand, unused)StuffStatusNew / Unused / SecondItem statusStuffStatustrue/falseПоддерживает ли способ поиска фильтр по состоянию товараIf search method supports filter by item status.

Item configurations (color, model, etc.)

Configurators 

List of search features provided by structure.

 

Configuratorstrue/false

Поддерживает ли способ поиска характеристики товараIf search method supports item features.

MultipleConfiguratorLogicNone / All / And

The logic of search method by several values of one feature.

Use in search of several values of one feature (for example, it is possible to output only red AND green or red OR green).

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

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

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

 

Item featuresFeatures 

List of item features.

Features

 

Список специальных фильтров, поддерживаемых способом поискаList of special filters supported by search method.

Output modeOutputModeFull / TotalCount / Provider

Search results output mode.

Usual search with goods output and all related information is done. Other variants:

  • TotalCount — output of only total number of goods without information about goods.
    It is thus possible to get total number without wasting time for processing goods themselves.
  • Provider — output of only provider and search method without search itself. Provider and search method are defined on the basis of all search conditions and different settings

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

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

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

Categories in search results output mode.

There is categories list (not always) besides goods in search results. These categories include found goods. They are usually called clarifying categories. There are several variants of processing and output:

  • Nothing — no categories output (if they are unnecessary)
  • External — output of external categories as they are without cast to internal
  • InternalLeaf — external categories cast to internal final categories (in any place of catalog)
  • CurrentLevel — external categories cast to internal categories of current level or to root categories (if search was not by category) or to those inside category (if search was by category). Thus, clarifying categories never go beyond current level of directory view

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

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

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

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

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

Feature of goods titles cleanup.

True by default, that is search outputs only original untranslated goods titles. Such behavior strongly saves translator resources and speeds up search results output as in most cases titles are not shown in goods list.

Each item also has translated title if value is false.

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

   
Old conditionsIsOriginaltrue/falseПризнак выбора только оригинальных товаровFeature of only original goods choice.   
IsTmalltrue/falseПризнак выбора только товаров из TmallFeature of only Tmall goods choice.   

 

Примеры параметров с условиями поиска и запросов поиска

...