Obtenir les messages Outlook dans un dossier partagé ou délégué

Outlook permet aux clients de partager des dossiers de courriers électroniques au sein de leur organisation et d’accéder en lecture, création, modification ou suppression à des dossiers individuels. Outlook permet également à un client de déléguer des tâches à un autre utilisateur afin d’agir au nom du client et d’accéder aux dossiers de courriers électroniques spécifiques ou à l’intégralité de la boîte aux lettres du client. Cette opération porte aussi le nom de « délégation » dans Outlook.

Microsoft Graph prend en charge via un programme la réception des messages dans les dossiers de messages qui ont été partagés par d’autres utilisateurs, ainsi que la réception des dossiers partagés eux-mêmes. Le support s'applique également aux dossiers qui ont été délégués.

Par exemple, Garth a partagé avec John et lui a donné un accès en lecture à la boîte de réception de Garth. Si Jean s’est connecté à votre application et a fourni des autorisations déléguées (Mail.Read.Shared ou Mail.ReadWrite.Shared), votre application peut accéder au courrier et à la boîte de réception de Claude comme décrit ci-dessous.

Autorisations de Microsoft Graph

Utilisez les autorisations déléguées, Mail.Read.Shared ou Mail.ReadWrite.Shared, pour respectivement lire ou écrire des messages dans un dossier partagé ou délégué.

Notez que ces deux autorisations ne prennent pas en charge l’abonnement pour modifier les notifications sur les éléments dans les dossiers partagés ou délégués. Pour configurer les abonnements aux notifications de modifications sur les messages dans un dossier de messagerie partagé, délégué ou tout autre dossier de messagerie utilisateur dans le client, utilisez l’autorisation d’application, Mail.Read.

Pour plus d’informations, reportez-vous à la rubrique Autorisations de messagerie.

Réception d’un message dans le dossier partagé

Vous pouvez recevoir un message spécifique de la boîte de réception de Claude :

GET users/{Garth-userId | Garth-userPrincipalName}/mailfolders('Inbox')/messages/{id}

Si l’opération réussit, vous recevrez le message « HTTP 200 OK » et l’instance message identifiée par {id} dans la boîte de réception de Claude.

Obtention de tous les messages dans le dossier partagé

Recevez tous les messages de la boîte de réception de Claude :

GET users/{Garth-userId | Garth-userPrincipalName}/mailfolders('Inbox')/messages

Si l’opération réussit, vous recevrez le message « HTTP 200 OK » et une collection d’instances message identifiées dans la boîte de réception de Claude.

Réception du dossier partagé

Recevez le dossier (boîte de réception) que Claude a partagé avec John.

GET users/{Garth-userId | Garth-userPrincipalName}/mailfolders('Inbox')

Si l’opération réussit, vous recevrez le message « HTTP 200 OK » et une instance mailFolder qui représente le dossier de boîte de réception de Claude.

Les mêmes fonctionnalités GET s’appliquent si Claude délègue à John des accès supplémentaires à sa boîte de réception, ou si Claude délègue à John la totalité de sa boîte aux lettres.

Si Claude n’a pas partagé sa boîte de réception avec Jean et qu’il ne lui a pas délégué sa boîte aux lettres, vous obtiendrez une erreur si vous indiquez l’identifiant utilisateur de Claude ou le nom principal d’utilisateur dans ces opérations GET.

Étapes suivantes

Pour en savoir plus, consultez les articles suivants :