mailSearchFolder-Ressourcentyp

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.

Ein mailSearchFolder ist ein virtueller Ordner im Postfach des Benutzers, der alle E-Mail-Elemente enthält, die bestimmten 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

Exchange Online kann Suchordner löschen, die von Ihrer Anwendung aus einem der folgenden Gründe erstellt wurden:

1. Suchordner laufen nach 45 Tagen ohne Nutzung ab.
2. Die Anzahl der Suchordner, die pro Quellordner erstellt werden können, ist begrenzt. Wenn dieses Limit überschritten wird, werden ältere Suchordner gelöscht und Platz für neue gemacht.

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

Methoden

Methode	Rückgabetyp	Beschreibung
Create	mailSearchFolder	Erstellen Sie einen Suchordner im Postfach dieses Benutzers.
Get	mailSearchFolder	Abrufen des angegebenen Suchordners.
Update	mailSearchFolder	Aktualisieren des angegebenen Suchordners.
Löschen	Keine	Löschen Sie den angegebenen Suchordner.
Endgültig löschen	Keine	Löschen Sie einen E-Mail-Suchordner endgültig und entfernen Sie die zugehörigen Elemente aus dem Postfach des Benutzers.
Untergeordnete Ordner auflisten	mailFolder-Sammlung	Listen Sie alle Ordner im Postfach dieses Benutzers auf, einschließlich der Suchordner.
Nachrichten im Ordner auflisten	message-Sammlung	Auflisten aller Nachrichten im angegebenen Suchordner

Eigenschaften

Eigenschaft	Typ	Beschreibung
isSupported	Boolean	Gibt an, ob ein Suchordner mithilfe von REST-APIs bearbeitet werden kann.
includeNestedFolders	Boolean	Gibt an, wie die Postfachordnerhierarchie bei der Suche durchlaufen werden soll. true bedeutet, dass eine tiefe Suche durchgeführt werden sollte, um untergeordnete Ordner in die Hierarchie jedes Ordners einzubeziehen, der explizit in sourceFolderIds angegeben ist. false bedeutet eine flache Suche nur für jeden der Ordner, die explizit in sourceFolderIds angegeben sind.
sourceFolderIds	String collection	Die Postfachordner, die abgebaut werden sollen.
filterQuery	Zeichenfolge	Die OData-Abfrage zum Filtern der Nachrichten.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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