Обзор Microsoft GraphOverview of Microsoft Graph

Microsoft Graph открывает доступ к данным и средствам искусственного интеллекта в Microsoft 365.Microsoft Graph is the gateway to data and intelligence in Microsoft 365. С помощью единой модели программируемости Microsoft Graph можно работать с колоссальным объемом данных в Office 365, Enterprise Mobility + Security и Windows 10.Microsoft Graph provides a unified programmability model that you can use to take advantage of the tremendous amount of data in Office 365, Enterprise Mobility + Security, and Windows 10.

Применяя API Microsoft Graph, можно создавать приложения для организаций и клиентов, которые работают с данными миллионов пользователей.You can use the Microsoft Graph API to build apps for organizations and consumers that interact with the data of millions of users. С помощью Microsoft Graph можно подключаться к различным ресурсам, отношениям и средствам искусственного интеллекта через одну конечную точку — https://graph.microsoft.com.With Microsoft Graph, you can connect to a wealth of resources, relationships, and intelligence, all through a single endpoint: https://graph.microsoft.com.

Содержимое GraphWhat's in the graph?

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

  • Azure Active DirectoryAzure Active Directory
  • служб Office 365 (SharePoint, OneDrive, Outlook, Exchange, Microsoft Teams, OneNote, Планировщика, Excel);Office 365 services: SharePoint, OneDrive, Outlook/Exchange, Microsoft Teams, OneNote, Planner, and Excel
  • служб Enterprise Mobility + Security (Identity Manager, Intune, Advanced Threat Analytics, Advanced Threat Protection);Enterprise Mobility and Security services: Identity Manager, Intune, Advanced Threat Analytics, and Advanced Threat Protection.
  • служб Windows 10 (действия и устройства);Windows 10 services: activities and devices
  • образовательных учреждений.Education

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

Microsoft Graph подключает все ресурсы в этих службах с помощью отношений.Microsoft Graph connects all the resources across these services using relationships. Например, отношением memberOf пользователь может быть связан с группой, а отношением manager — с другим пользователем.For example, a user can be connected to a group through a memberOf relationship, and to another user through a manager relationship. Приложение может просматривать эти отношения для доступа к этим связанным ресурсам и выполнения действий с ними через API.Your app can traverse these relationships to access these connected resources and perform actions on them through the API.

Вы также можете получать ценную статистику и оповещения о данных из Microsoft Graph.You can also get valuable insights and intelligence about the data from Microsoft Graph. Например, вы можете получить список файлов пользователя, с которыми он часто работает, или наиболее важных людей в его компании.For example, you can get the popular files trending around a particular user, or get the most relevant people around a user.

Узнайте о возможностях, которые открывают отношения в Microsoft Graph.Discover the possibilities in the relationships within Microsoft Graph.

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

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

С помощью Microsoft Graph можно создавать решения, которые работают в уникальном контексте пользователя, повышая эффективность его работы. Представьте приложение, которое...You can 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 who they work with, as well as information about the latest documents and projects they're working on.
  • Проверяет ваш календарь и предлагает оптимальное время для следующего собрания команды.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.

Все это и многое другое возможно с API Microsoft Graph.You can do all this and more with the Microsoft Graph API.

Примечание. Используя API Microsoft Graph, вы соглашаетесь с условиями использования Microsoft Graph и заявлением Майкрософт о конфиденциальности.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 at scale

Microsoft Graph Data Connect позволяет выполнять массовый (в отличие от традиционного транзакционного) доступ к данным Office 365.Microsoft Graph Data Connect enables bulk - rather than the traditional transactional - access to Office 365 data. При массовом доступе к данным Office 365 можно использовать средства Azure, чтобы создавать интеллектуальные приложения, которые обеспечивают выполнение следующих действий:With the bulk Office 365 data, you can use Azure tools to 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

Когда нужно использовать Microsoft Graph Data Connect?When should I use Microsoft Graph Data Connect?

Microsoft Graph Data Connect предоставляет новый способ взаимодействия с данными, доступными с помощью интерфейсов 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. Помимо обеспечения масштабируемого доступа к данным Office 365, Microsoft Graph также предоставляет уникальный набор возможностей для оптимизации создания интеллектуальных приложений в рамках облака Майкрософт.In addition to providing scalable access to Office 365 data, Microsoft Graph Data Connect also provides a unique set of capabilities that streamline the building of intelligent applications, all within the Microsoft cloud.

ФункцияFeature API Microsoft GraphMicrosoft Graph API Microsoft Graph Data ConnectMicrosoft 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 Data Connect см. в статье Microsoft Graph Data Connect.For more information about Microsoft Graph Data Connect, see Microsoft Graph Data Connect. Для начала работы ознакомьтесь со статьей Обзор Microsoft Graph Data Connect.To get started, see Overview of Microsoft Graph Data Connect.

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