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

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Achtung

Vorhandene Apps, die dieses Feature mit baseTask oder baseTaskList verwenden, sollten aktualisiert werden, da der auf diesen Ressourcen basierende Aufgaben-API-Satz ab dem 31. Mai 2022 veraltet ist. Dieser API-Satz wird ab dem 31. August 2022 keine Daten mehr zurückgeben. Verwenden Sie den API-Satz, der auf todoTask basiert.

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 for Business Änderungen des Inhalts innerhalb der Hierarchie des Stammordners:
/drives/{id}/root
/users/{id}/drive/root
Nein
driveItem in OneDrive (persönlich) Änderungen des Inhalts innerhalb der Hierarchie eines beliebigen Ordners:
/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][] /sites/{id}/lists/{id} Nein
Microsoft 365-Gruppen-[Unterhaltung][] Änderungen an den Unterhaltungen einer Gruppe:
groups/{id}/conversations
Nein
Outlook-[Ereignis][] Änderungen an allen Ereignissen im Postfach eines Benutzers:
/users/{id}/events
Ja
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
Ja
Persönlicher Outlook-Kontakt Änderungen an allen persönlichen Kontakten im Postfach eines Benutzers:
/users/{id}/contacts
Ja
[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 channel Änderungen an Kanälen in allen Teams:
/teams/getAllChannels
Änderungen am Kanal in einem bestimmten Team:
/teams/{id}/channels
Ja
Teams Chat Änderungen an allen Chats im Mandanten:
/chats
Änderungen an einem bestimmten Chat:
/chats/{id}
Ja
Teams-[Chatnachricht][] Ä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 conversationMember Änderungen an der Mitgliedschaft in einem bestimmten Team:
/teams/{id}/members
Änderungen an der Mitgliedschaft in einem bestimmten Chat:
/chats/{id}/members
Änderungen an der Mitgliedschaft in allen Chats:
/chats/getAllMembers
Neue oder geänderte Mitglieder in allen Kanälen unter einem bestimmten Team:
teams/{id}/channels/getAllMembers
Ja
Teams onlineMeeting Änderungen an einer Onlinebesprechung:
/communications/onlineMeetings/?$filter=JoinWebUrl eq {joinWebUrl}
Ja
Teams-[Anwesenheit][] Änderungen an der Anwesenheit eines einzelnen Benutzers: /communications/presences/{id}
Änderungen an mehreren Benutzerpräsenzen:
/communications/presences?$filter=id in ({id},{id}...)
Ja
Teams team Änderungen an allen Teams im Mandanten:
/teams
Änderungen an einem bestimmten Team:
/teams/{id}
Ja
To Do baseTask (veraltet) Änderungen an allen Aufgaben in einer bestimmten Aufgabenliste:
/me/tasks/lists/{baseTaskListId}/tasks
Änderungen an allen Aufgaben:
/me/tasks/lists/alltasks
Nein
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, baseTask (veraltet), [Kanal][], Chat, Kontakt, [Unterhaltung][], conversationMember, driveItem, list, event, group, message, user, presence, chatMessage (vorschau), team, todoTask
Delegiert – persönliches Microsoft-Konto baseTask (veraltet), [contact][], driveItem, list, event, message, todoTask
Anwendung alert, channel, chat, [contact][], driveItem, list, event, group, message, user, callRecord, chatMessage, conversationMember, onlinemeeting, [printer][], printTaskDefinition, team

Siehe auch