Verwenden der Microsoft Search-API zum Durchsuchen von Outlook-Kalenderereignissen

Artikel
11/07/2024

Verwenden Sie die Microsoft Search-API in Microsoft Graph, um nach Ereignissen im primären Kalender des angemeldeten Benutzers zu suchen. Die Benutzeridentität für die Suche basiert auf dem Authentifizierungstoken.

Achtung

Das Such-API-Schema wurde in der Betaversion geändert. Einige Eigenschaften in einer Suchanforderung und -antwort wurden umbenannt oder entfernt. Weitere Informationen finden Sie unter Warnung zur Einstellung der Schemaänderung. Die Beispiele in diesem Thema zeigen das aktuelle Schema.

Beispiel

Anforderung

In diesem Beispiel wird im Kalender des Benutzers nach dem Schlüsselwort (keyword) "contoso" gesucht und bis zu 25 Ergebnisse zurückgegeben.

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

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

Antwort

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#search",
  "value": [
  {
   "@odata.type": "#microsoft.graph.searchResponse",
   "searchTerms": [
    "contoso"
   ],
   "hitsContainers": [
    {
     "@odata.type": "#microsoft.graph.searchHitsContainer",
     "hits": [
      {
       "@odata.type": "#microsoft.graph.searchHit",
       "hitId": "AAMkADEwODY2NzllLTQ3MmEtNGRlMC05ZTUyLTE4ZDRhYmU1ZGM3NABGAAAAAAA3+iYQBnJnQabRVDelNhnzBwAejhWkAOAxQ6M4c1c9NwfrAAAAAAENAAAejhWkAOAxQ6M4c1c9NwfrAABbUZLJAAA=",
       "rank": 1,
       "summary": "Here is a summary of your events from last week",
       "resource": {
        "@odata.type": "#microsoft.graph.event",
        "end": {
         "dateTime": "2020-06-16T04:15:00Z",
         "timeZone": "UTC"
        },
        "hasAttachments": false,
        "iCalUId": "040000008200E00074C5B7101A82E008000000007093FDD79B3AD60100000000000000001000000036DAA2262EB4E04DA27DA77985FB8251",
        "isAllDay": false,
        "sensitivity": "Normal",
        "start": {
         "dateTime": "2020-06-16T03:30:00Z",
         "timeZone": "UTC"
        },
        "subject": "Weekly digest: Microsoft 365 changes",
        "type": "Single"
       }
      }
     ],
     "total": 1,
     "moreResultsAvailable": false
    }
   ]
  }
 ]
}

Bekannte Einschränkungen

Sie können nur auf das eigene Postfach des angemeldeten Benutzers zugreifen. Das Durchsuchen delegierter Postfächer wird nicht unterstützt.
Bei Ereignissen enthält die total-Eigenschaft des searchHitsContainer-Typs die Anzahl der Ergebnisse auf der Seite, nicht die Gesamtzahl der übereinstimmenden Ergebnisse.
Das Sortieren von Ergebnissen wird für Ereignisse nicht unterstützt. Eine Sortierklausel in der Anforderung gibt den Fehlercode "Ungültige Anforderung" in der Antwort zurück.

Nächste Schritte

Verwendung der Microsoft Search-API zum Abfragen von Daten

Freigeben über