Outlook 个人联系人 API 概述

Outlook 联系人可让你存储个人联系人的数据，并且属于Microsoft 365 中 Outlook 邮件中心的一部分。 通过 Outlook，可以管理电子邮件、安排会议、在组织中查找有关用户的信息、启动在线对话、共享文件，以及实现小组协作。

为何要与 Outlook 个人联系人集成？

为亿万客户补充邮件和日历应用场景

亿万消费者和数千万组织客户选择 Outlook 作为他们的电子邮件客户端。 通过让客户在 Outlook 中维护一个方便、集成的联系人数据存储，联系人为邮件和日历提供了一项补充功能。 对于开发者而言，利用邮件或日历的丰富功能，就意味着通过用户的联系人数据开发更丰富的应用场景。

自动执行联系人组织

通过联系人 API，可以保持客户的组织性，与客户通过 Outlook 自己执行此操作等效：

• 与客户体验类似，可以创建 contact 实例并将其分配给 contactFolder 对象。
• 通过联系人 API，可以采用一致的方式分配类别联系人及事件、消息、任务和组帖子，从而增强组织和发现。 此外，可以定义用户的主类别列表，从而开发其他创造性方案。
• 你可以对联系人设置一个标志以进行跟进。 （Microsoft Graph 中的标记目前为预览状态。）

共享联系人信息

通过联系人 API，使你能够获得已登录用户或将其联系人共享或委派给已登录用户的用户的联系人项目。 例如，如果 Garth 与 John 共享联系人文件夹，或者如果 Garth 向 John 委派了访问权限，则来自 John 的委派权限将授予你对 Garth 共享日历和内容的读取访问权限。

利用 Microsoft Graph 中的人员 API 更好地利用所有人员数据

你可以对 Outlook 联系人使用典型 CRUD 操作来创建和管理联系人。 作为 Microsoft Graph 的一部分，还可以使用人员 API，查看用户的 Outlook 联系人，以及社交网络、组织目录和最近通信中的人员，并返回有关所有这些来源中人员的与用户相关度最大的信息。 在人员选取器应用场景中利用这一额外智能。

利用 Microsoft Graph 中的其他共享功能和便利

• 联系人实体支持将联系人照片实现为与存储在Exchange Online或Microsoft Entra ID中的用户照片相同的配置文件照片实体。 这消除了在联系人与用户个人资料照片之间进行转换的开销。
• 你可以通过订阅更改通知和跟踪对联系人和联系人文件夹所做的更改，使应用本地存储保持同步。
• 可以将联系人实例中的应用存储扩展为开放扩展，或者将强类型化的自定义数据添加到联系人架构中作为架构扩展。

数据在什么位置？

Microsoft Graph API 支持访问用户主邮箱和共享邮箱中的数据。 数据可以是作为 Microsoft 365 的一部分存储在云中的邮箱中的日历、邮件或个人联系人Exchange Online。

此 API 不支持访问就地存档邮箱（不在 Exchange Online 和 Exchange Server 上）。

API 参考

在查找此服务的 API 参考？

• Microsoft Graph v1.0 中的 Outlook 联系人 API
• Microsoft Graph beta 中的 Outlook 联系人 API

后续步骤

• 在 Graph 浏览器中选择和试用联系人示例查询。 选择左侧列中的“显示更多示例”。 使用菜单启用“个人联系人”。
• 了解如何：
  • 获取 Outlook 资源的不可变标识符
  • 获取共享联系人