Microsoft Graph API无法针对toRecipients数组使用$filter过滤操作

正确实现基于toRecipients字段过滤的两种方案 #

方案1：使用$filter+lambda表达式（精确匹配收件人邮箱）

你之前触发报错的核心原因是缺少Graph API对集合字段过滤的强制要求参数，正确配置如下：

• 必须添加的请求头：

  ConsistencyLevel: eventual
  

• 完整请求URL：

  https://graph.microsoft.com/v1.0/me/mailFolders/sentItems/messages?$top=1000&$count=true&$filter=toRecipients/any(r: r/emailAddress/address eq 'abc@abc.com')
  

• 语法说明：
  • any是针对数组类型字段的lambda操作符，括号内的r为数组元素的临时变量，可自定义命名
  • 路径r/emailAddress/address完全匹配返回的toRecipients字段层级结构

方案2：使用$search限定收件人范围（模糊匹配，使用更便捷）

如果不需要严格精确匹配，可直接用to:语法限定搜索范围为收件人，无需额外请求头：

• 完整请求URL：

  https://graph.microsoft.com/v1.0/me/mailFolders/sentItems/messages?$top=1000&$search="to:abc@abc.com"
  

• 说明：该方式会搜索所有收件人字段中包含指定邮箱的邮件，搜索效率高于$filter方案。

内容的提问来源于stack exchange，提问作者Ram Prasad