如何通过Graph API从Exchange获取Outlook邮件的PidTag属性？

要读取这类仅包含十六进制Tag num、符号名、类型的PidTag属性，你需要利用Graph API的singleValueExtendedProperties结合公共命名属性的固定GUID来构造查询——这类PidTag属于MAPI公共命名属性范畴，对应的GUID是00020329-0000-0000-C000-000000000046（即PS_PUBLIC_STRINGS）。

具体实现步骤 #

1. 确定属性关键信息：从OutlookSpy中提取目标PidTag的两个核心参数：

   • 十六进制Tag num（例如PR_ACCESS的Tag num是0x0FF4）
   • 对应的Graph数据类型（PR_ACCESS是PT_LONG类型，对应Graph的Integer32；常见映射：PT_STRING8→String、PT_SYSTIME→DateTimeOffset）

2. 构造查询请求：
   通过$expand和$filter指定要获取的扩展属性，有两种格式可选：

   • 通过Tag Id指定：

     GET https://graph.microsoft.com/v1.0/me/messages/{message-id}?$select=subject&$expand=singleValueExtendedProperties($filter=id eq 'Integer32 {00020329-0000-0000-C000-000000000046} Id 0xFFF4')
     

   • 通过符号名指定（若属性有友好名称）：

     GET https://graph.microsoft.com/v1.0/me/messages/{message-id}?$select=subject&$expand=singleValueExtendedProperties($filter=id eq 'Integer32 {00020329-0000-0000-C000-000000000046} Name Access')
     

3. 解析返回结果：
   响应的singleValueExtendedProperties数组中，value字段即为目标PidTag的属性值。

注意事项 #

• 数据类型必须严格匹配：如果类型不对应（比如用String请求整数类型属性），API会返回错误。
• 部分PidTag无友好名称，此时只能通过Tag Id方式查询。

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