Получение уведомлений об изменениях с помощью API Microsoft Graph Use the Microsoft Graph API to get change notifications

REST API Microsoft Graph использует механизм веб-перехватчиков для доставки уведомлений об изменениях клиентам.The Microsoft Graph REST API uses a webhook mechanism to deliver change notifications to clients. Клиент — это веб-служба, которая настраивает свой URL-адрес для получения уведомлений.A client is a web service that configures its own URL to receive notifications. С помощью уведомлений клиентские приложения обновляют свое состояние при изменениях.Client apps use notifications to update their state upon changes. Дополнительные сведения, включая сведения о подписке и обработке входящих уведомлений, см. в статье Настройка уведомлений об изменениях в пользовательских данных.For more details, including how to subscribe to and handle incoming notifications, see Set up notifications for changes in user data.

С помощью API Microsoft Graph приложение может подписаться на изменения для следующих ресурсов:Using the Microsoft Graph API, an app can subscribe to changes on the following resources:

  • [Сообщение][] OutlookOutlook message
  • [Событие][] OutlookOutlook event
  • Личный [контакт][] OutlookOutlook personal contact
  • useruser
  • groupgroup
  • Групповой [чат][] Office 365 Office 365 group conversation
  • Контент внутри иерархии любой папки driveItem на персональном хранилище OneDrive пользователяContent within the hierarchy of any folder driveItem on a user's personal OneDrive
  • Контент внутри иерархии корневой папки driveItem на персональном хранилище OneDrive для бизнесаContent within the hierarchy of the root folder driveItem on OneDrive for Business
  • [Оповещение][] безопасностиSecurity alert

РазрешенияPermissions

В общем случае для операций с подписками необходимо разрешение на чтение ресурса. Например, чтобы получать уведомления для сообщений, приложению необходимо разрешение Mail.Read. В статье, посвященной созданию подписок, перечислены разрешения, необходимые для каждого типа ресурса. В таблице ниже перечислены типы разрешений, которые ваше приложение может запрашивать, чтобы использовать веб-перехватчики для определенных типов ресурсов.In general, subscription operations require read permission to the resource. For example, to get notifications for messages, your app needs the Mail.Read permission. The create subscription article lists permissions needed for each resource type. The following table lists the types of permissions your app can request to use webhooks for specific resource types.

Тип разрешенияPermission type Поддерживаемые типы ресурсовSupported resource types
Делегированное — рабочая или учебная учетная записьDelegated - work or school account alert, contact, conversation, driveItem, event, group, message, useralert, contact, conversation, driveItem, event, group, message, user
Делегированное — личная учетная запись МайкрософтDelegated - personal Microsoft account contact, driveItem, event, messagecontact, driveItem, event, message
Для приложенийApplication alert, contact, driveItem, event, group, message, useralert, contact, driveItem, event, group, message, user

См. такжеSee also