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. Statt des ID- Werts des entsprechenden Ordner für zu diesem Zweck können Sie die bekannte Ordnernamen aus der folgenden Tabelle beim Zugriff auf diese Ordner.Instead of using the corresponding folder id value, for convenience, you can use the well-known folder names from the table below when accessing these folders. Beispielsweise können Sie den Ordner "Entwürfe" unter Verwendung seines bekannte namens 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 arbeiten unabhängig von dem Gebietsschema des Postfach des Benutzers, der oben genannten Abfrage immer Ordner "Entwürfe" des Benutzers, unabhängig davon, wie heißt zurückgegeben wird.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 OrdnernameWell-known folder name BeschreibungDescription
Archivarchive Bei Verwendung von One_Click Archiv-Features in Outlook-Clients, die dies unterstützen, werden die Nachrichten archivieren Ordner an gesendet.The archive folder messages are sent to when using the One_Click Archive feature in Outlook clients that support it. Hinweis: Dies ist nicht das gleiche wie das Archivpostfach Feature von Exchange online.Note: this is not the same as the Archive Mailbox feature of Exchange online.
Unübersichtlichkeitclutter Die Unübersichtlichkeit Ordner niedriger Priorität Nachrichten werden in verschoben, beim Verwenden des Features Unübersichtlichkeit.The clutter folder low-priority messages are moved to when using the Clutter feature.
Konflikteconflicts Der Ordner, der miteinander in Konflikt stehende Elemente im Postfach enthält.The folder that contains conflicting items in the mailbox.
conversationhistoryconversationhistory Der Ordner, in dem Skype Sofortnachrichtenunterhaltungen speichert (falls Skype dazu konfiguriert ist).The folder where Skype saves IM conversations (if Skype is configured to do so).
deleteditemsdeleteditems Der Ordnerelemente werden in verschoben, wenn sie gelöscht werden.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 Posteingangsordner.The inbox folder.
junkemailjunkemail Der junk-e-Mail-Ordner.The junk email folder.
localfailureslocalfailures Der Ordner, der Elemente enthält, die auf dem lokalen Client vorhanden, jedoch nicht auf den Server hochgeladen werden konnte.The folder that contains items that exist on the local client but could not be uploaded to the server.
msgfolderrootmsgfolderroot Der Ordner "Oberste Ebene des Informationsspeichers".The "Top of Information Store" folder. Dieser Ordner ist des übergeordneten Ordners für Ordner, in der normalen e-Mail-Clients, wie beispielsweise 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, das vorläufig gelöschte Elemente enthält: gelöscht, aus dem Ordner Gelöschte Objekte 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 nicht sichtbar, alle Outlook-e-Mail-Client, jedoch können Endbenutzer über das Feature Gelöschte Elemente wiederherstellen, vom Server in Outlook oder Outlook im Web mit ihm 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 im Posteingang mit der Zeitplan in Outlook für iOS eingeblendet geplant werden.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 im Postfach des Benutzers definierten Suchordner.The parent folder for all search folders defined in the user's mailbox.
Gesendete Elementesentitems Ordner "Gesendete Elemente".The sent items folder.
serverfailuresserverfailures Der Ordner, der Elemente enthält, die auf dem Server vorhanden, aber konnte nicht auf dem lokalen Client synchronisiert werden.The folder that contains items that exist on the server but could not be synchronized to the local client.
syncissuessyncissues Der Ordner, der von Outlook erstellten Synchronisierungsprotokolle enthält.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
Create single-value extended propertyCreate 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 ZeichenfolgeString Der Anzeigename des mailFolder-Elements.The mailFolder's display name.
idid ZeichenfolgeString Eindeutiger Bezeichner der MailFolder.The mailFolder's unique identifier.
parentFolderIdparentFolderId ZeichenfolgeString 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

Die TotalItemCount und UnreadItemCount Eigenschaften eines Ordners können Sie bequem die Anzahl der gelesenen Elemente im Ordner zu berechnen.The TotalItemCount and UnreadItemCount properties of a folder allow you to conveniently compute the number of read items in the folder. Sie können Sie die Abfragen wie folgt zu vermeiden, die erhebliche Wartezeiten auftreten kann: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 mehrere Typen von Elementen enthalten, beispielsweise der Posteingang enthalten kann Anforderung Besprechungselemente vom e-Mail-Elemente darstellen.Mail folders 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 UnreadItemCount Elemente in einem e-Mail-Ordner unabhängig von deren Elementtypen einschließen.TotalItemCount and UnreadItemCount include items in a mail folder 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