如何使用Graph API仅获取Outlook中“重点”选项卡的邮件？

• 你可以通过 Graph API 的 $filter 查询参数筛选 InferenceClassification 属性实现需求，重点收件箱的邮件对应属性值为 Focused，其他收件箱对应为 Other
• 优化小提示：如果是获取当前登录用户的邮件，不需要先调用 /me 接口获取用户ID，直接调用 /me 前缀的接口即可，可减少一次请求

请求示例 #

针对当前登录用户的请求 #

GET https://graph.microsoft.com/v1.0/me/mailFolders/Inbox/messages?$filter=InferenceClassification eq 'Focused'

针对指定用户ID的请求 #

GET https://graph.microsoft.com/v1.0/users/{user-id}/mailFolders/Inbox/messages?$filter=InferenceClassification eq 'Focused'

补充说明 #

• 如果你需要同时获取重点/其他分类标识，不需要额外请求参数，接口返回的消息体中默认会携带 InferenceClassification 字段，可直接读取判断
• 如果目标用户未启用重点收件箱功能，该筛选条件不会报错，会直接返回全部收件箱邮件

内容的提问来源于stack exchange，提问作者Karen-S