Freigeben über

searchRequest-Ressourcentyp

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Achtung

Bei Ressourcen, die in einer Microsoft Search API-Anfrage und -Antwort verwendet werden, wurden Eigenschaften umbenannt oder entfernt, oder sie sind veraltet. Hier finden Sie weitere Einzelheiten über das Ende der Unterstützung. Aktualisieren Sie Such-API-Abfragen in allen früheren Apps entsprechend.

Eine In einem JSON-Blob formatierte Suchanforderung.

Das JSON-Blob enthält die in der Antwort erwarteten Ressourcentypen, die zugrunde liegenden Quellen, Pagingparameter, Sortieroptionen, angeforderte Aggregationen und Felder sowie die tatsächliche Suchabfrage. Sehen Sie sich Beispiele für Suchanforderungen für verschiedene Ressourcen an.

Hinweis

Beachten Sie bekannte Einschränkungen beim Durchsuchen bestimmter Kombinationen von Entitätstypen und beim Sortieren oder Aggregieren von Suchergebnissen.

Eigenschaften

Eigenschaft Typ Beschreibung
aggregations aggregationOption-Sammlung Gibt Aggregationen (auch als Einschränkungen bezeichnet) an, die zusammen mit Suchergebnissen zurückgegeben werden sollen. Optional.
aggregationFilters String collection Enthält einen oder mehrere Filter zum Abrufen von Suchergebnissen, die auf einen bestimmten Wert eines Felds aggregiert und gefiltert wurden. Optional.
Erstellen Sie diesen Filter basierend auf einer vorherigen Suche, die nach demselben Feld aggregiert wird. Identifizieren Sie aus der Antwort der vorherigen Suche das searchBucket , das Ergebnisse auf den spezifischen Wert des Felds filtert, verwenden Sie die Zeichenfolge in der aggregationFilterToken-Eigenschaft , und erstellen Sie eine Aggregationsfilterzeichenfolge im Format "{field}:\"{aggregationFilterToken}\".
Wenn mehrere Werte für dasselbe Feld angegeben werden müssen, verwenden Sie die Zeichenfolgen in der aggregationFilterToken-Eigenschaft , und erstellen Sie eine Aggregationsfilterzeichenfolge im Format "{field}:or(\"{aggregationFilterToken1}\",\"{aggregationFilterToken2}\")".
Beispielsweise wird beim Suchen und Aggregieren von Laufwerkselementen nach Dateityp ein searchBucket für den Dateityp docx in der Antwort zurückgegeben. Sie können das aggregationFilterToken , das für dieses searchBucket zurückgegeben wird, bequem in einer nachfolgenden Suchabfrage verwenden und Übereinstimmungen nach unten zu Laufwerkselementen des docx Dateityps filtern. In Beispiel 1 und Beispiel 2 werden die tatsächlichen Anforderungen und Antworten angezeigt.
collapseProperties collapseProperty-Auflistung Enthält die sortierte Auflistung von Feldern und das Limit zum Reduzieren der Ergebnisse. Optional.
contentSources String collection Enthält die Verbindung, die als Ziel verwendet werden soll.
Berücksichtigt das folgende Format: /external/connections/connectionid Dabei connectionid ist die in der Connectors-Verwaltung definierte ConnectionId.
Hinweis: contentSource gilt nur, wenn entityType=externalItem. Optional.
enableTopResults Boolesch Dadurch wird eine Hybridsortierung für Nachrichten ausgelöst: Die ersten drei Nachrichten sind die relevantesten. Diese Eigenschaft gilt nur für entityType=message. Optional.
entityTypes entityType-Auflistung Mindestens ein Ressourcentyp, der in der Antwort erwartet wird. Mögliche Werte sind: list, site, listItem, message, event, drive, driveItem, person, externalItem, acronym, bookmark und chatMessage. Ausführliche Informationen zu Kombinationen von zwei oder mehr Entitätstypen, die in derselben Suchanforderung unterstützt werden, finden Sie unter Bekannte Einschränkungen. Erforderlich.
fields Zeichenfolgensammlung Enthält die Felder, die für jedes in entityTypes angegebene Ressourcenobjekt zurückgegeben werden sollen. Dies ermöglicht die Anpassung der standardmäßig zurückgegebenen Felder, einschließlich zusätzlicher Felder wie benutzerdefinierte verwaltete Eigenschaften von SharePoint und OneDrive oder benutzerdefinierte Felder in externalItem aus Inhalten, die Microsoft Graph-Connectors einbringen.
Die Fields-Eigenschaft kann die semantischen Bezeichnungen verwenden, die auf Eigenschaften angewendet werden. Wenn eine Eigenschaft beispielsweise als Titel bezeichnet wird, können Sie sie mit der folgenden Syntax abrufen: label_title.
Optional.
von Int32 Gibt den Offset für die Suchergebnisse an. Offset 0 gibt das erste Ergebnis zurück. Optional.
Abfrage searchQuery Enthält die Abfragebegriffe. Erforderlich.
queryAlterationOptions searchAlterationOptions Stellt Abfrageänderungsoptionen bereit, die als JSON-Blob formatiert sind und zwei optionale Flags im Zusammenhang mit der Rechtschreibkorrektur enthalten. Optional.
Region string Erforderlich für Suchvorgänge, die Anwendungsberechtigungen verwenden. Stellt den geografischen Standort für die Suche dar. Weitere Informationen finden Sie unter Abrufen des Regionswerts.
resultTemplateOptions resultTemplateOption-Auflistung Stellt die Optionen für Suchergebnisvorlagen zum Rendern von Connectors-Suchergebnissen bereit.
sharePointOneDriveOptions sharePointOneDriveOptions Gibt die Art von Inhalten an, die durchsucht werden sollen, wenn eine Suche mithilfe von Anwendungsberechtigungen durchgeführt wird. Optional.
size Int32 Die Größe der abzurufenden Seite. Der Maximalwert ist 500. Optional.
sortProperties sortProperty-Auflistung Enthält die sortierte Auflistung von Feldern und die Richtung zum Sortieren der Ergebnisse. Es können maximal 5 Sortiereigenschaften in der Auflistung vorhanden sein. Optional.
trimDuplicates Boolesch Gibt an, ob die doppelten SharePoint-Dateien aus den Suchergebnissen entfernt werden sollen. Der Standardwert ist false. Optional.
stored_fields (veraltet) String collection Diese wird jetzt durch die Fields-Eigenschaft ersetzt.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "aggregationFilters": ["String"],
  "aggregations": [{"@odata.type": "microsoft.graph.aggregationOption"}],
  "contentSources": ["String"],
  "enableTopResults": true,
  "entityTypes": ["String"],
  "fields": ["String"],
  "from": 1024,
  "query": {"@odata.type": "microsoft.graph.searchQuery"},
  "queryAlterationOptions": {"@odata.type": "microsoft.graph.searchAlterationOptions"},
  "region": "63128164-cbbf-4db4-896c-a7038417019c",
  "resultTemplateOptions": [{"@odata.type": "microsoft.graph.resultTemplateOption"}],
  "sharePointOneDriveOptions": {"@odata.type": "microsoft.graph.sharePointOneDriveOptions"},
  "size": 1024,
  "sortProperties": [{"@odata.type": "microsoft.graph.sortProperty"}],
  "collapseProperties": [{"@odata.type": "microsoft.graph.collapseProperty"}],
  "trimDuplicates": false
}

Verwandte Inhalte