更新Outlook联系人时遇错误：“The OData request is not supported.”求助

问题分析 #

你碰到的ErrorInvalidRequest错误提示"The OData request is not supported"，大概率是请求格式不符合Microsoft Graph API的要求。结合你的代码片段来看，核心问题集中在属性名命名规范和HTTP请求方法这两点上。

关键修正点 #

1. Graph API要求属性名用小驼峰格式
   Microsoft Graph的OData模型里，联系人属性都是小驼峰命名（比如givenName而非GivenName），你代码里用了大驼峰键名，这会被API判定为无效属性，直接导致请求被拒绝。

2. 必须用PATCH方法做部分更新
   更新联系人的部分字段时，Graph API强制要求使用PATCH请求方法——PUT是用来替换整个联系人资源的，需要提交所有必填字段，显然不符合你当前的更新场景。

3. 请求头必须配置正确
   一定要包含Content-Type: application/json和有效的Bearer授权头，否则API连你的请求体都无法正确解析。

修正后的完整代码示例 #

// 替换为你的有效访问令牌和目标联系人ID
$accessToken = "your-valid-bearer-token";
$contactId = "target-contact-id-here";

// 修正为小驼峰命名的属性
$Sync1 = array(
    "givenName" => "Manjit",
    "businessPhones" => ["+1 732 555 0102"],
    "homeAddress" => array(
        "street" => "Some street",
        "city" => "Seattle",
        "state" => "WA",
        "postalCode" => "98121"
    ),
    "birthday" => "1974-07-22"
);

$JsonEncodedData1 = json_encode($Sync1);

// 配置正确的请求头
$headers = array(
    "Authorization: Bearer {$accessToken}",
    "Content-Type: application/json"
);

// 初始化CURL请求
$ch = curl_init("https://graph.microsoft.com/v1.0/me/contacts/{$contactId}");
// 设置为PATCH方法
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PATCH");
curl_setopt($ch, CURLOPT_POSTFIELDS, $JsonEncodedData1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 执行请求并获取响应
$response = curl_exec($ch);
curl_close($ch);

// 输出响应结果调试
var_dump($response);

额外注意事项 #

• 权限验证：确保你的应用已经获得Contacts.ReadWrite权限，否则会触发权限不足的错误。
• 端点正确性：如果是操作组织内其他用户的联系人，端点要改成https://graph.microsoft.com/v1.0/users/{user-id}/contacts/{contact-id}，不能用/me/contacts/...。
• JSON格式检查：可以用JSON校验工具验证json_encode后的结果是否符合标准JSON格式，避免转义或语法错误。

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