如何查找Outlook中邮件文件夹的folderId

无Graph权限时的临时获取方法 #

• 网页端抓包取数：登录对应业务账号的Outlook网页版，定位到目标邮件文件夹。按F12打开浏览器开发者工具，切换到「网络」面板，筛选Fetch/XHR请求类型。点击目标文件夹触发内容刷新，在请求列表中查找路径包含/mailFolders/的接口请求，URL中/mailFolders/路径后拼接的字符串就是目标folderId，将URL编码的字符做解码后即可直接用于接口调用。如果抓包操作不熟练，也可以右键目标文件夹选择「属性」，部分租户配置下，属性面板的位置字段末尾会直接标注folderId。
• 桌面客户端取隐藏属性：打开Outlook桌面客户端，找到目标文件夹右键选择「属性」，切换到常规选项卡，按住Ctrl键的同时点击面板左下角的「高级」按钮，就能调出隐藏的文件夹属性页。在属性列表中找到PR_ENTRYID字段，对应的值做Base64解码后转换为Graph兼容的EwsId格式，就是可用的folderId。不同版本Outlook的字段命名可能有细微差别，优先找带EntryID标识的字段即可。

长期稳定调用的合规方案 #

• 临时抓包拿到的folderId可以满足短期调试需求，但如果要做长期稳定的程序化拉取，建议走企业内部IT审批流程，给调用账号申请最小必要的Graph权限：如果拉取账号自身邮箱的文件夹，申请Mail.Read委托权限即可；如果拉取共享业务邮箱的文件夹，申请对应该业务邮箱的Mail.Read应用权限即可，不需要申请全租户范围的高风险权限，审批通过率很高。
• 权限生效后，直接调用列取邮件文件夹的接口，就能批量拿到所有文件夹的id和显示名，不会出现手动取id匹配错误的问题，接口示例：

GET https://graph.microsoft.com/v1.0/users/{业务邮箱地址}/mailFolders?$select=id,displayName
Authorization: Bearer {你的接口访问令牌}

注意：如果是访问共享业务邮箱，不需要给调用账号分配邮箱的完整访问权限，在权限申请单中明确说明用途为拉取指定文件夹的业务邮件即可，符合最小权限原则的申请一般都会快速过审。

内容的提问来源于stack exchange，提问作者Ricardo de Vries