mailboxFolder-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.
Stellt einen Ordner im Postfach eines Benutzers dar, z. B. Posteingang, Entwürfe oder andere vom Benutzer erstellte Ordner. Ordner können verschiedene Postfachelemente wie Nachrichten, Ereignisse, Kontakte, andere Outlook-Elemente und untergeordnete Ordner enthalten.
Diese Ressource unterstützt Deltaabfragen , um inkrementelle Ergänzungen, Löschungen und Updates nachzuverfolgen, indem eine Delta-Funktion bereitgestellt wird. Es unterstützt auch erweiterte Einwert- und Mehrwerteigenschaften für das Speichern und Zugreifen auf benutzerdefinierte Daten, die nicht bereits in den Microsoft Graph-API-Metadaten verfügbar gemacht wurden.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | mailboxFolder-Sammlung | Ruft alle mailboxFolder-Objekte im angegebenen Postfach ab, einschließlich aller Suchordner. |
| Create | mailboxFolder | Erstellen Sie einen neuen mailboxFolder oder untergeordneten mailboxFolder im Postfach eines Benutzers. |
| Get | mailboxFolder | Liest die Eigenschaften und Beziehungen eines mailboxFolder-Objekts . |
| Update | mailboxFolder | Aktualisieren Sie mailboxFolder-Eigenschaften wie displayName innerhalb eines Postfachs. |
| Löschen | Keine | Löschen Sie einen mailboxFolder oder einen untergeordneten mailboxFolder innerhalb eines Postfachs. |
| Delta abrufen | mailboxFolder-Sammlung | Ruft einen Satz von mailboxFolder-Objekten ab, die dem Postfach des Benutzers hinzugefügt, gelöscht oder daraus entfernt wurden. |
| Auflisten untergeordneter Postfachordner | mailboxFolder-Sammlung | Rufen Sie die mailboxFolder-Auflistung unter dem angegebenen mailboxFolder in einem Postfach ab. |
| Auflisten von Elementen im Ordner | mailboxItem-Sammlung | Ruft die mailboxItem-Auflistung in einem angegebenen mailboxFolder in einem Postfach ab. |
| Erweiterte Eigenschaften | ||
| Einwertige Eigenschaft erstellen | mailboxFolder | Erstellen Sie eine oder mehrere einwertige erweiterte Eigenschaften in einem neuen oder vorhandenen Postfachordner. |
| Einwertige Eigenschaft abrufen | mailboxFolder | Rufen Sie Postfachordner ab, die eine einwertige erweiterte Eigenschaft $expand mit oder $filterenthalten. |
| Erweiterte mehrwertige Eigenschaft erstellen | mailboxFolder | Erstellen Sie eine oder mehrere mehrwertige erweiterte Eigenschaften in einem neuen oder vorhandenen Postfachordner. |
| Erweiterte mehrwertige Eigenschaft abrufen | mailboxFolder | Rufen Sie mithilfe $expandvon einen Postfachordner ab, der eine mehrwertige erweiterte Eigenschaft enthält. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| childFolderCount | Int32 | Die Anzahl der unmittelbar untergeordneten Ordner im aktuellen Ordner. |
| displayName | Zeichenfolge | Der Anzeigename des Ordners. |
| id | Zeichenfolge | Der eindeutige Bezeichner für den Ordner. |
| parentFolderId | Zeichenfolge | Der eindeutige Bezeichner für den übergeordneten Ordner dieses Ordners. |
| parentMailboxUrl | Zeichenfolge | Der Routinglink zum tatsächlich zugrunde liegenden Postfach, in dem sich der Ordner physisch befindet. Auf den Ordner kann mithilfe von GET {parentMailboxUrl}/folders/{id}zugegriffen werden, wodurch die gesamte URL als undurchsichtige Zeichenfolge behandelt wird. Diese Methode ist besonders wichtig, wenn die automatisch erweiterte Archivierung für das direkte Archivpostfach eines Benutzers aktiviert ist. Der Archivinhalt des Benutzers kann sich in solchen Szenarien über mehrere Postfächer erstrecken. |
| totalItemCount | Int32 | Die Anzahl der Elemente im Ordner. |
| type | Zeichenfolge | Beschreibt den Ordnerklassentyp. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| childFolders | mailboxFolder-Sammlung | Die Auflistung der untergeordneten Ordner in diesem Ordner. |
| items | mailboxItem-Sammlung | Die Auflistung von Elementen in diesem Ordner. |
| multiValueExtendedProperties | multiValueLegacyExtendedProperty-Sammlung | Die Auflistung von mehrwertigen erweiterten Eigenschaften, die für den mailboxFolder definiert sind. |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty-Sammlung | Die Auflistung von einwertigen erweiterten Eigenschaften, die für den mailboxFolder definiert sind. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.mailboxFolder",
"displayName": "String",
"childFolderCount": "Int32",
"id": "String (identifier)",
"parentFolderId": "String",
"parentMailboxUrl": "String",
"totalItemCount": "Int32",
"type": "String"
}