mailSearchFolder-Ressourcentyp

Namespace: microsoft.graph

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 jedem Ordner im postfach Exchange Online eines Benutzers erstellt werden. Damit ein Suchordner jedoch in Outlook, Outlook für das Web oder Outlook Live angezeigt wird, muss der Ordner im Ordner "WellKnownFolderName.SearchFolders" erstellt werden.

Lebenszyklus von Suchordnern

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 Nutzung ab.
2. Es gibt Beschränkungen für die Anzahl der Suchordner, die pro Quellordner erstellt werden können. Wenn dieser Grenzwert überschritten wird, werden ältere Suchordner gelöscht, um den Weg für neue zu schaffen.

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.
Suchordner auflisten	mailFolder-Sammlung	Listet alle Ordner im Postfach dieses Benutzers auf, einschließlich Suchordnern.
Abrufen eines Suchordners	mailSearchFolder	Rufen Sie den angegebenen Suchordner ab.
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	Sammlung von Nachrichten	Listet alle Nachrichten im angegebenen Suchordner auf.

Eigenschaften

Eigenschaft	Typ	Beschreibung
Issupported	Boolescher Wert	Gibt an, ob ein Suchordner mithilfe von REST-APIs bearbeitet werden kann.
includeNestedFolders	Boolescher Wert	Gibt an, wie die Postfachordnerhierarchie bei der Suche durchlaufen werden soll. true bedeutet, dass eine umfassende Suche durchgeführt werden sollte, um untergeordnete Ordner in die Hierarchie jedes Ordners einzuschließen, der explizit in sourceFolderIds angegeben ist. false bedeutet eine flache Suche nur aller Ordner, die explizit in sourceFolderIds angegeben sind.
sourceFolderIds	String-Sammlung	Die Postfachordner, die minimiert werden sollen.
filterQuery	String	Die OData-Abfrage zum Filtern der Nachrichten.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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