Recuperación de sugerencias de consulta con el servicio REST de búsqueda
Obtenga información acerca de cómo puede usar el servicio REST de búsqueda de su cliente y aplicaciones móviles para recuperar sugerencias de consulta de la búsqueda en SharePoint. Sugerencias de consulta, también conocido como sugerencias de búsqueda, son frases que los usuarios ya han buscado y que se muestran o "sugeridas" a ellos mientras escriben sus consultas. Puede usar la búsqueda en SharePoint para activar las sugerencias anteriores y posteriores a la consulta. Estas sugerencias aparecen en una lista bajo el cuadro de búsqueda a medida que el usuario está escribiendo una consulta. Para obtener más información sobre las sugerencias de consulta y cómo habilitarlas, vea Administrar sugerencias de consulta en SharePoint.
Sugerir extremo en el servicio REST de búsqueda
El servicio REST de búsqueda incluye un extremo de Suggest que puede usar en cualquier tecnología que es compatible con las solicitudes web REST para recuperar sugerencias de consulta que genera el sistema de búsqueda para una consulta de cliente o aplicaciones móviles.
Es el identificador URI para las solicitudes de GET al extremo de Suggest del servicio REST de búsqueda:
/_api/search/suggest
Se especifican los parámetros de la sugerencia de consulta en la dirección URL. Puede crear la dirección URL de solicitud de dos maneras:
http://server/_api/search/suggest?parameter=value&parameter=value
http://server/_api/search/suggest(parameter=value&parameter=value)
Nota:
El servicio REST de búsqueda no admite solicitudes anónimas al extremo del Suggest.
Parámetros de sugerencias de consulta
Las secciones siguientes describen los parámetros que puede utilizar para el extremo de Suggest.
Querytext
Una cadena que contiene el texto de la consulta de búsqueda.
Ejemplo de solicitud GET
http:// server/_api/search/suggest?querytext = 'sharepoint'
iNumberOfQuerySuggestions
El número de sugerencias de consulta para recuperar. Debe ser mayor que cero (0). El valor predeterminado es 5.
Ejemplo de solicitud GET
http:// server/_api/search/suggest?querytext='sharepoint'&inumberofquerysuggestions=3
iNumberOfResultSuggestions
El número de resultados personales para recuperar. Debe ser mayor que cero (0). El valor predeterminado es 5.
Ejemplo de solicitud GET
http:// server/_api/search/suggest?querytext='sharepoint'&inumberofresultsuggestions=4
fPreQuerySuggestions
Un valor booleano que especifica si se debe recuperar sugerencias de consultas previa o posterior a la consulta. true para obtener sugerencias de consulta previa; en caso contrario, false. El valor predeterminado es false.
Ejemplo de solicitud GET
http:// server/_api/search/suggest?querytext='sharepoint'&fprequerysuggestions=true
fHitHighlighting
Un valor booleano que especifica si se visita resaltado o dar formato en negrita las sugerencias de consulta. true dar formato en negrita los términos de las sugerencias de consulta devuelta que coinciden con los términos de la consulta especificada; en caso contrario, false. El valor predeterminado es true.
Ejemplo de solicitud GET
http:// server/_api/search/suggest?querytext='sharepoint'&fhithighlighting=false
fCapitalizeFirstLetters
Un valor booleano que especifica si se debe poner en mayúscula la primera letra de cada término de las sugerencias de consulta devuelta. true a mayúsculas la primera letra de cada término; en caso contrario, false. El valor predeterminado es false.
Ejemplo de solicitud GET
http:// server/_api/search/suggest?querytext='sharepoint'&fcapitalizefirstletters=false
Culture
El identificador de configuración regional (LCID) de la consulta (consulte Identificadores de configuración regional asignados por Microsoft).
Ejemplo de solicitud GET
http:// server/_api/search/suggest?querytext='sharepoint'&culture=1044
Permitir derivaciones
Un valor booleano que especifica si la lematización está habilitada. true para habilitar la lematización; en caso contrario, false. El valor predeterminado es true.
Ejemplo de solicitud GET
http:// server/_api/search/suggest?querytext='sharepoint'&enablestemming=false
ShowPeopleNameSuggestions
Un valor booleano que especifica si se debe incluir los nombres de personas en las sugerencias de consulta devuelta. true para incluir nombres de personas en las sugerencias de consulta devuelto; en caso contrario, false. El valor predeterminado es true.
Ejemplo de solicitud GET
http:// server/_api/search/suggest?querytext='sharepoint'&showpeoplenamesuggestions=false
EnableQueryRules
Un valor booleano que especifica si se va a activar las reglas de consulta para esta consulta. true para activar las reglas de consulta; en caso contrario, false. El valor predeterminado es true.
Ejemplo de solicitud GET
http:// server/_api/search/suggest?querytext='sharepoint'&enablequeryrules=false
fPrefixMatchAllTerms
Coincide con un valor booleano que especifica si se devuelven sugerencias de consulta para el prefijo. true para devolver las sugerencias de consulta basadas en prefijo coincide con, de lo contrario, false cuando sugerencias de consulta deben coincidir con la palabra de consulta completa.
Ejemplo de solicitud GET
http:// server/_api/search/suggest?querytext='sharepoint'&fprefixmatchallterms=false