如何使用Microsoft Graph API通过search的participants字段搜索多邮箱地址的邮件？

失效原因说明 #

当使用$search参数拼接多邮箱条件时，如果只在首个邮箱前加participants:字段限定，后续拼接的其他邮箱、小写or关键字会被解析为无字段约束的全文匹配内容，严重时会触发语法解析异常，最终跳过筛选规则返回邮箱全量消息。
另外需要注意，Graph 的$search语法要求逻辑运算符必须为全大写，小写的or、and会被当成普通文本搜索，直接失去逻辑判断作用。

正确语法规则 #

• 每个需要匹配的邮箱地址，都要单独补充participants:字段前缀
• 条件之间使用全大写的OR连接，不要使用小写逻辑运算符
• 整体搜索内容按原规则用双引号包裹后做URL编码

可正常运行的PHP cURL实现示例 #

// 配置需要匹配的目标邮箱列表
$targetEmails = [
    'email@domain.com',
    'anotheremail@anotherdomain.com'
];

// 为每个邮箱单独拼接participants字段限定
$searchClauseList = array_map(
    function($mailAddress) {
        return "participants:{$mailAddress}";
    },
    $targetEmails
);

// 用全大写OR拼接所有搜索子句
$rawSearchContent = implode(' OR ', $searchClauseList);
// 对搜索内容做URL编码
$encodedSearch = urlencode($rawSearchContent);

// 拼接最终请求URL，注意$search参数值要用双引号包裹
$requestUrl = 'https://graph.microsoft.com/v1.0/me/messages?$search="' . $encodedSearch . '"';

// 初始化cURL请求，逻辑与单邮箱查询完全一致
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $requestUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, false);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Prefer: outlook.body-content-type="text"',
    'Accept: application/json',
    'Authorization: Bearer ' . $account['access_token']
));

$response = curl_exec($ch);
print_r($response);

常见踩坑提醒 #

• 禁止把多个邮箱值直接接在同一个participants:后面，这类写法不符合Graph 搜索的字段作用域规则，会直接导致筛选失效
• 所有逻辑运算符必须使用全大写格式，小写运算符不会被识别为逻辑判断关键字
• 不要混淆$search和$filter的语法规则：$search的字段限定仅作用于紧随其后的单个匹配值，不支持多值后缀写法

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