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

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 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:

  • Outlook-[Nachricht][]Outlook message
  • Outlook-[Ereignis][]Outlook event
  • Persönlicher Outlook-[Kontakt][]Outlook personal contact
  • [Benutzer][]user
  • [Gruppe][]group
  • Office 365-[Gruppenunterhaltung][]Office 365 group conversation
  • Inhalt in der Hierarchie des driveItem-Objekts eines beliebigen Ordners auf dem persönlichen OneDrive eines BenutzersContent within the hierarchy of any folder driveItem on a user's personal OneDrive
  • Inhalt in der Hierarchie des driveItem-Objekts eines Stammordners auf OneDrive for BusinessContent within the hierarchy of the root folder driveItem on OneDrive for Business
  • [Sicherheitswarnung][]Security alert

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 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, event, group, message, useralert, contact, conversation, driveItem, event, group, message, user
Delegiert – persönliches Microsoft-KontoDelegated - personal Microsoft account contact, driveItem, event, messagecontact, driveItem, event, message
AnwendungApplication alert, contact, driveItem, event, group, message, useralert, contact, driveItem, event, group, message, user

Siehe auchSee also