从 Outlook 加载项使用 Microsoft Graph REST API

Outlook JavaScript API (Office.js) 检索邮件和约会的属性,并在外接程序中对这些项目运行作。 但是,在某些情况下,不需要通过 API 获取所需的数据。 例如,加载项可能需要实现单一登录或标识用户邮箱中源自同一发件人的邮件。 若要获取所需的信息,请通过 Microsoft Graph 使用 Outlook 邮件 REST API

入门

若要调用 Office 外接程序中的 Microsoft 图形 API,请实现嵌套应用身份验证 (NAA) 解决方案以请求令牌。

重要

旧版 Exchange 令牌已弃用。 大多数Exchange Online租户的旧版 Exchange 用户标识回调令牌已关闭。 管理员可以在 2025 年 6 月之前为租户和外接程序重新启用旧令牌。 2025 年 10 月,所有租户的旧令牌将完全关闭。 有关时间线和详细信息,请参阅常见问题解答页面。 这是 Microsoft的“安全未来计划”的一部分,该计划为组织提供了应对当前威胁环境所需的工具。 Exchange 用户标识令牌仍适用于本地 Exchange。 嵌套应用身份验证是今后令牌的建议方法。

调用 Microsoft Graph API

获得访问令牌后,即可使用它调用 Microsoft Graph。

Microsoft图形 API由 v1.0 和 beta 终结点组成。 请注意以下有关终结点模式的信息。

  • version 指定 v1.0beta API。
  • resource 指定外接程序与之交互的资源,例如用户、组或站点。
  • query_parameters 指定用于自定义请求的参数。 例如,可以仅筛选返回给特定发件人的邮件。
https://graph.microsoft.com/[version]/[resource]?[query_parameters]

有关Microsoft图形 API及其组件的详细信息,请参阅使用Microsoft图形 API

另请参阅