Verwenden der Microsoft Graph-API zum Abrufen Benachrichtigungen ändernUse the Microsoft Graph API to get change notifications

Die Microsoft Graph-REST-API verwendet einen Webhook Mechanismus zum Übermitteln von Benachrichtigungen an Clients.The Microsoft Graph REST API uses a webhook mechanism to deliver notifications to clients. Ein Client ist ein Webdienst, der den eigenen URL Erhalt von Benachrichtigungen konfiguriert.A client is a web service that configures its own URL to receive notifications. Client-apps verwenden Benachrichtigungen, um deren Status nach Änderungen zu aktualisieren.Client apps use notifications to update their state upon changes. Weitere Informationen zum Abonnieren und behandeln eingehende Benachrichtigungen finden Sie unter Einrichten von Benachrichtigungen, damit die Änderungen in Benutzerdaten, einschließlich.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:

  • NachrichtenMessages
  • EreignisseEvents
  • KontakteContacts
  • BenutzerUsers
  • GruppenGroups
  • GruppenunterhaltungenGroup conversations
  • OneDrive, einschließlich SharePoint-Websites zugeordneten Laufwerke freigegebenen InhaltContent shared on OneDrive, including drives associated with SharePoint sites
  • Persönliche OneDrive-Ordner von BenutzernUsers' personal OneDrive folders
  • SicherheitshinweiseSecurity alerts

BerechtigungenPermissions

In der Regel sind für Abonnementvorgänge Leseberechtigungen für die Ressource erforderlich. Beispiel: um Benachrichtigungen zu Nachrichten zu erhalten, benötigt Ihre App die Mail.Read-Berechtigung. Unter Abonnement erstellen werden die Berechtigungen aufgeführt, die für den jeweiligen Ressourcentyp erforderlich sind. Die folgende Tabelle enthält die Typen von Berechtigungen, die Ihre App für die Verwendung von Webhooks für bestimmte Ressourcentypen anfordern kann.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.

BerechtigungstypPermission type Unterstützten RessourcentypenSupported resource types
Delegiert – Geschäfts-, Schul- oder UnikontoDelegated - work or school account [wenden Sie sich an][], Unterhaltung, Laufwerk, Ereignis, [Gruppe][], [Nachricht][], Benutzer, Benachrichtigungcontact, conversation, drive, event, group, message, user, alert
Delegiert – persönliches Microsoft-KontoDelegated - personal Microsoft account [wenden Sie sich an][], Laufwerk, Ereignis, [Nachricht][]contact, drive, event, message
AnwendungApplication [wenden Sie sich an][], Unterhaltung, Laufwerk, Ereignis, [Gruppe][], [Nachricht][], Benutzer, Benachrichtigungcontact, conversation, drive, event, group, message, user, alert

Siehe auchSee also