使用 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 或用户主体名称便会返回错误。
后续步骤
- 为什么与 Outlook 邮件集成
- 在 Microsoft Graph v1.0 中 使用邮件 API 及其 用例
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 abheek-das)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
