Обзор Microsoft GraphOverview of Microsoft Graph

Microsoft Graph открывает доступ к данным и средствам искусственного интеллекта в Microsoft 365.Microsoft Graph is the gateway to data and intelligence in Microsoft 365. Вы получите единую модель программируемости, которую можно использовать для доступа к колоссальному объему данных в Office 365, Windows 10 и Enterprise Mobility + Security.It provides a unified programmability model that you can use to access the tremendous amount of data in Office 365, Windows 10, and Enterprise Mobility + Security. Используйте многочисленные данные в Microsoft Graph и создавайте приложения с миллионной аудиторией для организаций и пользователей.Use the wealth of data in Microsoft Graph to build apps for organizations and consumers that interact with millions of users.

Расширение возможностей платформы Microsoft 365Powering the Microsoft 365 platform

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

Три основных компонента платформы Microsoft 365 упрощают доступ к данным и их поток:In the Microsoft 365 platform, three main components facilitate the access and flow of data:

  • API Microsoft Graph обеспечивает единую конечную точку, https://graph.microsoft.com, для доступа к ценным данным о пользователях и аналитическим сведениям, которые предоставляют ресурсы служб Microsoft 365.The Microsoft Graph API offers a single endpoint, https://graph.microsoft.com, to provide access to rich, people-centric data and insights exposed as resources of Microsoft 365 services. С помощью интерфейсов REST API и пакетов SDK вы можете получить доступ к конечной точке и создавать приложения, которые поддерживают сценарии для повышения продуктивности, улучшения совместной работы и обучения, обеспечения безопасности, проверки удостоверений и прав доступа, управления устройствами и многого другого.You can use REST APIs or SDKs to access the endpoint and build apps that support scenarios spanning across productivity, collaboration, education, security, identity, access, device management, and much more.
  • Подключение к данным Microsoft Graph предоставляет набор инструментов для оптимизации безопасности и масштабируемой доставки данных Microsoft Graph в популярные хранилища данных Azure.Microsoft Graph data connect provides a set of tools to streamline secure and scalable delivery of Microsoft Graph data to popular Azure data stores. Эти кэшированные данные используются в качестве источников данных для средств разработки Azure, с помощью которых можно создавать интеллектуальные приложения.This cached data serves as data sources for Azure development tools that you can use to build intelligent applications.
  • Соединители Microsoft Graph (закрытая предварительная версия) работают во входящем направлении, доставляя внешние данные в службы и приложения Microsoft Graph, а также улучшая возможности настройки.Microsoft Graph connectors (private preview) works in the incoming direction, delivering external data into Microsoft Graph services and applications and enhancing custom experiences.

Одновременное использование API Microsoft Graph, подключения к данным и соединителей (закрытой предварительной версии) позволяет расширить возможности платформы Microsoft 365.Together, the Microsoft Graph API, data connect, and connectors (private preview) power the Microsoft 365 platform. Благодаря доступу к данным Microsoft Graph и другим наборам данных для получения статистики и аналитики вы можете расширить возможности Microsoft 365 и создавать уникальные интеллектуальные приложения.With the ability to access Microsoft Graph data and other datasets to derive insights and analytics, you can extend Microsoft 365 experiences, or build unique, intelligent applications.

Примечание

Соединители Microsoft Graph доступны в закрытой предварительной версии.Note: Microsoft Graph connectors is in private preview. Участие в программе предварительного просмотра возможно исключительно по приглашению.Participation in the preview program is by invitation only. Подробнее о соединителях см. в статье Build 2019: Microsoft Graph powers the Microsoft 365 platform (Сборка 2019. Microsoft Graph расширяет возможности платформы Microsoft 365).For more information about the connectors, see Build 2019: Microsoft Graph powers the Microsoft 365 platform.

Из чего состоит Microsoft Graph?What's in Microsoft Graph?

Microsoft Graph предоставляет интерфейсы REST API и клиентские библиотеки для доступа к данным в таких службах Microsoft 365:Microsoft Graph exposes REST APIs and client libraries to access data on the following Microsoft 365 services:

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

Дополнительные сведения см. в статье Основные службы и компоненты в Microsoft Graph.To find out more, see Major services and features in Microsoft Graph.

Изображение основных ресурсов и отношений, из которых состоит Graph

Что можно делать с помощью Microsoft Graph?What can you do with Microsoft Graph?

Microsoft Graph позволяет обрабатывать уникальный контекст пользователя и делать его более результативным.Use Microsoft Graph to build experiences around the user's unique context to help them be more productive. Представьте приложение, которое...Imagine an app that...

  • Просматривает следующее собрание и помогает подготовиться к нему, предоставляя информацию об участниках, их должностях и руководителях, а также сведения о последних документах, с которыми работаете вы и ваши сотрудники.Looks at your next meeting and helps you prepare for it by providing profile information for attendees, including their job titles and managers, as well as information about the latest documents they're working on, and people they're collaborating with.
  • Проверяет ваш календарь и предлагает оптимальное время для следующего собрания команды.Scans your calendar, and suggests the best times for the next team meeting.
  • Получает диаграмму с перспективной оценкой продаж из файла Excel в OneDrive и позволяет обновлять прогноз в реальном времени с мобильного телефона.Fetches the latest sales projection chart from an Excel file in your OneDrive and lets you update the forecast in real time, all from your phone.
  • Подписывается на изменения вашего календаря, отправляет вам оповещение, если вы слишком много времени проводите на собраниях, и рекомендует, какие собрания можно пропустить или поручить кому-нибудь другому (в зависимости от того, насколько их участники важны для вас).Subscribes to changes in your calendar, sends you an alert when you’re spending too much time in meetings, and provides recommendations for the ones you can miss or delegate based on how relevant the attendees are to you.
  • Помогает вам упорядочивать личные и рабочие данные на телефоне. Например, приложение может группировать изображения, предназначенные для личного хранилища OneDrive, и накладные, которые следует хранить в OneDrive для бизнеса.Helps you sort out personal and work information on your phone; for example, by categorizing pictures that should go to your personal OneDrive and business receipts that should go to your OneDrive for Business.
  • Анализирует масштабируемые данные Office 365, чтобы лица, принимающие решения, видели важные закономерности сотрудничества и распределения во времени, необходимые для повышения производительности работы.Analyzes at-scale Office 365 data so that decision makers can unlock valuable insights into time allocation and collaboration patterns that improve business productivity.
  • Вносит пользовательские бизнес-данные в Microsoft Graph и индексирует их для поиска наряду с данными из служб Microsoft 365.Brings custom business data into Microsoft Graph, indexing it to make it searchable along with data from Microsoft 365 services.

В качестве примера выберите первый сценарий поиска участников собрания.Pick the first scenario about researching meeting attendees as an example. С помощью API Microsoft Graph вы можете:With the Microsoft Graph API, you can:

  1. Получить адреса электронной почты участников собрания.Get the email addresses of the meeting event attendees.
  2. Просмотреть информацию о каждом из них как о пользователе в Azure Active Directory и получить сведения о профиле.Look them up individually as a user in Azure Active Directory to get their profile information.

С помощью связей вы можете перейти к другим ресурсам:You can then navigate to other resources using relationships:

Microsoft Graph продолжает открывать возможности платформы Microsoft 365 для разработчиков, но исключительно при наличии соответствующих разрешений.Microsoft Graph continues to open up the Microsoft 365 platform for developers, and always only with the appropriate permissions.

Примечание

Используя API Microsoft Graph, вы соглашаетесь с условиями использования API Microsoft и заявлением Майкрософт о конфиденциальности.Note: When you use the Microsoft Graph API, you agree to the Microsoft Graph Terms of Use and the Microsoft Privacy Statement.

Ознакомьтесь с некоторыми из популярных сценариев работы с API Microsoft Graph.Check out some of these common scenarios for working with the Microsoft Graph API. Ссылки ведут на песочницу Graph.The links take you to the Graph Explorer.

ОперацияOperation URL-адресURL
GET мой профильGET my profile https://graph.microsoft.com/v1.0/me
Получение своих файловGET my files https://graph.microsoft.com/v1.0/me/drive/root/children
Получение своей фотографииGET my photo https://graph.microsoft.com/v1.0/me/photo/$value
Получение своей почтыGET my mail https://graph.microsoft.com/v1.0/me/messages
GET моя почта высокой важностиGET my high importance email https://graph.microsoft.com/v1.0/me/messages?$filter=importance%20eq%20'high'
GET события в моем календареGET my calendar events https://graph.microsoft.com/v1.0/me/events
GET мой руководительGET my manager https://graph.microsoft.com/v1.0/me/manager
GET последний пользователь, изменивший файл foo.txtGET last user to modify file foo.txt https://graph.microsoft.com/v1.0/me/drive/root/children/foo.txt/lastModifiedByUser
GET группы Office 365, в которые я вхожуGET Office365 groups I’m member of https://graph.microsoft.com/v1.0/me/memberOf/$/microsoft.graph.group?$filter=groupTypes/any(a:a%20eq%20'unified')
GET пользователи в моей организацииGET users in my organization https://graph.microsoft.com/v1.0/users
GET группы в моей организацииGET groups in my organization https://graph.microsoft.com/v1.0/groups
GET пользователи, связанные со мнойGET people related to me https://graph.microsoft.com/v1.0/me/people
GET элементы, популярные в моей компанииGET items trending around me https://graph.microsoft.com/beta/me/insights/trending
GET мои заметкиGET my notes https://graph.microsoft.com/v1.0/me/onenote/notebooks

Доступ к масштабируемым данным Microsoft Graph с помощью подключения к даннымAccess Microsoft Graph data at scale using Microsoft Graph data connect

Подключение к данным Microsoft Graph предоставляет набор инструментов для масштабируемого доступа к данным в Microsoft Graph и в то же время позволяет администраторам регулировать согласие и полностью контролировать данные Microsoft Graph.Microsoft Graph data connect provides a set of tools to access data on Microsoft Graph at scale, while allowing administrators granular consent and full control over their Microsoft Graph data. Подключение к данным помогает оптимизировать их доставку в Microsoft Azure.Data connect streamlines the delivery of this data to Microsoft Azure.

С помощью средств Azure можно создавать интеллектуальные приложения с такими функциями:Using Azure tools, you can then build intelligent apps that:

  • Поиск ближайшего специалиста по вопросу в вашей организацииFind you the closest expert on a topic to you in your organization
  • Автоматизация создания базы знанийAutomate knowledge base creation
  • Анализ приглашений на собрания для предоставления статистики об использовании конференц-заловAnalyze meeting requests to provide insights into conference room utilization
  • Выявление мошенничества с данными производительности и взаимодействияDetect fraud with productivity and communication data

Когда следует использовать API Microsoft Graph или подключение к данным?When should I use Microsoft Graph API or data connect?

Подключение к данным Microsoft Graph обеспечивает новый способ взаимодействия с данными, доступными через API Microsoft Graph.Microsoft Graph data connect provides a new way for you to interact with the data that's available through Microsoft Graph APIs. Подключение к данным предоставляет уникальный набор инструментов, которые помогают оптимизировать создание интеллектуальных приложений в рамках облака Майкрософт.Data connect provides a unique set of tools that streamline the building of intelligent applications, all within the Microsoft cloud.

ФункцияFeature API Microsoft GraphMicrosoft Graph API Подключение к данным Microsoft GraphMicrosoft Graph data connect
Область доступаAccess scope Один пользователь или весь клиентSingle user or entire tenant Несколько пользователей или группMany users or groups
Шаблон доступаAccess pattern В режиме реального времениReal time Повторяющееся расписаниеRecurrent schedule
Операции с даннымиData operations Работает с оригиналом данныхOperates on data master Работает с кэшем данныхOperates on a cache of the data
Защита данныхData protection Данные защищены в пределах Microsoft 365Data is protected while in Microsoft 365 Защита данных распространяется на кэш данных в подписке AzureData protection is extended to the cache of data in your Azure subscription
Согласие пользователяUser consent СамостоятельноеSelf
Типы ресурсовResource types
НетNone
Согласие администратораAdmin consent Вся организацияEntire organization
Типы ресурсовResource types
Выбор групп пользователейSelect groups of users
Типов и свойства ресурсовResource types and properties
Исключает пользователейExcludes users
Средства доступаAccess tools Веб-запросы с применением RESTRESTful web queries Фабрика данных AzureAzure Data Factory

См. статью Подключение к данным Microsoft Graph, чтобы получить дополнительные сведения и приступить к работе с подключением к данным.See Microsoft Graph data connect for more information, and get started using Microsoft Graph data connect.

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