Verwenden der Microsoft Search-API zum Durchsuchen von Akronymen

  • Artikel
  • 2 Minuten Lesedauer

Sie können die Microsoft Search-API in Microsoft Graph verwenden, um Akronyme in Ihrer Organisation zu durchsuchen. Administratoren können Akronyme im Microsoft 365 Admin Center oder über die API Zum Erstellen von Akronym erstellen erstellen.

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.

Nachdem Akronyme erstellt wurden, geben Sie in searchRequest in der entityTypes-Eigenschaft als Wert an acronym , um nach ihnen zu suchen.

Beispiel 1: Such akronyme

Anforderung

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

{
  "requests": [
    {
      "entityTypes": [
        "acronym"
      ],
      "query": {
        "queryString":"what is KQL"
      }
    }
  ]
}

Antwort

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#search",
  "value": [
  {
   "@odata.type": "#microsoft.graph.searchResponse",
   "hitsContainers": [
    {
     "@odata.type": "#microsoft.graph.searchHitsContainer",
     "hits": [
      {
       "@odata.type": "#microsoft.graph.searchHit",
       "hitId": "a9f59c69-f4a1-42ac-820e-0f35114300f8",
       "rank": 1,
       "resource": {
          "@odata.type": "#microsoft.graph.search.acronym",
          "id": "a9f59c69-f4a1-42ac-820e-0f35114300f8",
          "displayName": "KQL",
          "description": "Kusto Query Language is a powerful tool to explore your data and discover patterns, identify anomalies and outliers, create statistical modeling, and more.",
          "webUrl": "https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query",
          "standsFor": "Kusto Query Language"
        }
       }
      }
     ],
     "total": 1,
     "moreResultsAvailable": false
    }
   ]
  }
 ]
}

Bekannte Probleme

  • Sortierung, Aggregation und Paginierung werden für Akronymsuchen nicht unterstützt.
  • Kombinationssuchen mit Entitätstypen ohne Antwort (z. B. driveItem, list) werden nicht unterstützt.

Nächste Schritte