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 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
Exchange Online kann suchordner, die von Ihrer Anwendung erstellt wurden, aus einem der folgenden Gründe löschen:
- Suchordner 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 |
|---|---|---|
| Create | mailSearchFolder | Erstellen Sie einen Suchordner im Postfach dieses Benutzers. |
| Get | mailSearchFolder | Ruft den angegebenen Suchordner ab. |
| Update | mailSearchFolder | Aktualisieren Sie den angegebenen Suchordner. |
| Delete | Keine | Löschen Sie den angegebenen Suchordner. |
| Endgültig löschen | Keine | Löschen Sie einen E-Mail-Suchordner endgültig, und entfernen Sie seine Elemente aus dem Postfach des Benutzers. |
| Untergeordnete Ordner auflisten | mailFolder-Sammlung | Listet alle Ordner im Postfach dieses Benutzers auf, einschließlich Suchordnern. |
| Nachrichten im Ordner auflisten | 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 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. |
| sourceFolderIds | Zeichenfolgensammlung | Die Postfachordner, die mined werden sollen. |
| filterQuery | String | Die OData-Abfrage zum Filtern der Nachrichten. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"isSupported": true,
"includeNestedFolders": true,
"sourceFolderIds": ["string"],
"filterQuery": "string"
}