Получение предложений запроса, с помощью службы Search REST
Узнайте, как с помощью службы поиска REST из клиентских и мобильных приложений получить предложения запроса из поиска в SharePoint. Предложения запроса, также известной как предложения поиска, фраз, которые пользователи уже выполнен поиск и, или отобразить «предложенные» им как люди вводят свои запросы. Можно использовать поиск в SharePoint для включения предложений до и после запроса. Эти предложения отображаются в списке под полем поиска, когда пользователь вводит запрос. Дополнительные сведения о предложениях запросов и их включении см. в статье Управление предложениями запросов в SharePoint.
Предложение конечной точки в службе поиска Search REST
Службы REST поиска включает в себя Suggest конечной точки, которые можно использовать в любой технологии, поддерживающей веб-запросы REST для получения предложений запроса, поисковая система генерирует для запросов от клиента или приложения для мобильных устройств.
URI для GET запросов к конечной точке службы поиска REST Suggest это:
/_api/search/suggest
В URL-адрес заданы параметры предложения запроса. Можно создать URL-адрес запроса двумя способами:
http://server/_api/search/suggest?parameter=value&parameter=value
http://server/_api/search/suggest(parameter=value&parameter=value)
Примечание.
Службы поиска REST не поддерживает анонимные запросы к конечной точке Suggest.
Параметры предложений запроса
В следующих разделах описываются параметры, которые можно использовать для конечной точки Suggest.
Querytext
Строка, содержащая текст для запроса поиска.
Пример запроса GET
http:// server/_api/search/suggest?querytext = "sharepoint"
iNumberOfQuerySuggestions
Количество предложений запроса для извлечения. Должен быть больше нуля (0). Значение по умолчанию 5.
Пример запроса GET
http:// server/_api/search/suggest?querytext='sharepoint'&inumberofquerysuggestions=3
iNumberOfResultSuggestions
Число личных результаты для извлечения. Должен быть больше нуля (0). Значение по умолчанию 5.
Пример запроса GET
http:// server/_api/search/suggest?querytext='sharepoint'&inumberofresultsuggestions=4
fPreQuerySuggestions
Логическое значение, указывающее, следует ли извлекать предложения запроса до или после запроса. true для возврата предложения перед запроса; в противном случае false. Значение по умолчанию false.
Пример запроса GET
http:// server/_api/search/suggest?querytext='sharepoint'&fprequerysuggestions=true
fHitHighlighting
Логическое значение, которое указывает, следует ли для сбора данных для выделения и форматирования полужирным шрифтом предложений запроса. true форматирование полужирным шрифтом условия предложений возвращенные запроса, которые соответствуют терминов в указанного запроса; в противном случае false. Значение по умолчанию true.
Пример запроса GET
http:// server/_api/search/suggest?querytext='sharepoint'&fhithighlighting=false
fCapitalizeFirstLetters
Логическое значение, которое указывает, следует ли преобразование первой буквы в каждого термина в предложения возвращенные запроса. true прописной первую букву в каждом терминов; в противном случае false. Значение по умолчанию false.
Пример запроса GET
http:// server/_api/search/suggest?querytext='sharepoint'&fcapitalizefirstletters=false
Culture
Идентификатор языкового стандарта (LCID) для запроса (см. раздел Идентификаторы языковых стандартов, назначенные корпорацией Майкрософт).
Пример запроса GET
http:// server/_api/search/suggest?querytext='sharepoint'&culture=1044
EnableStemming
Логическое значение, указывающее, включено ли выделение корней. true, чтобы включить извлечение корней слов; в противном случае false. Значение по умолчанию true.
Пример запроса GET
http:// server/_api/search/suggest?querytext='sharepoint'&enablestemming=false
ShowPeopleNameSuggestions
Логическое значение, указывающее, следует ли включать имена людей в предложения возвращенные запроса. true для включения имен людей в предложения возвращенные запроса; в противном случае false. Значение по умолчанию true.
Пример запроса GET
http:// server/_api/search/suggest?querytext='sharepoint'&showpeoplenamesuggestions=false
EnableQueryRules
Логическое значение, которое указывает, следует ли включить правила запросов для этого запроса. true Включение правила запросов; в противном случае false. Значение по умолчанию true.
Пример запроса GET
http:// server/_api/search/suggest?querytext='sharepoint'&enablequeryrules=false
fPrefixMatchAllTerms
Сопоставляет значение Boolean, указывающее, нужно ли возвращать предложения запроса для префикса. true для возврата на основе префикса предложений запроса соответствует, в противном случае false при предложений запроса должна соответствовать word полного запроса.
Пример запроса GET
http:// server/_api/search/suggest?querytext='sharepoint'&fprefixmatchallterms=false