如何在Microsoft Graph API过滤邮件时排除文件夹及其所有子文件夹？

我正在使用Microsoft Graph API检索邮件，同时排除特定文件夹。当前使用的筛选器如下：

GET /me/messages?$filter=
    parentFolderId ne 'draftBoxID' and 
    parentFolderId ne 'deletedBoxID' and ...

该筛选器仅能排除指定ID的文件夹，无法排除这些文件夹下的所有子文件夹。例如，若草稿文件夹包含多层嵌套子文件夹，仅草稿文件夹本身会被排除，其所有子文件夹中的邮件仍会出现在结果中。

目前我的解决方法是：

1. 递归拉取文件夹树，获取所有子文件夹的ID。
2. 将所有ID添加到筛选器中，格式如下：
   parentFolderId ne 'id1' and parentFolderId ne 'id2' ...

但这种方法存在以下问题：

• 部分用户拥有大量嵌套文件夹。
• 递归收集ID耗时明显。
• 筛选器会变得冗长且混乱。

我想了解：

1. 是否存在某种方法可在单次请求中告知Graph API排除某个文件夹及其所有子文件夹？
2. 是否有OData选项或API机制支持递归文件夹筛选？
3. 是否有更优的实现方案？
4. 目前是否只能通过遍历所有子文件夹并将每个ID添加到筛选器中实现需求？

额外背景：

• 我需要从API获取准确的总数，因此不适合在获取结果后再进行服务器端筛选。
• 缓存每位用户的完整文件夹结构难度较大，因为每位用户的文件夹布局不同且可能随时变更。

1. 单次请求排除文件夹及其所有子文件夹 #

目前Microsoft Graph API的邮件筛选器不支持直接通过父文件夹ID递归排除所有子文件夹。parentFolderId仅匹配邮件的直接父文件夹，无法识别嵌套的层级关系，因此无法通过单次请求实现该需求。

2. OData选项或递归筛选机制 #

OData标准本身支持部分层级查询能力，但Graph API针对邮件资源并未实现递归筛选文件夹的扩展功能。没有内置的OData参数（如特殊的$filter语法）可以直接实现递归排除子文件夹的逻辑。

3. 更优实现方案 #

可以根据场景选择以下优化方案：

• 批量拉取子文件夹ID：针对目标文件夹，使用GET /me/mailFolders/{folder-id}/childFolders?$expand=childFolders($levels=max)一次性拉取所有嵌套子文件夹，替代多次递归请求，减少网络开销；
• 反向缩小筛选范围：如果需要保留的文件夹数量远少于需要排除的，先收集所有目标文件夹ID，再用parentFolderId in ('id1','id2',...)进行筛选，能大幅缩短筛选器长度；
• 利用邮件属性直接过滤：如果排除草稿文件夹是为了过滤草稿邮件，可直接用$filter=isDraft ne true；排除已删除邮件则用$filter=isDeleted ne true，无需关联文件夹ID，效率更高。

4. 是否必须遍历所有子文件夹 #

在需要严格排除特定文件夹及其所有嵌套子文件夹，且必须基于文件夹ID筛选的场景下，目前确实需要先收集所有子文件夹ID再添加到筛选器中。但可以通过以下方式优化：

• 使用上述批量拉取子文件夹的接口，一次性获取所有层级的子文件夹ID；
• 针对使用频率高的用户，设置短时效缓存（如10-15分钟），在缓存有效期内复用文件夹ID列表，避免重复拉取。

内容的提问来源于stack exchange，提问作者손동진