使用 Microsoft Graph API 在应用中集成人员和工作区智能

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

Microsoft Graph 允许访问相关人员的有用数据、其个人资料、与之交互的文档和工作模式,并支持用户社交环境中的手势。

聚合并提取有关人员的特定信息

功能:人员

你可以使用 person 资源和 People API 从邮件、联系人和社交网络中聚合某个人员的相关信息。 根据多种通信、协作和业务关系按相关性对结果进行排序。 通过此 API 可以基于自己的条件对人员进行浏览、排序、选择、筛选或搜索。

帮助用户将组织内的其他用户置于上下文中考虑

功能:个人资料(预览版)

若要将组织内的其他人员置于上下文中考虑,通常会查看人员的个人资料或个人资料卡片。

profile 资源是关于租户内人员的信息的丰富源,提供了用于存储和检索人员信息的轻型机制。

在组织内部提供个性化的人员体验

功能:个人资料卡片自定义(预览版)

使管理员能够自定义在组织内的 Microsoft 365 中使用的个人资料卡片上显示的信息。

profileCardProperty 资源表示 Microsoft 365 个人资料卡片上的用户的属性,便于组织打造共享的人员体验。

帮助用户获得最相关的工作文档

功能:文档见解

使用见解 API 为用户标识最相关的文档:

管理 @提及

功能:@-提及(预览版)

标注要通知的收件人并在邮件中引起该收件人的注意是一种常见的社交手势。 mention 资源和 Mentions API 提供了一种轻型机制,可以在邮件中标注收件人,获取使用 @提及功能向用户发出通知的所有邮件,或者获取邮件中的每个提及。

帮助用户深入了解其工作模式

功能:分析(预览版)

使用分析 API 获取用户的活动统计信息及相关设置:

  • 设置:要使分析 API 返回用户的结果,当前用户分析设置必须显示有效的Microsoft Viva Insights许可证,选择使用 Viva Insights,并且具有已启用图形的云托管邮箱。
  • activityStatistics:获取整个上周用户花时间参与的 Microsoft 365 活动的相关数据,包括工作时间内及工作之余在通话聊天(即时消息)电子邮件会议上花费的小时数,以及可用于专注工作的小时数。