是否支持通过msgraph API按mailFolder的displayName搜索邮件文件夹

Microsoft Graph API 目前支持通过displayName匹配对应的mailFolder，无需走专用搜索接口，使用$filter查询参数即可实现需求，具体实现方式如下：

• 精准匹配指定名称的文件夹
  直接调用mailFolders列表接口，搭配等值匹配规则即可，请求示例：
  GET https://graph.microsoft.com/v1.0/me/mailFolders?$filter=displayName eq '你要搜索的文件夹名称'
  接口会返回所有displayName完全匹配的文件夹列表，包含文件夹ID、邮件统计等完整元数据。
• 模糊匹配名称包含指定关键词的文件夹
  可以使用contains或startsWith运算符做模糊匹配，比如搜索所有名称带「通知」关键词的文件夹：
  GET https://graph.microsoft.com/v1.0/me/mailFolders?$filter=contains(displayName, '通知')

注意事项 #

• 调用接口前需确保应用已申请Mail.Read或更高权限的Mail.ReadWrite授权，权限不足会返回403拒绝访问错误
• 默认接口仅返回根目录层级的文件夹，如果你需要搜索嵌套的子文件夹，需要逐层调用对应父文件夹的/childFolders接口遍历，或者先拉取全量文件夹数据后本地筛选
• 搜索的displayName包含中文、特殊字符时，需要先对参数值做URL编码，避免请求解析失败

如果是高并发、大数据量的搜索场景，也可以搭配Microsoft Search相关的Graph接口实现跨层级的全局搜索，普通业务场景下用$filter方案已经可以满足需求。

内容的提问来源于stack exchange，提问作者Jorgio de la Morena