Bearbeiten

Verwenden der Microsoft Search-API zum Durchsuchen von Personen

  • Artikel
  • 2 Minuten Lesedauer

Microsoft Graph-Anwendungen können die Microsoft Search-API verwenden, um die Personen abzurufen, die für einen Benutzer am relevantesten sind. Relevanz wird durch die Kommunikations- und Zusammenarbeitsmuster und Geschäftsbeziehungen des Benutzers bestimmt. Personen können lokale Kontakte oder aus dem Verzeichnis einer Organisation oder Personen aus kürzlichen Kommunikationen sein.

Neben der Generierung dieses Einblicks bietet die Suche auch Unterstützung für Fuzzyübereinstimmungen und die Möglichkeit, die Liste der Benutzer abzurufen, die für einen anderen Benutzer in der Organisation des angemeldeten Benutzers relevant sind.

Beispiel: Person anhand des Namens suchen

Die folgende Anforderung ruft die Personen ab, die für den angemeldeten Benutzer am relevantesten sind, basierend auf Kommunikations- und Zusammenarbeitsmustern und Geschäftsbeziehungen.

Anforderung

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

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

Antwort

Es folgt ein Beispiel für die Antwort, die eine Nachricht enthält, die dem Suchkriterium entspricht.

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"
                                    }
                                ]
                            }
                        }
                    ]
                }
            ]
        }
    ]
}

Nächste Schritte