Organisation des messages Outlook
Outlook permet aux clients d’organiser leurs messages comme ils le souhaitent, soit en laissant tous les messages dans le même dossier de boîte de réception, soit en les organisant dans une structure de dossiers arborescente dans la boîte de réception, selon leurs besoins spécifiques. Vous pouvez facilement filtrer, rechercher ou trier les messages dans la totalité de la boîte aux lettres de l’utilisateur ou dans des dossiers spécifiques.
Accédez aux dossiers de messagerie
Les dossiers de messages sont représentés par programme par la ressource mailFolder. La boîte de réception est un dossier situé à la racine de la structure des dossiers.
Chaque ressource mailFolder est identifiée par son ID de dossier et a une propriété displayName accessible en écriture. Par défaut, Outlook crée d’autres dossiers pour les clients. Vous pouvez référencer ces dossiers par défaut par leur ID de dossier ou par leur nom connu. Pour obtenir la liste des noms de dossier connus disponibles, consultez l’article Type de ressource mailFolder.
Pour un dossier personnalisé non défini par défaut, si vous connaissez son chemin d’accès, vous pouvez y accéder à l’aide du raccourci /users/{id}/mailfolders
pour atteindre le niveau racine et accéder à tous les dossiers de niveau supérieur :
GET https://graph.microsoft.com/v1.0/users/{id}/mailFolders
Ensuite, vous pouvez spécifiez l’ID du dossier correspondant ({folder_id}
) tout en explorant chaque niveau de l’arborescence de dossiers :
GET https://graph.microsoft.com/v1.0/users/{id}/mailFolders/{folder_id}/childfolders
Répétez ces étapes jusqu’à ce que vous accédiez enfin au dossier personnalisé dans l’arborescence.
Créez et organiser l’arborescence des dossiers
Vous pouvez créer des dossiers de courrier dans la boîte de réception, ou sous la forme de dossiers enfants d’autres dossiers. Quand vous créez, copiez ou déplacez un dossier et son contenu, Outlook met à jour les propriétés parentFolderId et childFolderCount en lecture seule des dossiers concernés. Quand le contenu d’un dossier est copié ou déplacé vers un autre dossier, les ID d’entrée individuels du contenu sont également modifiés par défaut.
Au niveau du contenu, les propriétés totalItemCount et unreadItemCount vous indiquent, respectivement, le nombre d’éléments et le nombre d’éléments non lus présents dans un dossier de courrier. Au niveau des dossiers enfants, vous pouvez répertorier les dossiers enfants présents dans la boîte de réception ou dans un autre dossier. La propriété childFolderCount représente le nombre de dossiers enfants immédiats.
Sachez que les dossiers de courrier Outlook peuvent contenir des messages et d’autres types d’éléments, tels que des événements et des contacts. En règle générale, les dossiers Outlook contiennent des éléments hétérogènes.
Utilisez des règles pour automatiser la copie ou le déplacement des messages.
Outlook permet aux clients de configurer des règles pour automatiser certaines actions sur les messages entrants quand certaines conditions prédéfinies sont remplies. Vous pouvez créer une règle pour la boîte de réception avec la propriété messageRule pour copier ou déplacer un message vers un dossier spécifique sous certaines conditions. Les conditions sont représentées par la propriété messageRulePredicates. Elles peuvent inclure l’objet ou le corps du message contenant un certain type de texte, le message envoyé à partir de certaines adresses e-mail ou le message marqué important, etc.
Dirigez uniquement les messages qui vous intéressent vers la boîte de réception Prioritaire.
La boîte de réception Prioritaire permet aux clients d’entraîner Outlook à afficher uniquement les messages entrants des expéditeurs qui vous intéressent sous l’onglet Prioritaire , et le reste sous l’onglet Autres. Initialement, le système de classification d’Outlook organise les messages de boîte de réception par défaut. Au fil du temps, vous pouvez corriger et configurer le système via l’interface utilisateur ou un programme. Plus vous utilisez la boîte de réception Prioritaire, plus le système de classification peut déduire le message entrant que vous souhaitez voir sous l’onglet Prioritaire.
Vous pouvez mettre à jour, via un programme, la propriété inferenceClassification d’un message pour indiquer si vous souhaitez afficher le message dans l’onglet Prioritaire ou Autres. Cette mise à jour est exceptionnelle et concerne uniquement un courrier spécifique. En revanche, si vous voulez toujours afficher les messages provenant d’un expéditeur spécifique dans l’onglet Prioritaire ou Autres, vous pouvez définir une instruction pour Outlook. Chaque instruction est une instance inferenceClassificationOverride qui spécifie le nom de l’expéditeur et la destination des messages de cet expéditeur (focused
ou other
). Les instructions de chaque utilisateur concernant sa Boîte de réception Prioritaire sont stockées sous forme de collection d’instances inferenceClassificationOverride sur l’objet user.
Maintenir à jour les messages et les dossiers de courrier dans les applications
Les applications doivent souvent synchroniser et mettre à jour les données de courrier d’un utilisateur dans le magasin local de l’application. Microsoft Graph vous permet de vous abonner aux notifications de changement pour être informé quand des données sont modifiées, et interroger les modifications apportées dès qu’elles sont appliquées.
Les notifications sont remises par des webhooks de façon asynchrone quand les modifications sont effectuées, évitant ainsi aux applications d’interroger fréquemment les éventuelles modifications apportées. Vous pouvez vous abonner aux notifications de changement qui portent sur les ajouts, les mises à jour ou les suppressions des données de courrier d’un utilisateur. Par exemple, vous pouvez créer un abonnement aux messages dans un dossier spécifique (par exemple, /me/mailFolders('{folderId'}')
) ou au niveau racine (c’est-à-dire, /me/messages
). L’abonnement spécifie une propriété notificationUrl qui permet à Microsoft Graph d’informer l’application quand les types de modifications interrogées sont appliquées.
Pour synchroniser la première fois la boîte aux lettres d’un utilisateur, effectuez d’abord une requête delta pour interroger les dossiers de courrier en commençant par le niveau racine pour synchroniser tous les dossiers de courrier, puis effectuez une requête delta pour interroger les messages dans chaque dossier pour synchroniser les messages un par un.
Pour rechercher les entités exactes qui ont été modifiées sans lire la totalité de la ressource à chaque notification, vous pouvez utiliser une requête delta pour suivre les modifications qui vous intéressent et synchroniser votre magasin local avec ces modifications. Vous pouvez suivre les modifications apportées aux messages dans un dossier spécifique. Vous pouvez également suivre les modifications apportées aux dossiers de courrier au niveau racine (c’est-à-dire, /me/mailfolders
).
Étapes suivantes
- Pourquoi intégrer le courrier Outlook ?
- Utiliser l’API de messagerie et ses cas d’utilisation dans Microsoft Graph v1.0