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. Search Ordner 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.
Search Ordnerlebenszyklus
Search von Ihrer Anwendung erstellten Ordner können von Exchange Online aus einem der folgenden Gründe gelöscht werden:
- Search Ordner laufen nach 45 Tagen ohne Nutzung ab.
- 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 |
---|---|---|
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 Suchordnern. |
Abrufen eines Suchordners | mailSearchFolder | Ruft 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 | message-Sammlung | Listet alle Nachrichten im angegebenen Suchordner auf. |
Eigenschaften
Eigenschaft | Typ | Beschreibung |
---|---|---|
filterQuery | String | 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"
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für