type de ressource mailFoldermailFolder resource type

Élément mailFolder dans la boîte aux lettres d’un utilisateur, tel que Boîte de réception et Brouillons.A mail folder in a user's mailbox, such as Inbox and Drafts. Les dossiers de courrier électronique peuvent contenir des messages, d’autres éléments Outlook et des dossiers de courrier électronique enfants.Mail folders can contain messages, other Outlook items, and child mail folders.

Cette ressource prend en charge l’utilisation d’une requête delta pour effectuer un suivi des suppressions, des mises à jour et des ajouts incrémentiels à l’aide d’une fonction delta.This resource supports using delta query to track incremental additions, deletions, and updates, by providing a delta function.

Noms des dossiers connusWell-known folder names

Par défaut, Outlook crée certains dossiers pour les utilisateurs.Outlook creates certain folders for users by default. Au lieu d’utiliser la valeur id du dossier correspondant, vous pouvez tout simplement utiliser les noms de dossier connus du tableau ci-dessous quand vous accédez à ces dossiers.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 . Par exemple, vous pouvez obtenir le dossier Brouillons à l’aide de son nom connu avec la requête suivante.For example, you can get the Drafts folder using its well-known name with the following query.

GET /me/mailFolders/drafts

Les noms connus fonctionnent quels que soient les paramètres régionaux de boîte aux lettres de l’utilisateur, la requête ci-dessus retourne toujours le dossier Brouillons de l’utilisateur quelle que soit la manière dont il est nommé.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.

Noms du dossier connuWell-known folder name DescriptionDescription
archiveArchive Le dossier d’archive vers lequel les messages sont envoyés lorsque vous utilisez la fonctionnalité d’archivage One_Click dans les clients Outlook qui la prennent en charge.The archive folder messages are sent to when using the One_Click Archive feature in Outlook clients that support it. Remarque : ce n’est pas la même chose que la fonctionnalité de boîte aux lettres archive d’Exchange online.Note: this is not the same as the Archive Mailbox feature of Exchange online.
pêlemêleClutter Le dossier courrier pêle-mêle vers lequel lees messages à basse priorité sont déplacés lorsque vous utilisez la fonctionnalité Courrier pêle-mêle.The clutter folder low-priority messages are moved to when using the Clutter feature.
conflitsConflicts Le dossier qui contient des éléments en conflit dans la boîte aux lettres.The folder that contains conflicting items in the mailbox.
conversationhistoryconversationhistory Le dossier où Skype enregistre les conversations par messagerie instantanée (si Skype est configuré pour le faire).The folder where Skype saves IM conversations (if Skype is configured to do so).
deleteditemsdeleteditems Le dossier vers lequel les éléments sont déplacés lorsqu’ils sont supprimés.The folder items are moved to when they are deleted.
brouillonsDrafts Le dossier qui contient les messages non envoyés.The folder that contains unsent messages.
boîtederéceptionInbox Le dossier Boîte de réception.The Inbox folder.
junkemailjunkemail Le dossier courrier indésirable.The Junk E-Mail folder.
localfailureslocalfailures Le dossier qui contient les éléments qui existent dans le client local, mais ne peuvent pas être téléchargés vers le serveur.The folder that contains items that exist on the local client but could not be uploaded to the server.
msgfolderrootmsgfolderroot Le dossier « Haut de la banque d’informations ».The "Top of Information Store" folder. Ce dossier est le dossier parent pour les dossiers affichés dans les clients de messagerie normal, par exemple, la boîte de réception.This folder is the parent folder for folders that are displayed in normal mail clients, such as the inbox.
Boîte d’envoiOutbox Le dossier Boîte d'envoi.The Outbox folder.
recoverableitemsdeletionsrecoverableitemsdeletions Le dossier qui contient les éléments supprimés de menu : supprimés à partir du dossier éléments supprimés ou en appuyant sur MAJ + SUPPR dans Outlook.The folder that contains soft-deleted items: deleted either from the Deleted Items folder, or by pressing shift+delete in Outlook. Ce dossier n’est pas visible dans un client de messagerie Outlook, mais les utilisateurs finaux peuvent interagir avec via la fonctionnalité récupérer les éléments supprimés à partir du Server dans Outlook ou Outlook sur le web.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.
planifiéscheduled Le dossier qui contient les messages planifiés pour réapparaître dans la boîte de réception à l’aide de la fonctionnalité de planification dans Outlook pour iOS.The folder that contains messages that are scheduled to reappear in the inbox using the Schedule feature in Outlook for iOS.
searchfolderssearchfolders Dossier parent pour tous les dossiers de recherche définies dans la boîte aux lettres de l’utilisateur.The parent folder for all search folders defined in the user's mailbox.
sentitemssentitems Le dossier éléments envoyés.sent items folder
serverfailuresserverfailures Le dossier qui contient les éléments qui existent dans le serveur, mais ne peuvent pas être téléchargés vers le client local.The folder that contains items that exist on the server but could not be synchronized to the local client.
syncissuessyncissues Le dossier qui contient les journaux de synchronisation créés par Outlook.The folder that contains synchronization logs created by Outlook.

MéthodesMethods

MéthodeMethod Type renvoyéReturn Type DescriptionDescription
Obtenir mailFolderGet mailFolder mailFoldermailFolder Lisez les propriétés et les relations de l’élément mailFolder.Read properties and relationships of mailFolder object.
Créer MailFolderCreate MailFolder MailFolderMailFolder Créez un élément mailFolder sous l’élément mailFolder actuel en publiant dans la collection childFolders.Create a new mailFolder under the current one by posting to the childFolders collection.
Répertorier childFoldersList childFolders collection MailFolderMailFolder collection Obtenez la collection de dossiers sous le dossier spécifié. Vous pouvez utiliser le raccourci .../me/MailFolders pour obtenir la collection de dossiers de niveau supérieur et accéder à un autre dossier.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.
Créer un messageCreate Message MessageMessage Créez un message dans l’élément mailFolder actif en publiant dans la collection de messages.Create a new message in the current mailFolder by posting to the messages collection.
Répertorier des messagesList messages collection MessageMessage collection Obtenez tous les messages de la boîte aux lettres de l’utilisateur connecté ou ces messages dans un dossier spécifié de la boîte aux lettres.Get all the messages in the signed-in user's mailbox, or those messages in a specified folder in the mailbox.
Mettre à jourUpdate mailFoldermailFolder Mettez à jour l’objet mailFolder spécifié.Update the specified mailFolder object.
SupprimerDelete AucunNone Supprimez l’objet mailFolder spécifié.Delete the specified mailFolder object.
copiercopy MailFolderMailFolder Copiez un objet mailFolder et son contenu vers un autre objet mailFolder.Copy a mailFolder and its contents to another mailFolder.
deltadelta collection mailFoldermailFolder collection Obtenez un ensemble de dossiers de courriers qui ont été ajoutés ou supprimés de la boîte aux lettres de l’utilisateur.Get a set of mail folders that have been added, deleted, or removed from the user's mailbox.
déplacermove MailFolderMailFolder Déplacez un objet mailFolder et son contenu vers un autre objet mailFolder.Move a mailFolder and its contents to another mailFolder.
Propriétés étenduesExtended properties
Créer une propriété étendue à valeur uniqueCreate single-value extended property mailFoldermailFolder Créez une ou plusieurs propriétés étendues à valeur unique dans un objet mailFolder nouveau ou existant.Create one or more single-value extended properties in a new or existing mailFolder.
Obtenir un objet mailFolder avec une propriété étendue à valeur uniqueGet mailFolder with single-value extended property mailFoldermailFolder Obtenez des objets mailFolder qui contiennent une propriété étendue à valeur unique à l’aide de $expand ou $filter.Get mailFolders that contain a single-value extended property by using $expand or $filter.
Créer une propriété étendue à valeurs multiplesCreate multi-value extended property mailFoldermailFolder Créez une ou plusieurs propriétés étendues à valeurs multiples dans un objet mailFolder nouveau ou existant.Create one or more multi-value extended properties in a new or existing mailFolder.
Obtenir un objet mailFolder avec propriété étendue à valeurs multiplesGet mailFolder with multi-value extended property mailFoldermailFolder Obtenez un objet mailFolder qui contient une propriété étendue à valeurs multiples à l’aide de $expand.Get a mailFolder that contains a multi-value extended property by using $expand.

PropriétésProperties

PropriétéProperty TypeType DescriptionDescription
childFolderCountchildFolderCount Int32Int32 Nombre d’objets mailFolder enfants immédiats dans l’objet mailFolder actuel.The number of immediate child mailFolders in the current mailFolder.
displayNamedisplayName ChaîneString Nom d’affichage de l’objet mailFolder.The mailFolder's display name.
idid ChaîneString Identificateur unique de l’objet mailFolder.The mailFolder's unique identifier.
parentFolderIdparentFolderId ChaîneString Identificateur unique de l’objet mailFolder parent de l’objet mailFolder.The unique identifier for the mailFolder's parent mailFolder.
totalItemCounttotalItemCount Int32Int32 Nombre d’éléments inclus dans l’objet mailFolder.The number of items in the mailFolder.
unreadItemCountunreadItemCount Int32Int32 Nombre d’éléments inclus dans l’objet mailFolder marqués comme non lus.The number of items in the mailFolder marked as unread.

Accéder efficacement aux nombres d’élémentsAccess item counts efficiently

Les propriétés TotalItemCount et UnreadItemCount d’un dossier vous permettent de calculer le nombre d’éléments lus dans le dossier.The TotalItemCount and UnreadItemCount properties of a folder allow you to conveniently compute the number of read items in the folder. Elles vous permettent d’éviter les requêtes qui peuvent entraîner une latence importante, telles que la suivante :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

Les objets dossiers de courrier dans Outlook peuvent contenir plusieurs types d’éléments, par exemple, Boîte de réception peut contenir des éléments de demande de réunion qui sont différents des éléments de courrier.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. Les propriétés TotalItemCount et UnreadItemCount incluent des éléments dans un dossier de courrier quels que soient leurs types d'éléments.TotalItemCount and UnreadItemCount include items in a folder irrespective of their item types.

RelationsRelationships

RelationRelationship TypeType DescriptionDescription
childFolderschildFolders collection MailFolderMailFolder collection Collection de dossiers enfants dans l’objet mailFolder.The collection of child folders in the mailFolder.
messageRulesmessageRules Collection messageRulemessageRule collection Ensemble de règles qui s’appliquent au dossier de boîte de réception de l’utilisateur.The collection of rules that apply to the user's Inbox folder.
messagesmessages collection MessageMessage collection Collection de messages dans l’objet mailFolder.The collection of messages in the mailFolder.
multiValueExtendedPropertiesmultiValueExtendedProperties collection multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection Collection des propriétés étendues à valeurs multiples définies pour l’objet mailFolder. En lecture seule. Peut avoir la valeur Null.The collection of multi-value extended properties defined for the mailFolder. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties collection singleValueLegacyExtendedPropertysingleValueLegacyExtendedProperty collection Collection des propriétés étendues à valeur unique définies pour l’objet mailFolder. En lecture seule. Peut avoir la valeur Null.The collection of single-value extended properties defined for the mailFolder. Read-only. Nullable.

Représentation JSONJSON representation

Voici une représentation JSON de la ressourceHere 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" }]
}

Voir aussiSee also