You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

调用Graph API仅返回公共文件夹,如何获取邮箱可恢复项目等隐藏文件夹?

没问题!在Microsoft Graph API里确实有办法获取那些像「可恢复项目」这类的隐藏邮箱文件夹,比EWS的方式其实更直观,我给你拆解两种常用方案:

获取隐藏邮箱文件夹的Graph API实现

1. 一次性获取所有隐藏+可见文件夹

默认调用/users/{id}/mailFolders只会返回Outlook界面中可见的文件夹,只要加上includeHiddenFolders=true查询参数,就能一次性拿到所有文件夹(包括隐藏的系统文件夹):

GET https://graph.microsoft.com/v1.0/users/{id}/mailFolders?includeHiddenFolders=true

返回结果里就会包含「可恢复项目」、「同步问题」、「已清除的项目」这类平时看不到的系统文件夹。

2. 精准定位单个隐藏系统文件夹

如果你不需要遍历所有文件夹,只想直接访问某个特定的隐藏文件夹(比如「可恢复项目」),可以用Graph API提供的WellKnownFolderName枚举值直接调用端点,省去筛选步骤:
比如访问「可恢复项目」根目录:

GET https://graph.microsoft.com/v1.0/users/{id}/mailFolders/RecoverableItemsRoot

常用的隐藏系统文件夹对应的枚举值还有:

  • RecoverableItemsDeletions:可恢复项目里的「已删除邮件」
  • RecoverableItemsVersions:可恢复项目里的「版本记录」
  • RecoverableItemsPurges:可恢复项目里的「已清除的项目」
  • SyncIssues:同步问题文件夹

权限注意事项

要访问这些文件夹,你的应用或用户需要拥有Mail.Read或Mail.ReadWrite权限,确保权限范围覆盖了目标邮箱。

对比EWS的话,Graph API的方式不需要手动处理遍历深度或者复杂的筛选逻辑,用参数或枚举值就能直接拿到想要的内容,效率更高。

内容的提问来源于stack exchange,提问作者Sameer

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.22 07:56:21