Utilisez l’API REST de messagerie Outlook

  • Article

Microsoft Graph permet à votre application d’obtenir un accès autorisé aux données de messagerie Outlook d’un utilisateur dans un compte personnel ou professionnel. Avec les autorisations de messagerie déléguées ou d’application appropriées, votre application peut accéder aux données de messagerie de l’utilisateur connecté ou de tout utilisateur dans un locataire. Pour plus d’informations sur les jetons d’accès, l’inscription d’application et les autorisations déléguées et d’application, consultez Concepts de base de l’authentification et de l’autorisation.

L’API Microsoft Graph prend en charge l’accès aux données des principales boîtes aux lettres et des boîtes aux lettres partagées des utilisateurs. Les données peuvent être constituées de calendriers, courriers ou de contacts personnels stockés dans une boîte de messagerie sur le cloud d'Exchange Online dans le cadre d’Office 365 ou sur Exchange en local dans un déploiement hybride.

L’API ne prend pas en charge l’accès aux boîtes aux lettres d’archivage , que ce soit sur Exchange Online ou sur Exchange Server.

Utilisation de l’API REST de courrier

Les requêtes de l’API de courrier sont exécutées au nom d’un utilisateur qui peut être identifié par la propriété id de l’utilisateur (un GUID unique), l’adresse e-mail ou l’alias de raccourci me pour l’utilisateur connecté.

Email messages sont représentés par la ressource de message et organisés dans un objet mailFolder. Les messages et les dossiers de courrier sont identifiés par leur propriété id , qui peut être obtenue à partir des GET opérations.

Importante

En règle générale, ne supposez pas que les ID de message et mailfolder sont uniques et restent à tout moment identiques au sein d’une boîte aux lettres. Ils peuvent changer après certaines actions comme copier ou déplacer. Vous avez la possibilité d’utiliser des ID immuables afin de conserver les mêmes ID, tant que le message reste dans la boîte aux lettres, à l’exception de l’envoi de brouillons et de quelques scénarios supplémentaires. Pour plus d’informations, consultez la durée de vie des ID non modifiables.

Les corps des messages peuvent être au format HTML ou texte.

Vous pouvez utiliser des noms de dossier connus comme Inbox, Drafts, SentItems ou DeletedItems pour identifier certains dossiers de courrier qui existent par défaut pour tous les utilisateurs. Pour obtenir la liste des noms de dossier connus pris en charge, consultez l’article Type de ressource mailFolder.

Par exemple, vous pouvez obtenir des messages dans le dossier Éléments envoyés Outlook de l’utilisateur connecté, sans obtenir au préalable l’ID du dossier :

GET /me/mailFolders('SentItems')/messages?$select=sender,subject

Cas d’utilisation courants

La ressource message expose des propriétés telles que categories, conversationId, flag et importance qui correspondent aux fonctionnalités disponibles dans l’interface utilisateur, ce qui permet l’automatisation ou l’intégration d’applications avec l’expérience utilisateur Outlook intégrée.

L’API Microsoft Graph fournit également des méthodes et actions qui prennent en charge les cas d’utilisation courants des messages.

Cas d'utilisation Ressources REST Voir aussi
Actions centrées sur l’utilisateur
Brouillon, lire, répondre, transférer, envoyer, mettre à jour ou supprimer des messages message Méthodes de message
Déléguer à un autre utilisateur l’envoi des messages au nom du propriétaire de la boîte aux lettres message Définition des propriétés from et sender dans un message
Permettre aux utilisateurs d’afficher d’abord les messages plus importants inferenceClassificationOverride Boîte de réception triée
Rechercher des messages et les placer dans un dossier de recherche mailSearchFolder Méthodes de mailSearchFolder
Obtenir le contenu MIME d’un message ou d’une pièce jointe au message message Obtenir le contenu MIME
Envoyer des messages avec du contenu MIME message Envoyer un contenu MIME
Ajouter, obtenir ou supprimer des pièces jointes d’un message attachment,
fileAttachment,
itemAttachment,
referenceAttachment,
message		 Méthodes de pièce jointe
Obtenir des options de langue et fuseau horaire pour un utilisateur localeInfo,
timeZoneInformation		 supportedLanguages
supportedTimeZones
Obtenir ou mettre à jour une réponse automatique, les paramètres régionaux, le fuseau horaire ou les heures de travail d’un utilisateur mailboxSettings,
automaticRepliesSetting,
localeInfo,
workingHours		 Obtenir les paramètres de boîte aux lettres de l’utilisateur,
Mettre à jour les paramètres de boîte aux lettres de l’utilisateur
Obtenir des infos-courrier de type MailTips relatives au statut spécial des autres destinataires, par exemple, absence du bureau utilisateur,
mailTips		 Obtenir des Infos-courrier MailTips
Gestion des messages et des dossiers
Organiser les messages dans une hiérarchie de dossiers de courrier mailFolder Méthodes de mailFolder
Classer les messages outlookCategory Méthodes d’outlookCategory
Utiliser des règles de boîte de réception pour automatiser les actions y compris transférer des messages entrants spécifiques messageRule Méthodes de messageRule
Obtenir les en-têtes de message Internet d’un message message Ajout de la propriété internetMessageHeaders à l’entité message.
Rechercher et filtrer les messages message Paramètres de requête
Être informé des modifications apportées aux messages dans un dossier abonnement Utiliser des webhooks dans Microsoft Graph
Synchroniser les messages ou la hiérarchie de dossiers de courrier message Obtenir des modifications incrémentielles de messages dans un dossier
Développement d’applications
Ajouter les données d’application personnalisée comme en-têtes de message Internet d’un message message Ajouter des données personnalisées à la propriété internetMessageHeaders du message.
Ajouter des données d’application personnalisées à un message en utilisant des extensions openTypeExtension,
schemaExtension		 Ajout de données personnalisées à des ressources à l’aide des extensions
Accéder aux données personnalisées pour les propriétés MAPI Outlook sous-exposées singleValueLegacyExtendedProperty,
multiValueLegacyExtendedProperty		 Vue d’ensemble des propriétés étendues Outlook

Étapes suivantes

L’API de courrier vous offre de nouvelles possibilité d’interaction avec les utilisateurs :