Verwenden der Microsoft Graph-API, um Änderungsbenachrichtigungen zu erhaltenUse the Microsoft Graph API to get change notifications

Namespace: microsoft.graphNamespace: microsoft.graph

Die Microsoft Graph-REST-API verwendet einen Webhook-Mechanismus zum Übermitteln von Änderungsbenachrichtigungen an Clients.The Microsoft Graph REST API uses a webhook mechanism to deliver change notifications to clients. Ein Client ist ein Webdienst, der eine eigene URL zum Empfangen von Benachrichtigungen konfiguriert.A client is a web service that configures its own URL to receive notifications. Client-Apps verwenden Benachrichtigungen, um bei Änderungen ihren Status zu aktualisieren.Client apps use notifications to update their state upon changes. Weitere Informationen, einschließlich der Vorgehensweise zum Abonnieren und Behandeln eingehender Benachrichtigungen, finden Sie unter Einrichten von Benachrichtigungen für Änderungen an Benutzerdaten.For more details, including how to subscribe to and handle incoming notifications, see Set up notifications for changes in user data.

Mit der Microsoft Graph-API kann eine App Änderungen an den folgenden Ressourcen abonnieren:Using the Microsoft Graph API, an app can subscribe to changes on the following resources:

RessourceResource Unterstützte RessourcenpfadeSupported resource paths In Benachrichtigungen können Ressourcendaten einbezogen werdenResource data can be included in notifications
Outlook-[Nachricht][]Outlook message Änderungen an allen Nachrichten im Postfach eines Benutzers:Changes to all messages in a user's mailbox:
/users/{id}/messages
Änderungen an Nachrichten im Posteingang eines Benutzers:Changes to messages in a user's Inbox:
/users/{id}/mailFolders('inbox')/messages
NeinNo
Outlook-[Ereignis][]Outlook event Änderungen an allen Ereignissen im Postfach eines Benutzers:Changes to all events in a user's mailbox:
/users/{id}/events
NeinNo
Persönlicher Outlook-KontaktOutlook personal contact Änderungen an allen persönlichen Kontakten im Postfach eines Benutzers:Changes to all personal contacts in a user's mailbox:
/users/{id}/contacts
NeinNo
[Benutzer][]user Änderungen an allen Benutzern:Changes to all users:
/users
Änderungen an einem bestimmten Benutzer:Changes to a specific user:
/users/{id}
NeinNo
[Gruppe][]group Änderungen an allen Gruppen:Changes to all groups:
/groups
Änderungen an einer bestimmten Gruppe:Changes to a specific group:
/groups/{id}
Änderungen an Besitzern einer bestimmten Gruppe:Changes to owners of a specific group:
/groups/{id}/owners
Änderungen an Mitgliedern einer bestimmten Gruppe:Changes to members of a specific group:
/groups/{id}/members
NeinNo
Microsoft 365-Gruppen-[Unterhaltung][]Microsoft 365 group conversation Änderungen an den Unterhaltungen einer Gruppe:Changes to a group's conversations:
groups/{id}/conversations
NeinNo
driveItem in OneDrive (persönlich)driveItem on OneDrive (personal) Änderungen des Inhalts innerhalb der Hierarchie eines beliebigen Ordners:Changes to content within the hierarchy of any folder:
/users/{id}/drive/root
NeinNo
driveItem in OneDrive for BusinessdriveItem on OneDrive for Business Änderungen des Inhalts innerhalb der Hierarchie des Stammordners:Changes to content within the hierarchy of the root folder:
/drives/{id}/root
/users/{id}/drive/root
NeinNo
[Liste][] auf einer SharePoint-[Website][]list under a SharePoint site Änderungen am Inhalt in der Liste:Changes to content within the list:
/sites/{id}/lists/{id}
NeinNo
[Sicherheitswarnung][]Security alert Änderungen an einer bestimmten Warnung:Changes to a specific alert:
/security/alerts/{id}
Änderungen an gefilterten Warnungen:Changes to filtered alerts:
/security/alerts/?$filter
NeinNo
Teams callRecord Teams callRecord Änderungen an allen Anrufeinträgen: /communications/callRecordsChanges to all call records: /communications/callRecords NeinNo
Teams-[Chatnachricht][]Teams chatmessage Änderungen an Chatnachrichten in allen Kanälen aller Teams:Changes to chat messages in all channels in all teams:
/teams/getAllMessages
Änderungen an Chatnachrichten in einem bestimmten Kanal:Changes to chat messages in a specific channel:
/teams/{id}/channels/{id}/messages
Änderungen an Chatnachrichten in allen Chats:Changes to chat messages in all chats:
/chats/getAllMessages
Änderungen an Chatnachrichten in einem bestimmten Chat:Changes to chat messages in a specific chat:
/chats/{id}/messages
JaYes

Hinweis: Jeder Ressourcenpfad, der mit /users/{id} beginnt, kann auch /me annehmen, um auf den angemeldeten Benutzer zu verweisen.Note: Any resource path that begins with /users/{id} can also accept /me to reference the signed-in user.

BerechtigungenPermissions

In der Regel sind für Abonnementvorgänge Leseberechtigungen für die Ressource erforderlich.In general, subscription operations require read permission to the resource. Beispiel: um Benachrichtigungen zu Nachrichten zu erhalten, benötigt Ihre App die Mail.Read-Berechtigung.For example, to get notifications for messages, your app needs the Mail.Read permission. Unter Abonnement erstellen werden die Berechtigungen aufgeführt, die für den jeweiligen Ressourcentyp erforderlich sind.The create subscription article lists permissions needed for each resource type. Die folgende Tabelle enthält die Typen von Berechtigungen, die Ihre App für die Verwendung von Webhooks für bestimmte Ressourcentypen anfordern kann.The following table lists the types of permissions your app can request to use webhooks for specific resource types.

BerechtigungstypPermission type Unterstützte RessourcentypenSupported resource types
Delegiert – Geschäfts-, Schul- oder UnikontoDelegated - work or school account alert, contact, conversation, driveItem, list, event, group, message, useralert, contact, conversation, driveItem, list, event, group, message, user
Delegiert – persönliches Microsoft-KontoDelegated - personal Microsoft account contact, driveItem, list, event, messagecontact, driveItem, list, event, message
ApplicationApplication alert, contact, list, driveItem, event, group, message, user, callRecord, chatMessagealert, contact, list, driveItem, event, group, message, user, callRecord, chatMessage

Siehe auchSee also