Microsoft graph: Microsoft Graph overview

Содержание

Общие сведения о Microsoft Graph — Microsoft Graph

Обратная связь Изменить

Twitter LinkedIn Facebook Адрес электронной почты

Статья
06/17/2022
Чтение занимает 5 мин

Microsoft Graph открывает доступ к данным и средствам искусственного интеллекта в Microsoft 365. Благодаря этому вы получите единую модель программируемости, которую можно использовать для доступа к колоссальному объему данных в Microsoft 365, Windows и Enterprise Mobility + Security. Используйте многочисленные данные в 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 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, Календарь, Delve, Excel, Обнаружение электронных данных в Центре соответствия требованиям Microsoft 365, Поиск (Майкрософт), OneDrive, OneNote, Outlook/Exchange, Люди (контакты Outlook), Планировщик, SharePoint, Teams, Список дел, Viva Аналитика
Службы Enterprise Mobility + Security: Advanced Threat Analytics, Расширенная защита от угроз, Azure Active Directory, 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 вы можете:

Получить адреса электронной почты участников собрания.
Просмотреть информацию о каждом из них как о пользователе в Azure Active Directory и получить сведения о профиле.

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

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

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

Примечание

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

Операция	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 Azure.

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

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

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

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

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

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

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

Обратная связь

Отправить и просмотреть отзыв по

Этот продукт Эта страница

Просмотреть все отзывы по странице

Службы и компоненты Microsoft Graph — Microsoft Graph

Статья
07/20/2022
Чтение занимает 8 мин

Microsoft Graph позволяет интегрировать приложение с лучшими службами Microsoft 365, Windows и 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. Наборы API этих служб имеют оптимизированную конструкцию, описанную в статье Рекомендации по REST API Майкрософт, и теперь можно получить доступ к ним через единую конечную точку REST для Microsoft Graph https://graph.microsoft.com. В оставшейся части этой статьи перечислены основные службы и компоненты с разбивкой по категориям.

Управление идентификацией и доступом

Компонент	Вспомогательные службы	Описание	Дополнительные сведения
Управление идентификацией и доступом	Azure AD	Создает ресурсы каталогов, например пользователей, группы и приложения, и управляет ими. Управляет доступом к ресурсам и данным. Предоставляет пользователям доступ к данным о рисках, связанным со входом в систему и учетными записями, в Azure AD.	Обзор управления идентификацией и доступом в Azure AD

Эффективность

Компонент	Вспомогательные службы	Описание	Дополнительные сведения
Календарь	Outlook	Дает пользователям возможность создавать встречи и собрания в Интернете, на мобильных и настольных устройствах. Является частью центра обмена сообщениями Outlook в Microsoft 365, с помощью которого пользователи также могут управлять своими письмами и контактами.	Обзор календарей Outlook
Файлы	OneDrive и SharePoint	Управление и предоставление доступа к файлам пользователей в OneDrive и SharePoint.	Обзор хранилища файлов OneDrive
Почта	Outlook	Дает пользователям возможность общаться, упорядочивать сообщения и управлять приоритетами в их рабочих процессах в Интернете, на мобильных и настольных устройствах. Является частью центра связи Outlook в Microsoft 365, с помощью которого пользователи также могут управлять своими контактами и планировать собрания.	Обзор почты Outlook
Заметки	OneNote	Дает пользователям возможность планировать и упорядочивать идеи и информацию.	Обзор заметок OneNote
Личные контакты	Outlook	Диспетчер контактов в Интернете, на мобильных и настольных устройствах. Является частью центра обмена сообщениями Outlook в Microsoft 365, с помощью которого пользователи также могут управлять своими письмами и планировать собрания.	Обзор личных контактов в Outlook
Книги и диаграммы	Excel	Дает пользователям возможность выполнять сложные вычисления, отслеживать, анализировать и визуализировать данные с помощью электронных таблиц Excel, а также создавать профессиональные отчеты.	Обзор книг и диаграмм Excel
Задачи To-Do	To-Do	Помогает пользователям управлять личными задачами на работе и вне ее. Интегрируется с Outlook, Teams, Планировщиком и Кортаной, являясь, таким образом, единым центром для личных задач пользователя в Microsoft 365.	Обзор задач To Do

Совместная работа и обучение сотрудников

Функция	Вспомогательные службы	Описание	Дополнительные сведения
Облачные коммуникации	Microsoft Teams, Skype	Позволяет приложениям и службам взаимодействовать с пользователями с помощью различных функций для работы с сообщениями, например, использование ботов для обработки вызовов, интеграция собраний по сети в бизнес-сценарии, отображение статуса присутствия пользователей (предварительная версия), а также поиск записей звонков и собраний по сети (предварительная версия).	Обзор облачных коммуникаций
Сайты и списки	SharePoint	Веб-платформа для пользователей и групп Microsoft 365, на которой можно делиться контентом (в том числе списками, файлами и заметками), упорядочивать и искать его, а также управлять им.	Обзор сайтов и контента SharePoint
Задачи и планы	Планировщик	Дает пользователям в группах Microsoft 365 возможность создавать планы, назначать задачи и отслеживать ход их выполнения.	Обзор планов и задач в Планировщике
Командная работа	Microsoft Teams	Цифровой центр и рабочее пространство на основе чатов, в котором участники групп могут обмениваться файлами, заметками, календарями и планами.	Общие сведения работе в группах в Microsoft Teams
Обучение сотрудников	Viva Обучение	Позволяет сотрудникам сделать обучение естественной частью дня, добавляя обучение в поток работы в средствах и платформах Microsoft 365, которые они уже используют. Обнаруживайте и отслеживайте обучение, а также совместно используйте его в различных источниках из центра обучения в Microsoft Teams.	Включение обучения сотрудников с помощью возможностей совместной работы в Teams

Люди и рабочая аналитика

Функция	Вспомогательные службы	Описание	Дополнительные сведения
Люди	Azure AD, Outlook, SharePoint и т. д.	Получение информации о людях в порядке их релевантности для пользователя на основе шаблонов общения и совместной работы пользователей, а также их бизнес-связей.	Обзор данных о людях и рабочей аналитики в Microsoft Graph
Профиль (предварительная версия)	Профиль	Представляет собой упрощенный механизм хранения и получения сведений о людях в клиенте.	Обзор данных о людях и рабочей аналитики в Microsoft Graph
Настройка карточки профиля (предварительная версия)	Карточка профиля	Предоставляет администратору возможность настроить контент, находящийся на карточке профиля Microsoft 365 в организации.	Обзор данных о людях и рабочей аналитики в Microsoft Graph
Аналитика на основе документов	Delve, OneDrive, Outlook, SharePoint	Использование расширенной аналитики и методов машинного обучения для получения документов, популярных в среде пользователя, просмотренных или измененных пользователем, а также документов, к которым пользователь предоставил общий доступ.	Обзор данных о людях и рабочей аналитики в Microsoft Graph
Аналитика (предварительная версия)	Viva Аналитика	Использование расширенной аналитики и методов машинного обучения для получения сведений о том, как и с кем пользователи тратят свое время. Эти данные помогают пользователям спланировать свой день, получить аналитику о различных рабочих закономерностях и обеспечить баланс работы и личной жизни.	Обзор данных о людях и рабочей аналитики в Microsoft Graph

Управление устройствами и приложениями

Функция	Вспомогательные службы	Описание	Дополнительные сведения
Облачная печать	Универсальная печать	Универсальная печать — это облачная инфраструктура печати Microsoft 365, которая обеспечивает простую и безопасную печать для пользователей и снижает трудозатраты ИТ-персонала на администрирование и управление.	Обзор API облачной среды универсальной печати
Управление устройствами и приложениями организации	Intune	Регистрация и настройка устройств, а также управление мобильными приложениями в организации.	Обзор устройств и приложений в Intune
Облачный компьютер (предварительная версия)	Windows 365	Windows 365 — это облачная служба, которая позволяет администраторам легко настраивать облачные ПК с ОС Windows 365 для пользователей в своей организации управлять ими. Отдельные конечные пользователи могут безопасно передавать свои персонализированные приложения Windows из облака Microsoft на любое устройство в любое время с помощью своего облачного ПК.	Работа с облачными ПК с ОС Windows 365 с использованием программного интерфейса Microsoft Graph
Обновления устройств (предварительная версия)	Служба развертывания Windows Update для бизнеса	Обеспечивает контроль над утверждением, планированием, мониторингом и безопасностью содержимого, доставленного из Центра обновления Windows.	Обновления Windows в Microsoft Graph
Управление несколькими клиентами (предварительная версия)	Microsoft 365 Lighthouse	Позволяет поставщикам управляемых служб удаленно управлять несколькими пользовательскими клиентами для обеспечения соответствия требованиям и обнаружения угроз, а также обеспечивать работоспособное и безопасное состояние устройств клиента.	Управление несколькими клиентами с помощью Microsoft 365 Lighthouse
Работоспособность и взаимодействие служб	Службы Microsoft 365 и Dynamics 365	Предоставляет доступ к данным о работоспособности и публикациям центра сообщений об облачных службах Майкрософт. Наглядным примером использования API взаимодействия служб является Центр администрирования Microsoft 365.	Доступ к сведениям о работоспособности и взаимодействии служб в Microsoft Graph

Безопасность

Компонент	Вспомогательные службы	Описание	Дополнительная информация
Интеграция с системой безопасности	Защита идентификации Azure AD, Azure Information Protection, Центр безопасности Azure, Microsoft Defender for Cloud Apps, Advanced Threat Protection в Защитнике Windows и другие	Предоставляет единый шлюз для аналитики безопасности и действий в корпорации Майкрософт и компаниях-партнерах по экосистеме.	Безопасность в Microsoft Graph
Обнаружение электронных данных (eDiscovery)	eDiscovery (премиум) Microsoft Purview	Обеспечивает доступ к возможностям обнаружения электронных данных, применяемых в процессе определения и предоставления электронной информации, которая может использоваться в качестве доказательств в судебных разбирательствах.	Безопасность в Microsoft Graph

Интерфейсы на различных устройствах

Компонент	Вспомогательные службы	Описание	Дополнительные сведения
Интерфейсы на различных устройствах	Веб-канал активности, ретрансляции устройства	Дает возможность использовать интерфейсы приложений, выходящие за рамки одного устройства. С помощью этой функции пользователи могут переходить с одного устройства на другое независимо от типов и платформ устройств.	Обзор использования единого интерфейса на нескольких устройствах

Уведомления пользователей (не рекомендуется)

Важно!

API уведомлений Microsoft Graph не рекомендуется использовать, Он прекратил возвращать данные в январе 2022 г. Дополнительные сведения об уведомлениях см. в Центрах уведомлений Microsoft Azure. Дополнительные сведения см. в этой записи блога.

Функция	Вспомогательные службы	Описание	Дополнительная информация
Уведомления пользователей	Уведомления пользователей	Позволяет использовать интерфейсы приложений для создания интерфейсов уведомлений, ориентированных на пользователя, а также кроссплатформенных интерфейсов уведомлений, включая развертывание для пользователей, универсальное закрытие и доступ к журналу уведомлений.	Включение интерфейсов уведомлений, ориентированных на человека, с использованием уведомлений Microsoft Graph

Отчеты об использовании

Компонент	Вспомогательные службы	Описание	Дополнительные сведения
Отчеты	Microsoft Teams, OneDrive, Outlook, SharePoint, Skype для бизнеса, Yammer	Получение сведений об активности и использовании из службы, поддерживающей такие возможности.	Обзор отчетов об использовании

Образование

Компонент	Вспомогательные службы	Описание	Дополнительные сведения
Образование	Azure AD, образование	Предоставление сведений, релевантных для сценариев обучения, включая сведения об учебных заведениях, классах, учащихся и преподавателях. Дает независимым поставщикам программного обеспечения возможность создавать приложения для аудиторий, которые экономят преподавателям время и стимулируют работу в группах и совместную работу.	Обзор обучения