Что такое microsoft graph
API Microsoft Graph
API Microsoft Graph — это веб-API RESTful, который позволяет получать доступ к ресурсам службы Microsoft Cloud. После регистрации приложения и получения токена проверки подлинности для пользователя или службы можно выполнять запросы к API Microsoft Graph. Дополнительные сведения см. в статье Обзор Microsoft Graph.
Microsoft Graph предоставляет REST API и клиентские библиотеки для доступа к данным в следующих службах Microsoft:
Версии
В настоящее время доступны следующие версии API Microsoft Graph:
Приступая к работе
Для чтения из ресурса (например, пользователя или сообщения электронной почты) или записи в него, создается запрос, который выглядит следующим образом:
Дополнительные сведения об элементах созданного запроса см. в разделе Использование 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, включая инструкции и руководства по работе, см. в следующих статьях:
Основные службы и компоненты в Microsoft Graph
Microsoft Graph позволяет интегрировать приложение с лучшими службами Microsoft 365, Windows 10 и Enterprise Mobility + Security в Microsoft 365, используя REST API и клиентские библиотеки. Кроме того, в нем имеются функции аналитики системы безопасности, с помощью которых можно повысить эффективность работы пользователей, стимулировать творчество и совместную работу в группах, а также защищать бизнес-ресурсы и данные пользователей.
Пользователи и группы
В основе Microsoft Graph лежит концепция пользователя и группы.
Пользователь в Microsoft Graph — это один из миллионов людей, которые используют облачные службы Microsoft 365. Это центральная точка, чье удостоверение защищено и доступ к которой хорошо управляется. Данные пользователя — это то, на чем основан бизнес. Службы Microsoft Graph делают эти данные доступными для организаций в функциональных контекстах, обновлениях в режиме реального времени и результатах глубокой аналитики. Доступ к данным всегда предоставляется только при наличии соответствующих разрешений.
Группа Microsoft 365 — это фундаментальный объект, с помощью которого пользователи могут вести совместную работу. Она интегрируется с другими службами, что позволяет использовать более функциональные сценарии при планировании задач, работе в группах, обучении и т. д.
| Компонент | Вспомогательные службы | Описание | Дополнительные сведения |
|---|---|---|---|
| Пользователи | Azure AD и большая часть служб для повышения производительности труда, совместной работы, аналитики и обучения | Пользователь — это основной объект в Microsoft Graph, для которого во многих службах Microsoft Graph создаются функции, ориентированные на пользователей. | Обзор пользователей в Microsoft Graph |
| Группы | Azure AD, OneDrive, OneNote, Outlook, Планировщик | Группа Microsoft 365 — это основа для совместной работы. В группах пользователи могут обмениваться беседами, файлами, заметками, календарями планами и т. д. | Обзор групп Microsoft 365 в Microsoft Graph |
Соединение данных пользователей, служб Microsoft 365 и ваших приложений
Используя пользователей и группы в качестве основы, Microsoft Graph создает сеть служб и компонентов Microsoft 365, которые управляют данными, защищают и извлекают их для поддержки широкого спектра сценариев. С помощью Microsoft Graph вы можете получить доступ к огромному количеству данных пользователей, выполнив при этом необходимую авторизацию.
Краткое руководство по Microsoft Graph: вопросы и ответы
В этой статье представлены ответы на вопросы, связанные с краткими руководствами по Microsoft Graph.
Общая схема
В примерах, содержащихся в кратких руководствах, показано, как использовать всю мощь Microsoft Graph. В этих примерах выполняется доступ к двум службам с использованием одной проверки подлинности: к учетной записи Майкрософт и Outlook. В каждом кратком руководстве используются сведения из профилей пользователей с учетными записями Майкрософт и отображаются события из их календаря.
В каждом кратком руководстве необходимо выполнить четыре действия:
В итоге вы получите приложение, готовое к запуску.
Предварительные условия
Все примеры быстрого запуска требуют доступа к личной учетной записи Майкрософт с почтовым ящиком на Outlook.com или к учетной записи Microsoft work или school с Exchange Online почтовым ящиком. Если у вас нет учетной записи Майкрософт, существует несколько вариантов получения бесплатной учетной записи:
Общие вопросы, касающиеся примеров из краткого руководства
Можно ли получить код из краткого руководства, не выполняя скачивание на странице краткого руководства?
Да, конечно! Каждый скачиваемый экземпляр краткого руководства основан на учебнике по Microsoft Graph, поэтому у вас есть два других варианта для получения такого же исходного кода:
Учебники и репозитории GitHub
В таблице ниже перечислены соответствующие учебники и репозитории GitHub для каждого примера из краткого руководства.
| Краткое руководство | Учебник | Репозиторий GitHub |
|---|---|---|
| Android | Учебник | GitHub |
| Angular | Учебник | GitHub |
| ASP.NET MVC | Учебник | GitHub |
| iOS Swift | Учебник | GitHub |
| iOS Objective-C | Учебник | GitHub |
| Node.js | Учебник | GitHub |
| PHP | Учебник | GitHub |
| Python | Учебник | GitHub |
| React | Учебник | GitHub |
| Ruby | Учебник | GitHub |
| UWP | Учебник | GitHub |
| Xamarin | Учебник | GitHub |
Почему в примерах из краткого руководства нет вариантов использования расширенной проверки подлинности?
Примеры из краткого руководства используются для ознакомления с функцией проверки подлинности и вызовов API Microsoft Graph. Дополнительные сведения о других потоках проверки подлинности см. в документации Azure Active Directory.
Что делать при возникновении непредвиденной ошибки или проблемы с кратким руководством?
Если не удается обеспечить правильную работу при использовании краткого руководства, опубликуйте проблему в соответствующем репозитории GitHub.
Известные проблемы
При запуске краткого руководства ASP.NET отображается ошибка «Не удается найти часть пути [. ]\Graph Tutorial\graph-tutorial\bin\roslyn\csc.exe».
Это вызвано проблемой с Visual Studio и компилятором Roslyn. Исправить эту ошибку можно одним из следующих вариантов:
При запуске краткого руководства возникает ошибка «AADSTS50011: URL-адрес ответа, указанный в запросе, не совпадает с URL-адресами ответов, настроенными для приложения».
Это указывает на проблему с регистрацией приложения для краткого руководства. Когда вы скачиваете краткое руководство со страницы кратких руководств Microsoft Graph, для вас создается регистрация приложение и выполняется настройка URL-адреса ответа (другое название — URL-адрес перенаправления), совпадающего с URL-адресом по умолчанию, который используется примером проекта. Если изменить URL-адрес, нарушается соответствие регистрации приложения, и может возникнуть эта ошибка. Чтобы устранить эту ошибку, обратитесь к файлу README.md, включенному в проект краткого руководства, за инструкциями о том, как создать регистрацию приложения и настроить ее в примере кода.
После регистрации мне говорят, что мне нужно утверждение администратора.
После подписания в один из примеров быстрого запуска вы можете увидеть сообщение с утверждением необходимости администратора «XXX Учебник нуждается в разрешении на доступ к ресурсам в вашей организации, которые может предоставить только администратор. Пожалуйста, попросите администратора предоставить разрешение этому приложению, прежде чем вы сможете использовать его.» Это не ошибка с образцом! Ни один из быстрых стартов не запрашивает Graph области разрешений, которые по умолчанию требуют согласия администратора. Администраторы клиентов могут отключить возможность согласия на Graph области разрешений для любых приложений, которые они не одобрили. В этом случае вы увидите эту ошибку.
Вам потребуется работать с администраторами, чтобы получить утверждение, использовать личную учетную запись Майкрософт (Outlook.com) или использовать тестовый Microsoft 365 с Exchange Online.
Не нашли то, что искали?
Если в этой статье вы не нашли ответ на интересующий вас вопрос касательно одного или нескольких кратких руководств, сообщите нам об этом в разделе Отзыв ниже.
Обзор Microsoft Graph
Microsoft Graph открывает доступ к данным и средствам искусственного интеллекта в Microsoft 365. Благодаря этому вы получите единую модель программируемости, которую можно использовать для доступа к колоссальному объему данных в Microsoft 365, Windows 10 и Enterprise Mobility + Security. Используйте многочисленные данные в Microsoft Graph и создавайте приложения с миллионной аудиторией для организаций и пользователей.
Данные и службы для расширения возможностей платформы Microsoft 365
Три основных компонента платформы Microsoft 365 упрощают доступ к данным и их поток:
Одновременное использование API Microsoft Graph, соединителей и подключения к данным позволяет расширить возможности платформы Microsoft 365. Благодаря доступу к данным Microsoft Graph и другим наборам данных вы можете получить статистику и аналитику, расширить возможности Microsoft 365 и создавать уникальные интеллектуальные приложения.
Из чего состоит Microsoft Graph?
Microsoft Graph предоставляет интерфейсы REST API и клиентские библиотеки для доступа к данным в нижеуказанных облачных службах Майкрософт:
Что можно делать с помощью Microsoft Graph?
Microsoft Graph позволяет обрабатывать уникальный контекст пользователя и делать его более результативным. Представьте приложение, которое.
В качестве примера выберите первый сценарий поиска участников собрания. С помощью API Microsoft Graph вы можете:
С помощью связей вы можете перейти к другим ресурсам:
Microsoft Graph продолжает открывать возможности платформы Microsoft 365 для разработчиков, но исключительно при наличии соответствующих разрешений.
Популярные запросы API
Ознакомьтесь с некоторыми из популярных сценариев работы с API Microsoft Graph. Ссылки ведут на песочницу Graph.
| Операция | URL-адрес |
|---|---|
| GET мой профиль | https://graph.microsoft.com/v1.0/me |
| Получение своих файлов | https://graph.microsoft.com/v1.0/me/drive/root/children |
| Получение своей фотографии | https://graph.microsoft.com/v1.0/me/photo/$value |
| Получение своей почты | https://graph.microsoft.com/v1.0/me/messages |
| GET моя почта высокой важности | https://graph.microsoft.com/v1.0/me/messages?$filter=importance%20eq%20’high’ |
| GET события в моем календаре | https://graph.microsoft.com/v1.0/me/events |
| GET мой руководитель | https://graph.microsoft.com/v1.0/me/manager |
| GET последний пользователь, изменивший файл foo.txt | https://graph.microsoft.com/v1.0/me/drive/root/children/foo.txt/lastModifiedByUser |
| Получение групп Microsoft 365, участником которых я являюсь | https://graph.microsoft.com/v1.0/me/memberOf/$/microsoft.graph.group?$filter=groupTypes/any(a:a%20eq%20’unified’) |
| GET пользователи в моей организации | https://graph.microsoft.com/v1.0/users |
| GET группы в моей организации | https://graph.microsoft.com/v1.0/groups |
| GET пользователи, связанные со мной | https://graph.microsoft.com/v1.0/me/people |
| GET элементы, популярные в моей компании | https://graph.microsoft.com/beta/me/insights/trending |
| GET мои заметки | https://graph.microsoft.com/v1.0/me/onenote/notebooks |
Перенос данных из внешнего источника контента в Microsoft Graph
Используйте соединители Microsoft Graph для переноса данных, не входящих в Microsoft Cloud, в Microsoft Graph. Примерами таких данных могут быть база данных отдела кадров организации или каталог продуктов, размещенные локально, в общедоступных или частных облаках.
Соединители Microsoft Graph позволяют создавать подключения к внешним источникам данных, индексировать данные и хранить их как внешние настраиваемые элементы и файлы. После индексирования эти элементы могут отображаться в Поиске (Майкрософт), а также для приложений, использующих API Поиска (Майкрософт).
Масштабируемый доступ к данным Microsoft Graph с помощью подключения к данным Microsoft Graph
Используйте подключение к данным Microsoft Graph для получения масштабируемого доступа к данным в Microsoft Graph, предоставляя администраторам точечные разрешения и полный доступ к этим данным. Подключение к данным помогает оптимизировать их доставку в Microsoft Azure.
С помощью средств Azure можно создавать интеллектуальные приложения с такими функциями:
Когда следует использовать API Microsoft Graph или подключение к данным?
Microsoft Graph Data Connect предоставляет новый способ взаимодействия с данными, доступными с помощью интерфейсов API Microsoft Graph. Подключение к данным предоставляет уникальный набор инструментов, которые помогают оптимизировать создание интеллектуальных приложений в рамках облака Майкрософт.
Использование API Microsoft Graph
Microsoft Graph — это соответствующий ограничениям REST веб-API, обеспечивающий доступ к ресурсам службы Microsoft Cloud. После регистрации приложения и получения маркеров аутентификации для пользователя или службы можно отправлять запросы к API Microsoft Graph.
Важно! Изменяется принцип применения политик условного доступа к Microsoft Graph. Вам необходимо обновить свои приложения, чтобы они могли обрабатывать сценарии, в которых выполняется настройка политик условного доступа. Дополнительные сведения и рекомендации см. в статье Руководство для разработчиков по условному доступу в Azure Active Directory.
Пространство имен OData
Вызов метода API REST
Для чтения или записи ресурса, например пользователя или сообщения электронной почты, создайте запрос, показанный ниже:
После создания запроса возвращается ответ, который включает:
Методы HTTP
Чтобы определить функцию запроса, Microsoft Graph использует метод HTTP. API поддерживает перечисленные ниже методы.
Версия
Мы всегда рады отзывам о бета-версиях API. Чтобы оставить отзыв или предложить функцию, посетите наш форум идей для платформы разработчиков Microsoft 365.
Дополнительные сведения о версиях API см. в статье Управление версиями и поддержка.
Ресурс
Ресурс может быть объектом или сложным типом и обычно определяется с помощью свойств. Объекты всегда содержат свойство id, что отличает их от сложных типов.
Для доступа к каждому ресурсу могут потребоваться особые разрешения. Для создания и обновления ресурса часто требуется более высокий уровень разрешений, чем для чтения. Сведения о требуемых разрешениях см. в справочной статье о методе.
Параметры запроса
В качестве параметров запросов могут использоваться системные параметры запроса OData или другие строки, поддерживаемые методом для настройки ответа.
Вы можете использовать необязательные системные параметры запроса OData, чтобы изменять свойства, включаемые в ответ, находить элементы, соответствующие пользовательскому запросу, и указывать дополнительные параметры для метода.
Дополнительные сведения о параметрах запроса OData см. в статье Настройка ответов с помощью параметров запроса.
Инструменты для взаимодействия с Microsoft Graph
Песочница Graph
Песочница Graph — это веб-инструмент, который можно использовать для создания и тестирования запросов с помощью API Microsoft Graph. Песочница Graph доступна по адресу: https://developer.microsoft.com/graph/graph-explorer.
Вы можете получить доступ к демонстрационным данным без входа или войти в свой клиент. Чтобы отправить запрос, выполните следующее:
В следующем примере показан запрос, возвращающий сведения о пользователях в демонстрационном клиенте:
Примеры запросов представлены в песочнице Graph, чтобы вы могли быстрее запускать распространенные запросы. Чтобы просмотреть доступные примеры, выберите Показать другие примеры. Выберите Вкл для набора примеров, который вы хотите просмотреть, и после закрытия окна выбора должен появиться список готовых запросов.
После отправки запроса отображается код состояния и сообщение, а запрос выводится на вкладке Просмотр отклика.
Postman
Postman — это инструмент, который можно использовать для создания и тестирования запросов с помощью API Microsoft Graph. Вы можете скачать Postman по адресу: https://www.getpostman.com/. Чтобы взаимодействовать с Microsoft Graph в Postman, используйте коллекцию Microsoft Graph.
Дальнейшие действия
Все готово для настройки Microsoft Graph. Воспользуйтесь кратким руководством или начните с одного из пакетов SDK или примеров кода.