Uso de microsoft Búsqueda API para xrank resultados de búsqueda
Puede usar la expresión XRANK de API de Microsoft Búsqueda en Microsoft Graph para aumentar la clasificación dinámica de los elementos en función de determinadas repeticiones de términos dentro de la expresión de coincidencia, sin cambiar qué elementos coinciden con la consulta. Una expresión XRANK contiene un componente que debe coincidir, la expresión de coincidencia y uno o varios componentes que contribuyen solo a la clasificación dinámica, la expresión de clasificación. Al menos uno de los parámetros, excepto n, debe especificar una expresión XRANK válida. El operador xrank solo se admite en archivos hospedados en SharePoint.
Puede usar el operador XRANK en la siguiente sintaxis:
<match expression> XRANK(cb=100, rb=0.4, pb=0.4, avgb=0.4, stdb=0.4, nb=0.4, n=200) <rank expression>
Para obtener más información sobre el cálculo de clasificación dinámica del operador XRANK, consulte Operador de clasificación dinámica.
Ejemplo
En el ejemplo siguiente se muestra una solicitud que busca archivos hospedados en SharePoint y usa el operador XRANK para aumentar los resultados de búsqueda especificados.
Solicitud sin XRANK
POST https://graph.microsoft.com/v1.0/search/query
Content-Type: application/json
{
"requests": [
{
"entityTypes": [
"listItem"
],
"query": {
"queryString": "cat OR dog"
},
"from": 0,
"size": 1
}
]
}
Respuesta
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"searchTerms": [
"cat",
"dog"
],
"hitsContainers": [
{
"hits": [
{
"hitId": "32faa5c0-0bd5-4918-a19c-7b3c415a0fb4",
"rank": 1,
"summary": "this program has changed any times over the years, but one of the most common is “<c0>dog</c0> food <ddd/> However, only a few of those will get focused attention through the “<c0>dog</c0> food” process <ddd/> ",
"resource": {
"@odata.type": "#microsoft.graph.listItem",
"createdDateTime": "2021-04-22T19:22:23Z",
"lastModifiedDateTime": "2021-12-03T19:00:27Z",
"webUrl": "https://microsoft.sharepoint.com/teams/Employee_Experience/SitePages/Dog-Foodxxxxx.aspx"
}
}
],
"total": 616865,
"moreResultsAvailable": true
}
]
}
],
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.searchResponse)"
}
Solicitud con XRANK
POST https://graph.microsoft.com/v1.0/search/query
Content-Type: application/json
{
"requests": [
{
"entityTypes": [
"listItem"
],
"query": {
"queryString": "(cat OR dog) XRANK(cb=100) note"
},
"from": 0,
"size": 1
}
]
}
Respuesta
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"searchTerms": [
"cat",
"dog",
"note"
],
"hitsContainers": [
{
"hits": [
{
"hitId": "cb32ce8e-7f82-4b1d-b1fb-52e6af95fbed",
"rank": 1,
"summary": "Microsoft is committed to providing a <ddd/> Other than meeting rooms marked as <c0>dog</c0>-free, meeting organizers can decide on a case-specific basis whether to disallow <c0>dogs</c0> in their meetings <ddd/> ",
"resource": {
"@odata.type": "#microsoft.graph.listItem",
"createdDateTime": "2020-09-21T04:46:40Z",
"lastModifiedDateTime": "2022-09-18T09:15:18Z",
"webUrl": "https://microsofteur.sharepoint.com/teams/insider/EN/SitePages/Dog-Policy.aspx"
}
}
],
"total": 616865,
"moreResultsAvailable": true
}
]
}
],
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.searchResponse)"
}
Limitaciones conocidas
La expresión XRANK no se admite para los siguientes recursos: message,chatMessage, event, person o externalItem.