大网数据广告活动
Microsoft Graph 接口

使用 Outlook 邮件 API 获取共享或委派文件夹中的 Outlook 邮件

· 52CE 我爱测

使用 Outlook 邮件 API 与他人共享邮件文件夹并管理对文件夹的访问权限。 还可以委托其他用户代表你执行操作。

使用 Outlook,客户可以与其他人共享邮件文件夹,并授予对各个文件夹的读取、创建、修改或删除访问权限。 此外,使用 Outlook,客户还可以委托其他用户代表自己执行操作,并访问特定邮件文件夹或客户的整个邮箱;在 Outlook 中,这也称为“委托”。

Microsoft Graph 以编程方式支持在其他用户共享的邮件文件夹中获取邮件,以及获取共享文件夹本身。该支持也适用于已委托的文件夹。

例如,Garth 与 John 共享并给予 Garth 的收件箱阅读权限。如果 John 已登录应用并授予委托的权限 (Mail.Read.Shared 或 Mail.ReadWrite.Shared),应用便能访问 Garth 的邮件和收件箱,如下所述。

Microsoft Graph 权限

使用委派权限,Mail.Read.Shared 或 Mail.ReadWrite.Shared,以分别在共享或委派文件夹中读取或写入邮件。

请注意,这两种权限不支持就共享或委派文件夹中的项目 订阅更改通知。 若要对租户中共享、委派或任何其他用户邮件文件夹中的邮件设置更改通知订阅,请使用应用程序权限,Mail.Read。

有关详细信息,请参阅 邮件权限。

获取共享文件夹中的邮件

你可以在 Garth 的收件箱中获取特定邮件:

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

成功完成后,你将收到“HTTP 200 正常”消息和由来自 Garth 收件箱的 {id} 标识的消息实例。

获取共享文件夹中的全部邮件

获取 Garth 收件箱中的所有邮件:

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

成功完成后,你将收到“HTTP 200 正常”消息和 Garth 收件箱中的消息实例的集合。

获取共享文件夹

获取 Garth 与 John 共享的文件夹(收件箱)。

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

成功完成后,你将收到“HTTP 200 正常”消息和表示 Garth 收件箱文件夹的 mailFolder 实例。

如果 Garth 已经委派 John 进一步访问他的收件箱,或者如果 Garth 已将其整个邮箱委派给 John,那么可应用相同的 GET 功能。

如果 Garth 既未与 John 共享自己的收件箱,也未将自己的邮箱委托给 John,那么在这些 GET 操作中指定 Garth 的用户 ID 或用户主体名称便会返回错误。

后续步骤

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 abheek-das)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。