mailSearchFolder-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Ein mailSearchFolder ist ein virtueller Ordner im Postfach des Benutzers, der alle E-Mail-Elemente enthält, die den angegebenen Suchkriterien entsprechen. mailSearchFolder erbt von mailFolder. Suchordner können in einem beliebigen Ordner im Exchange Online-Postfach eines Benutzers erstellt werden. Damit jedoch ein Suchordner in Outlook, Outlook für das Web oder Outlook Live angezeigt wird, muss der Ordner im Ordner "WellKnownFolderName.SearchFolders" erstellt werden.

Suchordnerlebenszyklus

Von Ihrer Anwendung erstellte Suchordner können aus einem der folgenden Gründe von Exchange Online gelöscht werden:

1. Suchordner laufen nach 45 Tagen ohne Verwendung ab.
2. Die Anzahl der Suchordner, die pro Quellordner erstellt werden können, ist begrenzt. Wenn dieser Grenzwert überschritten wird, werden ältere Suchordner gelöscht, um Neue zu finden.

Wenn ein Suchordner gelöscht wird, sollte Ihre App eine neue Suchordnerressource erstellen und dieselbe verwenden.

Methoden

Methode	Rückgabetyp	Beschreibung
Erstellen eines Suchordners	mailSearchFolder	Erstellen Sie einen Suchordner im Postfach dieses Benutzers.
Auflisten von Suchordnern	mailFolder-Sammlung	Listet alle Ordner im Postfach dieses Benutzers auf, einschließlich Suchordner.
Suchen eines Ordners	mailSearchFolder	Den angegebenen Suchordner erhalten.
Aktualisieren eines Suchordners	mailSearchFolder	Aktualisieren Sie den angegebenen Suchordner.
Löschen eines Suchordners	Keine	Löschen Sie den angegebenen Suchordner.
Auflisten aller Nachrichten in einem Suchordner	message-Sammlung	Listet alle Nachrichten im angegebenen Suchordner auf.

Eigenschaften

Eigenschaft	Typ	Beschreibung
isSupported	Boolesch	Gibt an, ob ein Suchordner mithilfe von REST-APIs bearbeitet werden kann.
includeNestedFolders	Boolesch	Gibt an, wie die Postfachordnerhierarchie in der Suche durchlaufen werden soll. truebedeutet, dass eine tiefen Suche durchgeführt werden sollte, um untergeordnete Ordner in die Hierarchie der einzelnen Ordner zu schließen, die explizit in sourceFolderIds angegeben sind. false bedeutet, dass nur die einzelnen Ordner, die explizit in sourceFolderIds angegeben sind, flach durchsucht werden.
sourceFolderIds	String-Sammlung	Die Postfachordner, die mined werden sollen.
filterQuery	Zeichenfolge	Die OData-Abfrage, um die Nachrichten zu filtern.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "isSupported": true,
  "includeNestedFolders": true,
  "sourceFolderIds": ["string"],
  "filterQuery": "string"
}