Outlook JavaScript API (Office.js) 检索邮件和约会的属性,并在外接程序中对这些项目运行作。 但是,在某些情况下,不需要通过 API 获取所需的数据。 例如,加载项可能需要实现单一登录或标识用户邮箱中源自同一发件人的邮件。 若要获取所需的信息,请通过 Microsoft Graph 使用 Outlook 邮件 REST API。
入门
若要调用 Office 外接程序中的 Microsoft 图形 API,请实现嵌套应用身份验证 (NAA) 解决方案以请求令牌。
重要
旧版Exchange Online用户标识令牌和回调令牌不再受支持,所有Microsoft 365 个租户中均处于关闭状态。 如果 Outlook 外接程序需要委派的用户访问或用户标识,我们建议使用 MSAL (Microsoft身份验证库) 和嵌套应用身份验证。 本地 Exchange 仍支持 Exchange 用户标识令牌。
调用 Microsoft Graph API
获得访问令牌后,即可使用它调用 Microsoft Graph。
Microsoft图形 API由 v1.0 和 beta 终结点组成。 请注意以下有关终结点模式的信息。
-
version指定v1.0或betaAPI。 -
resource指定外接程序与之交互的资源,例如用户、组或站点。 -
query_parameters指定用于自定义请求的参数。 例如,可以仅筛选返回给特定发件人的邮件。
https://graph.microsoft.com/[version]/[resource]?[query_parameters]
有关Microsoft图形 API及其组件的详细信息,请参阅使用Microsoft图形 API。