Partilhar via


Recuperando as sugestões de consulta usando o serviço de pesquisa restante

Saiba como você pode usar o serviço de pesquisa REST seu cliente e aplicativos móveis para recuperar sugestões de consulta de pesquisa no SharePoint. Sugestões de consulta, também conhecido como sugestões de pesquisa, são frases que os usuários já tem procurado e que são exibidas ou "sugerido" para acessá-los enquanto eles digitam suas consultas. Você pode usar a pesquisa no SharePoint para ativar as sugestões de consulta prévia e posteriores. As sugestões aparecem em uma lista abaixo da Caixa de Pesquisa conforme um usuário digita uma consulta. Para obter mais informações sobre sugestões de consulta e como habilitá-las, consulte Gerenciar sugestões de consulta no SharePoint.

Sugerir o ponto de extremidade no serviço de pesquisa REST

O serviço REST de pesquisa inclui um ponto de extremidade de Suggest que você pode usar em qualquer tecnologia que ofereça suporte a solicitações da web REST para recuperar as sugestões de consulta que o sistema de pesquisa gera para uma consulta de cliente ou aplicativos móveis.

O URI para solicitações de GET ao ponto de extremidade do serviço REST de pesquisa Suggest é:

/_api/search/suggest

Os parâmetros de sugestão de consulta são especificados na URL. Você pode construir a URL da solicitação de duas maneiras:

http://server/_api/search/suggest?parameter=value&parameter=value

http://server/_api/search/suggest(parameter=value&parameter=value)

Observação

O serviço REST de pesquisa não oferece suporte a solicitações anônimas ao ponto de extremidade Suggest.

Parâmetros de sugestão de consulta

As seções a seguir descrevem os parâmetros que você pode usar para o ponto de extremidade de Suggest.

QueryText

Uma cadeia de caracteres que contém o texto da consulta de pesquisa.

Exemplo de solicitação GET

http:// server/_api/search/suggest?querytext = 'sharepoint'

iNumberOfQuerySuggestions

O número de sugestões de consulta para recuperar. Deve ser maior que zero (0). O valor padrão é 5.

Exemplo de solicitação OBTER

http:// servidor/_api/search/suggest?querytext='sharepoint'&inumberofquerysuggestions=3

iNumberOfResultSuggestions

O número de resultados pessoais para recuperar. Deve ser maior que zero (0). O valor padrão é 5.

Exemplo de solicitação OBTER

http:// servidor/_api/search/suggest?querytext='sharepoint'&inumberofresultsuggestions=4

fPreQuerySuggestions

Um valor Boolean que especifica se é necessário recuperar sugestões de consultas prévia ou pós consultas de. true para retornar as sugestões de pré consulta; Caso contrário, false. O valor padrão é false.

Exemplo de solicitação GET

http:// servidor/_api/search/suggest?querytext='sharepoint'&fprequerysuggestions=true

fHitHighlighting

Um valor Boolean que especifica se é para realçar os sucessos ou formatar em negrito sugestões de consulta. true para formatar em negrito os termos do sugestões de consulta retornado que correspondam aos termos da consulta especificada; Caso contrário, false. O valor padrão é true.

Exemplo de solicitação GET

http:// servidor/_api/search/suggest?querytext='sharepoint'&fhithighlighting=false

fCapitalizeFirstLetters

Um valor Boolean que especifica se é necessário maiúscula a primeira letra de cada termo na sugestões de consulta retornado. true em maiúscula a primeira letra de cada termo; Caso contrário, false. O valor padrão é false.

Exemplo de solicitação GET

http:// server/_api/search/suggest?querytext='sharepoint'&fcapitalizefirstletters=false

Cultura

A ID da localidade (LCID) para a consulta (consulte IDs de localidade atribuídas pela Microsoft).

Exemplo de solicitação OBTER

http:// servidor/_api/search/suggest?querytext='sharepoint'&culture=1044

EnableStemming

Um valor booliano que especifica se a lematização está habilitada. true para habilitar a lematização; Caso contrário, false. O valor padrão é true.

Exemplo de solicitação GET

http:// servidor/_api/search/suggest?querytext='sharepoint'&enablestemming=false

ShowPeopleNameSuggestions

Um valor Boolean que especifica se é necessário incluir os nomes de pessoas em sugestões de consulta retornado. true para incluir nomes de pessoas em sugestões de consulta retornado; Caso contrário, false. O valor padrão é true.

Exemplo de solicitação GET

http:// servidor/_api/search/suggest?querytext='sharepoint'&showpeoplenamesuggestions=false

EnableQueryRules

Um valor Boolean que especifica se é necessário ativar as regras de consulta para esta consulta. true para ativar as regras de consulta; Caso contrário, false. O valor padrão é true.

Exemplo de solicitação GET

http:// servidor/_api/search/suggest?querytext='sharepoint'&enablequeryrules=false

fPrefixMatchAllTerms

Corresponde a um valor Boolean que especifica se é necessário retornar sugestões de consulta de prefixo. Caso contrário, true para retornar as sugestões de consulta com base no prefixo corresponde false quando sugestões de consulta devem corresponder a palavra de consulta completa.

Exemplo de solicitação OBTER

http:// servidor/_api/search/suggest?querytext='sharepoint'&fprefixmatchallterms=false

Confira também