Обзор Microsoft Graph

Microsoft Graph — это шлюз для данных и аналитики в облачных службах Майкрософт, таких как Microsoft Entra и Microsoft 365. Используйте множество данных, доступных через Microsoft Graph, для создания приложений для организаций и потребителей, взаимодействующих с миллионами пользователей.

Данные и службы для расширения возможностей платформы Microsoft 365

Три основных компонента платформы Microsoft 365 упрощают доступ к данным и их поток:

• API Microsoft Graph предлагает единую конечную точку, https://graph.microsoft.com, для доступа к сложным, ориентированным на пользователя данным и аналитике в Microsoft Cloud, включая Microsoft 365, Windows и Enterprise Mobility + Security. С помощью интерфейсов REST API и пакетов SDK вы можете получить доступ к конечной точке и создавать приложения, которые поддерживают сценарии Microsoft 365 для повышения продуктивности, улучшения совместной работы, обучения, социальной и рабочей аналитики и т. д. Microsoft Graph также включает мощный набор служб для управления удостоверениями пользователей и устройств, доступом, соблюдением требований и безопасностью и для защиты организаций от утечки или потери данных.
• соединители Microsoft 365 Copilot (ранее — соединители Microsoft Graph) работают во входящем направлении, доставляя данные, внешние в microsoft cloud, в службы и приложения Microsoft Graph, чтобы улучшить возможности Microsoft 365, такие как Поиск (Майкрософт). Существуют соединители для многих часто используемых источников данных, например Box, Google Drive, Jira и Salesforce.
• Подключение к данным Microsoft Graph предоставляет набор инструментов для упрощения безопасной и масштабируемой доставки данных Microsoft Graph в популярные хранилища данных Azure. Эти кэшированные данные используются в качестве источников данных для средств разработки Azure, с помощью которых можно создавать интеллектуальные приложения.

Одновременное использование API Microsoft Graph, соединителей и подключения к данным позволяет расширить возможности платформы Microsoft 365. Благодаря доступу к данным Microsoft Graph и другим наборам данных вы можете получить статистику и аналитику, расширить возможности Microsoft 365 и создавать уникальные интеллектуальные приложения.

Из чего состоит Microsoft Graph?

Microsoft Graph предоставляет интерфейсы REST API и клиентские библиотеки для доступа к данным в нижеуказанных облачных службах Майкрософт:

• Основные службы Microsoft 365: Bookings, Calendar, Excel, Microsoft Purview eDiscovery, Поиск (Майкрософт), OneDrive, OneNote, Outlook/Exchange, People (контакты Outlook), Планировщик, SharePoint, Teams, To Do, Viva Аналитика
• Enterprise Mobility + Security службы: Advanced Threat Analytics, Advanced Threat Protection, Microsoft Entra, Identity Manager и Intune
• Службы Windows: действия, устройства, уведомления, универсальная печать
• Службы Dynamics 365 Business Central
• Службы Центра партнеров Майкрософт

Дополнительные сведения см. в статье Основные службы и компоненты в Microsoft Graph.

Что можно делать с помощью Microsoft Graph?

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

• Просматривает следующее собрание и помогает подготовиться к нему, предоставляя информацию об участниках, их должностях и руководителях, а также сведения о последних документах, с которыми работаете вы и ваши сотрудники.
• Проверяет ваш календарь и предлагает оптимальное время для следующего собрания команды.
• Получает диаграмму с перспективной оценкой продаж из файла Excel в OneDrive и позволяет обновлять прогноз в реальном времени с мобильного телефона.
• Подписывается на изменения вашего календаря, отправляет вам оповещение, если вы слишком много времени проводите на собраниях, и рекомендует, какие собрания можно пропустить или поручить кому-нибудь другому (в зависимости от того, насколько их участники важны для вас).
• Помогает вам упорядочивать личные и рабочие данные на телефоне. Например, приложение может группировать изображения, предназначенные для личного хранилища OneDrive, и накладные, которые следует хранить в OneDrive для бизнеса.
• Анализирует масштабируемые данные Microsoft 365, чтобы лица, принимающие решения, видели важные закономерности сотрудничества и распределения во времени, необходимые для повышения производительности работы.
• Вносит пользовательские бизнес-данные в Microsoft Graph и индексирует их для поиска наряду с данными из служб Microsoft 365.

В качестве примера выберите первый сценарий поиска участников собрания. С помощью API Microsoft Graph вы можете:

1. Получить адреса электронной почты участников собрания.
2. Просмотрите их по отдельности как пользователя в Microsoft Entra ID, чтобы получить сведения о своем профиле.

С помощью связей вы можете перейти к другим ресурсам:

• Связаться с его руководителем через связь с руководителем.
• Получить полезные сведения, в том числе о популярных файлах, которые отслеживает пользователь.
• Узнать, какие люди больше всего связаны с пользователем.
• Расширить сценарий с помощью связи memberOf, чтобы узнать, в какие группы входит пользователь.
• Найти других участников в каждой группе.
• Подключиться к другим сценариям, созданным группами, например по обучению и командной работе.

Дополнительные сведения см. в статье Шаблоны интеграции.

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

Примечание.

При использовании API Microsoft Graph вы соглашаетесь с условиями использования API Майкрософт и Заявлением о конфиденциальности Майкрософт.

Популярные запросы 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

Используйте соединители Copilot для переноса данных, которые являются внешними для Microsoft Cloud, в Microsoft Graph. Примерами таких данных могут быть база данных отдела кадров организации или каталог продуктов, размещенные локально, в общедоступных или частных облаках.

Соединители Copilot создают подключения к внешним источникам данных, индексировать данные и хранить их как внешние пользовательские элементы и файлы. После индексирования эти элементы могут отображаться в Поиске (Майкрософт), а также для приложений, использующих API Поиска (Майкрософт).

Доступ к данным Microsoft Graph в масштабе

Используйте Microsoft Graph Data Connect для доступа к данным в Microsoft Graph в большом масштабе, предоставляя администраторам детализированное согласие и полный контроль над своими данными Microsoft Graph. Подключение к данным помогает оптимизировать их доставку в Microsoft Azure.

С помощью средств Azure можно создавать интеллектуальные приложения с такими функциями:

• Найдите ближайшего эксперта по предметной области в вашей организации.
• Автоматизация создания базы знаний.
• Анализ приглашений на собрания для предоставления статистики об использовании конференц-залов.
• Выявление мошенничества с данными производительности и взаимодействия.

Когда следует использовать API Microsoft Graph или подключение к данным?

Microsoft Graph Data Connect предоставляет новый способ взаимодействия с данными, доступными с помощью интерфейсов API Microsoft Graph. Подключение к данным предоставляет уникальный набор инструментов, которые помогают оптимизировать создание интеллектуальных приложений в рамках облака Майкрософт.

Функция	API Microsoft Graph	Microsoft Graph Data Connect
Область доступа	Один пользователь или весь клиент	Несколько пользователей или групп
Шаблон доступа	В режиме реального времени	Повторяющееся расписание
Операции с данными	Работает с оригиналом данных	Работает с кэшем данных
Защита данных	Данные защищены в исходной службе, например Microsoft 365 и Microsoft Entra	Защита данных распространяется на кэш данных в подписке Azure
Согласие пользователя	Самостоятельное Типы ресурсов	Нет
Согласие администратора	Вся организация Типы ресурсов	Выбор групп пользователей Типов и свойства ресурсов Исключает пользователей
Средства доступа	Веб-запросы с применением REST	Фабрика данных Azure

Опробуйте пример приложения

Воспользуйтесь кратким руководством, чтобы настроить готовый к работе пример приложения.

Связанные материалы

• Опробуйте пример запроса в песочнице Graph.
• Изучите службы и функции , которые можно использовать в своих сценариях.
• Изучите шаблоны интеграции , которые могут применяться к вашему сценарию.
• Узнайте о новых возможностях Microsoft Graph.
• Сведения о лимитных API и службах в Microsoft Graph.
• Узнайте, как получить маркер аутентификации в приложении.
• Начните использовать API.