mailFolder-RessoucentypmailFolder resource type

Ein mailFolder-Element im Postfach eines Benutzers, wie z. B. Posteingang und Entwürfe.A mail folder in a user's mailbox, such as Inbox and Drafts. Mailordner können Nachrichten, andere Outlook-Elemente und untergeordnete E-Mail-Ordner enthalten.Mail folders can contain messages, other Outlook items, and child mail folders.

Diese Ressource unterstützt die Verwendung einer Delta-Abfrage zum Nachverfolgen von inkrementellen Hinzufügungen, Löschungen und Aktualisierungen durch Bereitstellen einer delta-Funktion.This resource supports using delta query to track incremental additions, deletions, and updates, by providing a delta function.

Bekannte OrdnernamenWell-known folder names

Outlook erstellt standardmäßig bestimmte Ordner für Benutzer.Outlook creates certain folders for users by default. Anstatt den entsprechenden Ordner-ID-Wert zu verwenden, können Sie der Einfachheit halber die folgenden bekannten Ordnernamen beim Zugriff auf diese Ordner aus der folgenden Tabelle verwenden.Instead of using the corresponding folder id value, for convenience, you can use the following well-known folder names when accessing these folders in a mailFolder collection: , , , , , , , and . Beispielsweise können Sie den Ordner "Entwürfe", unter seinem bekannten Namen mit der folgenden Abfrage abrufen.For example, you can get the Drafts folder using its well-known name with the following query.

GET /me/mailFolders/drafts

Bekannte Namen funktionieren unabhängig vom Gebietsschema des Postfachs des Benutzers, so dass die obige Abfrage immer den Ordner „Entwürfe“ des Benutzers zurückgibt, unabhängig davon, wie dieser benannt ist.Well-known names work regardless of the locale of the user's mailbox, so the above query will always return the user's Drafts folder regardless of how it is named.

Bekannte OrdnernamenWell-known folder name BeschreibungDescription
ArchivArchive Die Nachrichten des Archivordners werden an diese gesendet, wenn Sie die One_Click Archive-Funktion in Outlook-Clients verwenden, die sie unterstützen.The archive folder messages are sent to when using the One_Click Archive feature in Outlook clients that support it. Hinweis: Dies ist nicht dasselbe wie das Archivpostfach Feature von Exchange Online.Note: this is not the same as the Archive Mailbox feature of Exchange online.
ClutterClutter Die Nachrichten mit niedriger Priorität des Clutter-Ordners werden bei Verwendung der Clutter-Funktion verschoben.The clutter folder low-priority messages are moved to when using the Clutter feature.
KonflikteConflicts Der Ordner, der widersprüchliche Elemente im Postfach enthält.The folder that contains conflicting items in the mailbox.
conversationhistoryconversationhistory Der Ordner, in dem Skype Chatunterhaltungen speichert (wenn Skype so konfiguriert wurde).The folder where Skype saves IM conversations (if Skype is configured to do so).
deleteditemsdeleteditems Die Ordner-Elemente werden beim Löschen in den Ordner verschoben.The folder items are moved to when they are deleted.
EntwürfeDrafts Der Ordner, der nicht gesendete Nachrichten enthält.The folder that contains unsent messages.
PosteingangInbox Der Ordner Posteingang.The Inbox folder.
JunkEmailjunkemail Der Junk-E-Mail-Ordner.The Junk E-Mail folder.
LocalFailureslocalfailures Der Ordner, der Elemente enthält, die auf dem lokalen Client vorhanden sind, aber nicht auf den Server hochgeladen werden konnten.The folder that contains items that exist on the local client but could not be uploaded to the server.
msgfolderrootmsgfolderroot Der „Oberste Ebene des Informationsspeichers“Ordner.The "Top of Information Store" folder. Dieser Ordner ist der übergeordnete Ordner für Ordner, die in normalen E-Mail-Clients wie dem Posteingang angezeigt werden.This folder is the parent folder for folders that are displayed in normal mail clients, such as the inbox.
PostausgangOutbox Der Ordner Postausgang.The Outbox folder.
recoverableitemsdeletionsrecoverableitemsdeletions Der Ordner, der nicht dauerhaft gelöschte Elemente enthält: Entweder aus dem Ordner „Gelöschte Elemente“ oder durch Drücken von UMSCHALT+Entf in Outlook.The folder that contains soft-deleted items: deleted either from the Deleted Items folder, or by pressing shift+delete in Outlook. Dieser Ordner ist in keinem Outlook-E-Mail-Client sichtbar, aber Endbenutzer können mit diesem Ordner über die Funktion Gelöschte Elemente wiederherstellen vom Server in Outlook oder Outlook im Web interagieren.This folder is not visible in any Outlook email client, but end users can interact with it through the Recover Deleted Items from Server feature in Outlook or Outlook on the web.
Geplantscheduled Der Ordner, der Nachrichten enthält, die für die erneute Anzeige im Posteingang über die Funktion Zeitplan" in Outlook für iOS geplant sind.The folder that contains messages that are scheduled to reappear in the inbox using the Schedule feature in Outlook for iOS.
searchfolderssearchfolders Der übergeordnete Ordner für alle Suchordner, die im Postfach des Benutzers definiert sind.The parent folder for all search folders defined in the user's mailbox.
SentItemssentitems Der Ordner „Gesendete Elemente“.sent items folder
ServerFailuresserverfailures Der Ordner, der Elemente enthält, die auf dem Server vorhanden sind, aber nicht mit dem lokalen Client synchronisiert werden konnten.The folder that contains items that exist on the server but could not be synchronized to the local client.
SyncIssuessyncissues Der Ordner, der Synchronisationsprotokolle enthält, die von Outlook erstellt wurden.The folder that contains synchronization logs created by Outlook.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Get mailFolderGet mailFolder mailFoldermailFolder Dient zum Lesen der Eigenschaften und der Beziehungen des mailFolder-Objekts.Read properties and relationships of mailFolder object.
Create MailFolderCreate MailFolder MailFolderMailFolder Dient zum Erstellen eines neuen mailFolder-Elements unter dem aktuellen durch die Veröffentlichung der childFolders-Sammlung.Create a new mailFolder under the current one by posting to the childFolders collection.
List childFoldersList childFolders MailFolder-SammlungMailFolder collection 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.Get the folder collection under the specified folder. You can use the .../me/MailFolders shortcut to get the top-level folder collection and navigate to another folder.
Create MessageCreate Message NachrichtMessage Dient zum Erstellen einer neuen Nachricht in dem aktuellen mailFolder-Element durch die Veröffentlichung in der Nachrichtensammlung.Create a new message in the current mailFolder by posting to the messages collection.
List messagesList messages Nachrichten-SammlungMessage collection Dient zum Abrufen aller Nachrichten im Postfach des angemeldeten Benutzers oder Nachrichten in einen bestimmten Ordner im Postfach.Get all the messages in the signed-in user's mailbox, or those messages in a specified folder in the mailbox.
UpdateUpdate mailFoldermailFolder Dient zum Aktualisieren des angegebenen mailFolder-Objekts.Update the specified mailFolder object.
DeleteDelete KeineNone Dient zum Löschen des angegebenen mailFolder-Objekts.Delete the specified mailFolder object.
copycopy MailFolderMailFolder Dient zum Kopieren eines mailFolder-Elements und seiner Inhalte in ein anderes mailFolder-Element.Copy a mailFolder and its contents to another mailFolder.
deltadelta mailFolder-SammlungmailFolder collection Dient zum Abrufen eines Satzes von E-Mail-Ordnern, die dem Postfach des Benutzers hinzugefügt bzw. daraus gelöscht oder entfernt wurden.Get a set of mail folders that have been added, deleted, or removed from the user's mailbox.
movemove MailFolderMailFolder Dient zum Verschieben eines mailFolder-Elements und seiner Inhalte in ein anderes mailFolder-Element.Move a mailFolder and its contents to another mailFolder.
Erweiterte EigenschaftenExtended properties
Einwertige erweiterte Eigenschaft erstellenCreate single-value extended property mailFoldermailFolder Dient zum Erstellen einer oder mehrerer erweiterter einwertiger Eigenschaften in einem neuen oder vorhandenen mailFolder-Element.Create one or more single-value extended properties in a new or existing mailFolder.
Get mailFolder with single-value extended propertyGet mailFolder with single-value extended property mailFoldermailFolder Dient zum Abrufen von mailFolders-Elementen mit einer erweiterten einwertigen Eigenschaft mithilfe von $expand oder $filter.Get mailFolders that contain a single-value extended property by using $expand or $filter.
Create multi-value extended propertyCreate multi-value extended property mailFoldermailFolder Dient zum Erstellen einer oder mehrerer erweiterter mehrwertiger Eigenschaften in einem neuen oder vorhandenen mailFolder-Element.Create one or more multi-value extended properties in a new or existing mailFolder.
Get mailFolder with multi-value extended propertyGet mailFolder with multi-value extended property mailFoldermailFolder Dient zum Abrufen eines mailFolders-Elements mit einer erweiterten mehrwertigen Eigenschaft mithilfe von $expand.Get a mailFolder that contains a multi-value extended property by using $expand.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
childFolderCountchildFolderCount Int32Int32 Die Anzahl der unmittelbar untergeordneten mailFolders-Elemente in dem aktuellen mailFolder-Element.The number of immediate child mailFolders in the current mailFolder.
displayNamedisplayName StringString Der Anzeigename des mailFolder-Elements.The mailFolder's display name.
idid ZeichenfolgeString Der eindeutiger Bezeichner des mailFolder-Elements.The mailFolder's unique identifier.
parentFolderIdparentFolderId StringString Die eindeutige ID für das übergeordnete mailFolder-Element des mailFolder-Elements.The unique identifier for the mailFolder's parent mailFolder.
totalItemCounttotalItemCount Int32Int32 Anzahl der Elemente im mailFolder-Element.The number of items in the mailFolder.
unreadItemCountunreadItemCount Int32Int32 Die Anzahl der Elemente im mailFolder-Element, die als „Ungelesen“ markiert sind.The number of items in the mailFolder marked as unread.

Effizientes Ermitteln der Anzahl von ElementenAccess item counts efficiently

Mit den TotalItemCount- und UnreadItemCount-Eigenschaften eines Ordners können Sie die Anzahl der gelesenen Elemente im Ordner problemlos ermitteln.The TotalItemCount and UnreadItemCount properties of a folder allow you to conveniently compute the number of read items in the folder. Mithilfe dieser Eigenschaften werden Abfragen folgender Art vermieden, die zu erheblichen Wartezeiten führen:They let you avoid queries like the following that can incur significant latency:

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

E-Mail-Ordner in Outlook können mehr als einen Typ von Elementen enthalten, der Posteingang kann beispielsweise Besprechungsanfragen enthalten, die sich von E-Mail-Elementen unterscheiden.MailFolders in Outlook can contain more than one type of items, for example, the Inbox can contain meeting request items which are distinct from mail items. TotalItemCountund UnreadItemCountenthalten Elemente in einem Mail-Ordner, unabhängig von deren Elementtypen.TotalItemCount and UnreadItemCount include items in a mailFolder irrespective of their item types.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
childFolderschildFolders MailFolder-SammlungMailFolder collection Die Sammlung der untergeordneten Ordner in dem mailFolder-Element.The collection of child folders in the mailFolder.
messageRulesmessageRules messageRule-SammlungmessageRule collection Die Sammlung von Regeln, die für den Posteingangsordner des Benutzers gelten.The collection of rules that apply to the user's Inbox folder.
Nachrichtenmessages Nachrichten-SammlungMessage collection Die Sammlung der Nachrichten in dem mailFolder-Element.The collection of messages in the mailFolder.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty-SammlungmultiValueLegacyExtendedProperty collection Die Sammlung erweiterter mehrwertiger Eigenschaften, die für das mailFolder-Element definiert sind. Schreibgeschützt. Lässt Nullwerte zu.The collection of multi-value extended properties defined for the mailFolder. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty-SammlungsingleValueLegacyExtendedProperty collection Die Sammlung erweiterter einwertiger Eigenschaften, die für das mailFolder-Element definiert sind. Schreibgeschützt. Lässt Nullwerte zu.The collection of single-value extended properties defined for the mailFolder. Read-only. Nullable.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource

{
  "childFolderCount": 1024,
  "displayName": "string",
  "id": "string (identifier)",
  "parentFolderId": "string",
  "totalItemCount": 1024,
  "unreadItemCount": 1024,
  "childFolders": [ { "@odata.type": "microsoft.graph.mailFolder" } ],
  "messageRules": [ { "@odata.type": "microsoft.graph.messageRule" } ],
  "messages": [ { "@odata.type": "microsoft.graph.message" } ],
  "multiValueExtendedProperties": [ { "@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty" }],
  "singleValueExtendedProperties": [ { "@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty" }]
}

Siehe auchSee also