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 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.

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 Grenzwerte für die Anzahl der Suchordner, die pro Quellordner erstellt werden können. Wenn dieser Grenzwert überschritten wird, werden ältere Suchordner gelöscht, um Neue zu schaffen.

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

Methoden

Methode	Rückgabetyp	Beschreibung
Suchordner für E-Mail erstellen	mailSearchFolder	Create einen Suchordner im Postfach dieses Benutzers.
Untergeordnete Ordner auflisten	mailFolder-Sammlung	Listet alle Ordner im Postfach dieses Benutzers auf, einschließlich Suchordnern.
Suchordner für E-Mail abrufen	mailSearchFolder	Ruft den angegebenen Suchordner ab.
Suchordner für E-Mail aktualisieren	mailSearchFolder	Aktualisieren Sie den angegebenen Suchordner.
Suchordner für E-Mail löschen	Keine	Löschen Sie den angegebenen Suchordner.
Nachrichten im Ordner auflisten	message-Sammlung	Listet alle Nachrichten im angegebenen Suchordner auf.

Eigenschaften

Eigenschaft	Typ	Beschreibung
filterQuery	Zeichenfolge	Die OData-Abfrage zum Filtern der Nachrichten.
includeNestedFolders	Boolesch	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, die explizit in sourceFolderIds angegeben sind. false bezeichnet eine flache Suche nur der einzelnen Ordner, die explizit in sourceFolderIds angegeben sind.
Issupported	Boolesch	Gibt an, ob ein Suchordner mithilfe von REST-APIs bearbeitet werden kann.
sourceFolderIds	String-Sammlung	Die Postfachordner, die mined werden sollen.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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