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

名前空間: microsoft.graphNamespace: microsoft.graph

Microsoft Graph の REST API は、webhook メカニズムを使用して、クライアントに変更通知を配信します。The Microsoft Graph REST API uses a webhook mechanism to deliver change 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:

リソースResource サポートされるリソースのパスSupported resource paths 通知には、リソース データを含めることができます。Resource data can be included in notifications
Outlook メッセージOutlook message ユーザーのメールボックス内のすべてのメッセージに対する変更:Changes to all messages in a user's mailbox:
/users/{id}/messages
ユーザーの受信トレイ内のメッセージに対する変更:Changes to messages in a user's Inbox:
/users/{id}/mailFolders('inbox')/messages
不要No
Outlook イベントOutlook event ユーザーのメールボックス内のすべてのイベントに対する変更:Changes to all events in a user's mailbox:
/users/{id}/events
不要No
Outlook 個人用連絡先Outlook personal contact ユーザーのメールボックス内のすべての個人用連絡先に対する変更:Changes to all personal contacts in a user's mailbox:
/users/{id}/contacts
不要No
ユーザーuser すべてのユーザーに対する変更:Changes to all users:
/users
特定のユーザーに対する変更:Changes to a specific user:
/users/{id}
不要No
グループgroup すべてのグループに対する変更:Changes to all groups:
/groups
特定のグループに対する変更:Changes to a specific group:
/groups/{id}
特定のグループの所有者を変更するChanges to owners of a specific group:
/groups/{id}/owners
特定のグループのメンバーを変更するChanges to members of a specific group:
/groups/{id}/members
いいえNo
Microsoft 365 グループ会話Microsoft 365 group conversation グループの会話に対する変更:Changes to a group's conversations:
groups/{id}/conversations
不要No
OneDrive (個人用) の driveItem driveItem on OneDrive (personal) _任意のフォルダー_の階層内のコンテンツに対する変更:Changes to content within the hierarchy of any folder:
/users/{id}/drive/root
不要No
OneDrive for Business の driveItemdriveItem on OneDrive for Business _ルート フォルダー_の階層内のコンテンツに対する変更:Changes to content within the hierarchy of the root folder:
/drives/{id}/root
/users/{id}/drive/root
不要No
SharePoint [サイト][]の[リスト][]list under a SharePoint site _リスト_内のコンテンツに対する変更:Changes to content within the list:
/sites/{id}/lists/{id}
不要No
セキュリティの警告Security alert 特定の警告に対する変更:Changes to a specific alert:
/security/alerts/{id}
フィルター処理された警告に対する変更:Changes to filtered alerts:
/security/alerts/?$filter
不要No
Teams callRecordTeams callRecord _すべて_の通話レコードを変更する: /communications/callRecordsChanges to all call records: /communications/callRecords いいえNo
Teams chatmessageTeams chatmessage すべてのチームのすべてのチャンネル内のチャット メッセージに対する変更:Changes to chat messages in all channels in all teams:
/teams/allMessages
特定のチャンネル内のチャット メッセージに対する変更:Changes to chat messages in a specific channel:
/teams/{id}/channels/{id}/messages
すべてのチャット内のチャット メッセージに対する変更:Changes to chat messages in all chats:
/chats/allMessages
特定のチャット内のチャット メッセージに対する変更:Changes to chat messages in a specific chat:
/chats/{id}/messages
必要Yes

: /users/{id} で始まるリソース パスでは、/me を受け入れて、サインインしているユーザーを参照することができます。Note: Any resource path that begins with /users/{id} can also accept /me to reference the signed-in user.

アクセス許可Permissions

一般に、サブスクリプション操作にはリソースへの読み取りアクセス許可が必要です。In general, subscription operations require read permission to the resource. たとえば、メッセージの通知を受信するには、アプリに Mail.Read アクセス許可が必要です。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. 次の一覧表に、アプリが特定のリソースの種類に対して Webhook を使用するために要求できるアクセス許可の種類を示します。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 警告連絡先会話driveItem、[リスト][]、イベントグループメッセージユーザーalert, contact, conversation, driveItem, list, event, group, message, user
委任 - 個人用の Microsoft アカウントDelegated - personal Microsoft account 連絡先driveItem、[リスト][]、イベントメッセージcontact, driveItem, list, event, message
アプリケーションApplication 警告連絡先、[リスト][]、driveItemイベントグループメッセージユーザーcallRecordalert, contact, list, driveItem, event, group, message, user, callRecord

関連項目See also