Поделиться через

Использование REST API Microsoft Graph из надстройки Outlook

API JavaScript для Outlook (Office.js) извлекает свойства сообщений и встреч и выполняет операции с этими элементами в надстройке. Однако могут возникнуть случаи, когда необходимые данные недоступны через API. Например, надстройке может потребоваться реализовать единый вход или идентифицировать сообщения в почтовом ящике пользователя, полученные от того же отправителя. Чтобы получить необходимые сведения, используйте REST API почты Outlook через Microsoft Graph.

Начало работы

Чтобы выполнить вызовы microsoft API Graph в надстройках Office, реализуйте решение для проверки подлинности вложенного приложения (NAA) для запроса маркера.

Важно!

Устаревшие Exchange Online маркеры удостоверений пользователей и маркеры обратного вызова больше не поддерживаются и отключены во всех клиентах Microsoft 365. Если надстройке Outlook требуется делегированный доступ или удостоверение пользователя, рекомендуется использовать MSAL (библиотека проверки подлинности Майкрософт) и вложенную проверку подлинности приложения. Маркеры удостоверений пользователей Exchange по-прежнему поддерживаются для локальной среды Exchange.

Вызов API Microsoft Graph

Получив маркер доступа, вы можете использовать его для вызова Microsoft Graph.

Microsoft API Graph состоит из конечных точек версии 1.0 и бета-версии. Обратите внимание на следующие сведения о шаблоне конечной точки.

  • version указывает v1.0 API или beta .
  • resource указывает ресурс, с которым взаимодействует надстройка, например пользователя, группу или сайт.
  • query_parameters задает параметры для настройки запроса. Например, можно отфильтровать сообщения, возвращаемые только сообщениями от определенного отправителя.
https://graph.microsoft.com/[version]/[resource]?[query_parameters]

Дополнительные сведения о API Graph Майкрософт и ее компонентах см. в разделе Использование API Graph Майкрософт.

См. также

  • Last updated on