Feedback Bearbeiten

Verwenden der Microsoft Graph-API, um Änderungsbenachrichtigungen zu erhalten

  • Artikel
  • 2 Minuten Lesedauer

Namespace: microsoft.graph

Die Microsoft Graph-REST-API verwendet einen Webhook-Mechanismus zum Übermitteln von Änderungsbenachrichtigungen an Clients. Ein Client ist ein Webdienst, der eine eigene URL zum Empfangen von Benachrichtigungen konfiguriert. Client-Apps verwenden Benachrichtigungen, um bei Änderungen ihren Status zu aktualisieren. Weitere Informationen, einschließlich der Vorgehensweise zum Abonnieren und Behandeln eingehender Benachrichtigungen, finden Sie unter Einrichten von Benachrichtigungen für Änderungen an Benutzerdaten.

Mit der Microsoft Graph-API kann eine App Änderungen an den folgenden Ressourcen abonnieren:

Ressource Unterstützte Ressourcenpfade In Benachrichtigungen können Ressourcendaten einbezogen werden
Drucken in der Cloud Drucker Änderungen, wenn ein Druckauftrag zum Herunterladen bereit ist (JobFetchable-Ereignis):
/print/printers/{id}/jobs		 Nein
Cloud-drucken printTaskDefinition Änderungen, wenn sich ein gültiger Job in der Warteschlange befindet (JobStarted-Ereignis) :
/print/printtaskdefinition/{id}/tasks		 Nein
driveItem in OneDrive (persönlich) Änderungen des Inhalts innerhalb der Hierarchie eines beliebigen Ordners:
/users/{id}/drive/root		 Nein
driveItem in OneDrive for Business Änderungen des Inhalts innerhalb der Hierarchie des Stammordners:
/drives/{id}/root
/users/{id}/drive/root		 Nein
[Gruppe][] Änderungen an allen Gruppen:
/groups
Änderungen an einer bestimmten Gruppe:
/groups/{id}
Änderungen an Besitzern einer bestimmten Gruppe:
/groups/{id}/owners
Änderungen an Mitgliedern einer bestimmten Gruppe:
/groups/{id}/members		 Nein
[Liste][] auf einer SharePoint-[Website][] Änderungen am Inhalt in der Liste:
/sites/{id}/lists/{id}		 Nein
Microsoft 365-Gruppen-[Unterhaltung][] Änderungen an den Unterhaltungen einer Gruppe:
groups/{id}/conversations		 Nein
Outlook-[Nachricht][] Änderungen an allen Nachrichten im Postfach eines Benutzers:
/users/{id}/messages
Änderungen an Nachrichten im Posteingang eines Benutzers:
/users/{id}/mailFolders('inbox')/messages		 Nein
Outlook-[Ereignis][] Änderungen an allen Ereignissen im Postfach eines Benutzers:
/users/{id}/events		 Nein
Persönlicher Outlook-Kontakt Änderungen an allen persönlichen Kontakten im Postfach eines Benutzers:
/users/{id}/contacts		 Nein
[Sicherheitswarnung][] Änderungen an einer bestimmten Warnung:
/security/alerts/{id}
Änderungen an gefilterten Warnungen:
/security/alerts/?$filter		 Nein
Teams callRecord Änderungen an allen Anrufeinträgen: /communications/callRecords Nein
Teams Chat Änderungen an allen Chats im Mandanten:
/chats
Änderungen an einem bestimmten Chat:
/chats/{id}		 Ja
Teams chatMessage Änderungen an Chatnachrichten in allen Kanälen aller Teams:
/teams/getAllMessages
Änderungen an Chatnachrichten in einem bestimmten Kanal:
/teams/{id}/channels/{id}/messages
Änderungen an Chatnachrichten in allen Chats:
/chats/getAllMessages
Änderungen an Chatnachrichten in einem bestimmten Chat:
/chats/{id}/messages
Änderungen an Chatnachrichten in allen Chats, an denen ein bestimmter Benutzer teilnimmt:
/users/{id}/chats/getAllMessages		 Ja
Teams channel Änderungen an Kanälen in allen Teams:
/teams/getAllChannels
Änderungen am Kanal in einem bestimmten Team:
/teams/{id}/channels		 Ja
Teams conversationMember Änderungen an der Mitgliedschaft in einem bestimmten Team:
/teams/{id}/members
Neue oder geänderte Mitglieder in allen Kanälen unter einem bestimmten Team:
teams/{id}/channels/getAllMembers
Änderungen an der Mitgliedschaft in einem bestimmten Chat:
/chats/{id}/members
Änderungen an der Mitgliedschaft in allen Chats:
/teams/getAllMembers		 Ja
Teams team Änderungen an allen Teams im Mandanten:
/teams
Änderungen an einem bestimmten Team:
/teams/{id}		 Ja
To-Do-Aufgabe Änderungen an allen Aufgaben in einer bestimmten Aufgabenliste:
/me/todo/lists/{todoTaskListId}/tasks		 Nein
[Benutzer][] Änderungen an allen Benutzern:
/users
Änderungen an einem bestimmten Benutzer:
/users/{id}		 Nein

Hinweis: Jeder Ressourcenpfad, der mit /users/{id} beginnt, kann auch /me annehmen, um auf den angemeldeten Benutzer zu verweisen.

Berechtigungen

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.

Berechtigungstyp Unterstützte Ressourcentypen
Delegiert – Geschäfts-, Schul- oder Unikonto alert, channel, [contact][], conversation, conversationMember, driveItem, event, group, list, message, team, todoTask, user
Delegiert – persönliches Microsoft-Konto [contact][], driveItem, event, list, message, todoTask
Anwendung alert, callRecord, channel, chatMessage, [contact][], conversationMember, driveItem, event, group, list, message, [printer][], printTaskDefinition, team, user

Siehe auch