変更通知を使用して Microsoft グラフ API を取得するにはUse the Microsoft Graph API to get change notifications

Microsoft グラフ REST API では、webhook メカニズムを使用して、クライアントに通知を配信します。The Microsoft Graph REST API uses a webhook mechanism to deliver notifications to clients. クライアントは、通知を受信するのにはそれ自身の URL を構成する web サービスです。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.

Microsoft Graph の API を使用すると、アプリは次のリソースに変更を登録できます。Using the Microsoft Graph API, an app can subscribe to changes on the following resources:

  • メッセージMessages
  • イベントEvents
  • 連絡先Contacts
  • ユーザーUsers
  • グループGroups
  • グループ会話Group conversations
  • SharePoint サイトに関連付けられているドライブを含む、OneDrive で共有されているコンテンツContent shared on OneDrive, including drives associated with SharePoint sites
  • ユーザーの個人用の OneDrive フォルダーUsers' personal OneDrive folders
  • セキュリティの警告Security alerts

PermissionsPermissions

一般に、サブスクリプション操作にはリソースへの読み取りアクセス許可が必要です。たとえば、メッセージの通知を受信するには、アプリに Mail.Read アクセス許可が必要です。記事「サブスクリプションを作成する」では、リソースの種類ごとに必要なアクセス許可がリストされています。次の表に、アプリが特定のリソースの種類に対して Webhook を使用するために要求できるアクセス許可の種類を示します。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 連絡先会話ドライブイベント、[グループ][]、[メッセージ][]、[ユーザー][]は、[警告][]contact, conversation, drive, event, group, message, user, alert
委任 - 個人用の Microsoft アカウントDelegated - personal Microsoft account [問い合わせて][]、ドライブイベント、[メッセージ][]contact, drive, event, message
アプリケーションApplication 連絡先会話ドライブイベント、[グループ][]、[メッセージ][]、[ユーザー][]は、[警告][]contact, conversation, drive, event, group, message, user, alert

関連項目See also