API Microsoft Graph

API Microsoft Graph — это веб-API RESTful, который позволяет получать доступ к ресурсам службы Microsoft Cloud. После регистрации приложения и получения токена проверки подлинности для пользователя или службы можно выполнять запросы к API Microsoft Graph. Дополнительные сведения см. в статье Обзор Microsoft Graph.

Microsoft Graph предоставляет REST API и клиентские библиотеки для доступа к данным в следующих службах Microsoft:

  • Службы Microsoft 365: Delve, Excel, Microsoft Bookings, Microsoft Teams, OneDrive, OneNote, Outlook/Exchange, Planner и SharePoint.
  • Службы Enterprise Mobility and Security: Advanced Threat Analytics, Advanced Threat Protection, Azure Active Directory, Identity Manager и Intune.
  • Службы Windows 10: действия, устройства, уведомления.
  • Dynamics 365 Business Central

Версии

В настоящее время доступны следующие версии API Microsoft Graph:

  • Бета-версия. В ней доступны API предварительной версии для работы через конечную точку https://graph.microsoft.com/beta. Чтобы приступить к использованию бета-версий API, см. статью Справочник по конечным точкам бета-версии Microsoft Graph.
  • Версия 1.0. Эта версия содержит общедоступные API, готовые к использованию в рабочей среде. Для работы с ними предназначена конечная точка https://graph.microsoft.com/v1.0. Чтобы приступить к использованию API версии 1.0, см. статью Справочник по API REST версии 1.0 в Microsoft Graph.

Дополнительные сведения о версиях API Microsoft Graph см. в статье Управление версиями, поддержка и политики критических изменений для Microsoft Graph.

Приступая к работе

Для чтения из ресурса (например, пользователя или сообщения электронной почты) или записи в него, создается запрос, который выглядит следующим образом:

{HTTP method} https://graph.microsoft.com/{version}/{resource}?{query-parameters}

Дополнительные сведения об элементах созданного запроса см. в разделе Использование API Microsoft Graph.

Доступны примеры быстрого запуска, которые показывают, как получить доступ к возможностям API Microsoft Graph. В доступных примерах рассматривается доступ к двум службам с использованием одной проверки подлинности: учетная запись Майкрософт и Outlook. При каждом быстром запуске осуществляется доступ к информации из профилей пользователей учетных записей Майкрософт и отображаются события из их календаря. Быстрые запуски можно разделить на четыре этапа:

  • Выбор своей платформы
  • Получение идентификатора приложения (идентификатор клиента)
  • Сборка примера
  • Вход и просмотр событий в календаре

По завершении быстрого запуска вы получаете готовое к работе приложение. Дополнительные сведения см. в разделе Вопросы и ответы по быстрым запускам в Microsoft Graph. Чтобы приступить к работе с примерами, см. статью Быстрые запуски в Microsoft Graph.

Инструменты

Microsoft Graph Explorer — это веб-инструмент, который можно использовать для создания и тестирования запросов к API Microsoft Graph. Он доступен по адресу https://developer.microsoft.com/graph/graph-explorer.

Postman — это еще один инструмент, который позволяет выполнять запросы к API Microsoft Graph. Скачать его можно по адресу https://www.getpostman.com. Для взаимодействия с Microsoft Graph в Postman используется коллекция Microsoft Graph Postman.

Дальнейшие действия

Дополнительные сведения о Microsoft Graph, включая инструкции и руководства по работе, см. в следующих статьях: