Usar la API Búsqueda de Microsoft en Microsoft Graph para buscar personas (versión preliminar)

Las Graph microsoft pueden usar la API Búsqueda de Microsoft para recuperar las personas que son más relevantes para un usuario. La relevancia viene determinada por las relaciones empresariales y los patrones de comunicación y colaboración del usuario. Con personas nos referimos a contactos locales o del directorio de la organización y a personas con las que se han mantenido comunicaciones recientes. Además de generar esta información, la búsqueda también proporciona compatibilidad de búsqueda con coincidencias aproximadas y la capacidad de recuperar la lista de usuarios relevantes para otro usuario de la organización del usuario que ha iniciado sesión.

Ejemplo: Buscar persona por nombre

La siguiente solicitud obtiene las personas más relevantes para el usuario que ha iniciado sesión, en función de los patrones de comunicación y colaboración y las relaciones empresariales.

Solicitud

POST https://graph.microsoft.com/beta/search/query
Content-Type: application/json

{
  "requests": [
    {
      "entityTypes": [
        "person"
      ],
      "query": {
        "queryString": "contoso"
      },
      "from": 0,
      "size": 25
    }
  ]
}

Respuesta

A continuación se muestra un ejemplo de la respuesta, que contiene un mensaje que coincide con el criterio de búsqueda.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://canary.graph.microsoft.com/testprodbetapersoninsearch/$metadata#microsoft.graph.searchResponse",
    "value": [
        {
            "hitsContainers": [
                {
                    "total": 1,
                    "moreResultsAvailable": false,
                    "hits": [
                        {
                            "hitId": "fc138b85-18ac-48e0-80a4-633ae4b594e0@41f988bf-86f1-53af-91ab-2d7cd034db47",
                            "rank": 1,
                            "summary": "",
                            "resource": {
                                "@odata.type": "#microsoft.graph.person",
                                "displayName": "Example User",
                                "givenName": "User",
                                "surname": "User",
                                "department": "Finance",
                                "officeLocation": "London",
                                "userPrincipalName": "example.user@contoso.com",
                                "emailAddresses": [
                                    {
                                        "address": "example.user@contoso.com",
                                        "rank": 1
                                    }
                                ],
                                "phones": [
                                    {
                                        "type": "business",
                                        "number": "+44 (20) 12345678"
                                    }
                                ]
                            }
                        }
                    ]
                }
            ]
        }
    ]
}

Pasos siguientes