mailFolder-Ressoucentyp

Ein mailFolder-Element im Postfach eines Benutzers, wie z. B. Posteingang, Entwürfe und Gesendete Objekte. MailFolders können Nachrichten und untergeordneten mailFolders-Elemente enthalten.

Methoden

Methode Rückgabetyp Beschreibung
Get mailFolder mailFolder Dient zum Lesen der Eigenschaften und der Beziehungen des mailFolder-Objekts.
Create MailFolder MailFolder Dient zum Erstellen eines neuen mailFolder-Elements unter dem aktuellen durch die Veröffentlichung der childFolders-Sammlung.
List childFolders MailFolder-Sammlung Dient zum Abrufen der Ordnersammlung unter dem angegebenen Ordner. Sie können die .../me/MailFoldersVerknüpfung zum Abrufen der Ordnersammlung auf oberster Ebene und zum Navigieren zu einem anderen Ordner verwenden.
Create Message Nachricht Dient zum Erstellen einer neuen Nachricht in dem aktuellen mailFolder-Element durch die Veröffentlichung in der Nachrichtensammlung.
List messages Nachrichten-Sammlung Dient zum Abrufen aller Nachrichten im Postfach des angemeldeten Benutzers oder Nachrichten in einen bestimmten Ordner im Postfach.
Update mailFolder Dient zum Aktualisieren des angegebenen mailFolder-Objekts.
Delete Keine Dient zum Löschen des angegebenen mailFolder-Objekts.
copy MailFolder Dient zum Kopieren eines mailFolder-Elements und seiner Inhalte in ein anderes mailFolder-Element.
move MailFolder Dient zum Verschieben eines mailFolder-Elements und seiner Inhalte in ein anderes mailFolder-Element.
Create single-value extended property mailFolder Dient zum Erstellen einer oder mehrerer erweiterter einwertiger Eigenschaften in einem neuen oder vorhandenen mailFolder-Element.
Get mailFolder with single-value extended property mailFolder Dient zum Abrufen von mailFolders-Elementen mit einer erweiterten einwertigen Eigenschaft mithilfe von $expand oder $filter.
Create multi-value extended property mailFolder Dient zum Erstellen einer oder mehrerer erweiterter mehrwertiger Eigenschaften in einem neuen oder vorhandenen mailFolder-Element.
Get mailFolder with multi-value extended property mailFolder Dient zum Abrufen eines mailFolders-Elements mit einer erweiterten mehrwertigen Eigenschaft mithilfe von $expand.

Eigenschaften

Eigenschaft Typ Beschreibung
childFolderCount Int32 Die Anzahl der unmittelbar untergeordneten mailFolders-Elemente in dem aktuellen mailFolder-Element.
displayName String Der Anzeigename des mailFolder-Elements.
id String Der eindeutiger Bezeichner des mailFolder-Elements. Sie können die folgenden häufig verwendeten Bezeichnungen für den Zugriff auf den entsprechenden Ordner verwenden: Posteingang, Entwürfe, Gesendete Elemente, DeletedItems.
parentFolderId String Die eindeutige ID für das übergeordnete mailFolder-Element des mailFolder-Elements.
totalItemCount Int32 Anzahl der Elemente im mailFolder-Element.
unreadItemCount Int32 Die Anzahl der Elemente im mailFolder-Element, die als „Ungelesen“ markiert sind.

Effizientes Ermitteln der Anzahl von Elementen

Mit den TotalItemCount- und UnreadItemCount-Eigenschaften eines Ordners können Sie die Anzahl der gelesenen Elemente im Ordner problemlos ermitteln. Mithilfe dieser Eigenschaften werden Abfragen folgender Art vermieden, die zu erheblichen Wartezeiten führen:

https://outlook.office.com/api/v1.0/me/folders/inbox/messages?$count=true&$filter=isread%20eq%20false

MailFolders-Elemente in Outlook können mehr als einen Typ von Elementen enthalten, der Posteingang kann beispielsweise Besprechungsanfragen enthalten, die sich von E-Mail-Elementen unterscheiden. TotalItemCount und UnreadItemCount schließen Elemente in einem mailFolder-Element unabhängig von Elementtyp ein.

Beziehungen

Beziehung Typ Beschreibung
childFolders MailFolder-Sammlung Die Sammlung der untergeordneten Ordner in dem mailFolder-Element.
Nachrichten Nachrichten-Sammlung Die Sammlung der Nachrichten in dem mailFolder-Element.
multiValueExtendedProperties multiValueLegacyExtendedProperty-Sammlung Die Sammlung erweiterter mehrwertiger Eigenschaften, die für das mailFolder-Element definiert sind. Schreibgeschützt. Lässt Nullwerte zu.
singleValueExtendedProperties singleValueLegacyExtendedProperty-Sammlung Die Sammlung erweiterter einwertiger Eigenschaften, die für das mailFolder-Element definiert sind. Schreibgeschützt. Lässt Nullwerte zu.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "childFolderCount": 1024,
  "displayName": "string",
  "id": "string (identifier)",
  "parentFolderId": "string",
  "totalItemCount": 1024,
  "unreadItemCount": 1024
}