Microsoft Graph-API Änderungsbenachrichtigungen
Namespace: microsoft.graph
Die Microsoft Graph-REST-API kann Über verschiedene Endpunkte, einschließlich Webhooks, Event Hubs und Event Grid, Änderungsbenachrichtigungen an Clients senden. Informationen zum Abonnieren und Empfangen von Benachrichtigungen für Ihre Anwendung finden Sie unter Einrichten von Benachrichtigungen für Änderungen an Benutzerdaten.
Eine App kann Änderungen an den in der Tabelle aufgeführten Microsoft Graph-Ressourcen abonnieren.
Hinweis
Abonnements für Ressourcen, die mit einem Sternchen (*) gekennzeichnet sind, sind nur auf dem /beta Endpunkt verfügbar.
| Ressource | Unterstützte Ressourcenpfade | Begrenzungen |
|---|---|---|
| Drucken in der Cloud Drucker | Änderungen, wenn ein Druckauftrag heruntergeladen werden kann (jobFetchable-Ereignis): /print/printers/{id}/jobs |
- |
| Cloud-drucken printTaskDefinition | Änderungen, wenn sich ein gültiger Auftrag in der Warteschlange befindet (jobStarted-Ereignis): /print/printtaskdefinition/{id}/tasks |
- |
| driveItem in OneDrive (persönlich) | Änderungen am Inhalt innerhalb der Hierarchie eines beliebigen Ordners: /users/{id}/drive/root |
- |
| driveItem auf OneDrive für Geschäfts-, Schul- oder Unikonten | Änderungen am Inhalt innerhalb der Hierarchie des Stammordners: /drives/{id}/root , /users/{id}/drive/root |
- |
| 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 |
Maximale Abonnementkontingente: Wird für Azure AD B2C-Mandanten nicht unterstützt. ANMERKUNG: Das Erstellen und vorläufige Löschen von Gruppen löst auch den updatedchangeType aus. |
| Liste auf einer SharePoint-Website | Änderungen am Inhalt innerhalb der Liste: /sites/{site-id}/lists/{list-id} |
- |
| Microsoft 365-Gruppenunterhaltung | Änderungen an den Unterhaltungen einer Gruppe: groups/{id}/conversations |
- |
| Outlook-Nachricht | Änderungen an allen Nachrichten im Postfach eines Benutzers: /users/{id}/messages , /me/messages Änderungen an Nachrichten im Posteingang eines Benutzers: /users/{id}/mailFolders('inbox')/messages , /me/mailFolders('inbox')/messages |
Pro Postfach sind maximal 1.000 aktive Abonnements für alle Anwendungen zulässig. |
| Outlook-Ereignis | Änderungen an allen Ereignissen im Postfach eines Benutzers: /users/{id}/events , /me/events |
Pro Postfach sind maximal 1.000 aktive Abonnements für alle Anwendungen zulässig. |
| Persönlicher Outlook-Kontakt | Änderungen an allen persönlichen Kontakten im Postfach eines Benutzers: /users/{id}/contacts , /me/contacts |
Pro Postfach sind maximal 1.000 aktive Abonnements für alle Anwendungen zulässig. |
| Sicherheitswarnung | Änderungen an einer bestimmten Warnung: /security/alerts/{id} Änderungen an gefilterten Warnungen: /security/alerts/?$filter={parameters} |
Weitere Informationen finden Sie unter Sicherheits-API Warnungen. |
| Teams-Genehmigungen | Änderungen an allen Genehmigungen in einem Mandanten: /solutions/approval/approvalItems |
Maximale Abonnementkontingente: |
| Teams callRecord | Änderungen an allen Anrufeinträgen: /communications/callRecords Änderungen an gefilterten Anrufdatensätzen: /communications/callRecords?$filter={parameters} |
Weitere Informationen finden Sie unter Änderungsbenachrichtigungen für Anrufdatensätze. Maximale Abonnementkontingente: ANMERKUNG: Die Erstellung von Aufrufdatensätzen löst auch den updatedchangeType aus. |
| Teams-AnrufAufzeichnung | Alle Aufzeichnungen in einem organization:communications/onlineMeetings/getAllRecordings Alle Aufzeichnungen für eine bestimmte Besprechung: communications/onlineMeetings/{onlineMeetingId}/recordings Eine Anrufaufzeichnung, die in einer Besprechung verfügbar wird, die von einem bestimmten Benutzer organisiert wird: users/{id}/onlineMeetings/getAllRecordings Eine Anrufaufzeichnung, die in einer Besprechung verfügbar wird, in der eine bestimmte Teams-App installiert ist: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings * |
Maximale Abonnementkontingente: |
| Teams callTranscript | Alle Transkripte in einem organization:communications/onlineMeetings/getAllTranscripts Alle Transkripte für eine bestimmte Besprechung: communications/onlineMeetings/{onlineMeetingId}/transcripts Ein Anruftranskript, das in einer Besprechung verfügbar wird, die von einem bestimmten Benutzer organisiert wird: users/{id}/onlineMeetings/getAllTranscripts Ein Anruftranskript, das in einer Besprechung verfügbar wird, in der eine bestimmte Teams-App installiert ist: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts * |
Maximale Abonnementkontingente: |
| Teams Chat | Änderungen an chatten im Mandanten: /chats Änderungen an einem bestimmten Chat: /chats/{id} Änderungen an einem bestimmten Chat mit dem Abfrageparameter notifyOnUserSpecificProperties : /chats/{id}?notifyOnUserSpecificProperties={Boolean} Änderungen an allen Chats in einem organization, in dem eine bestimmte Teams-App installiert ist: /appCatalogs/teamsApps/{id}/installedToChats Änderungen an allen Chats, zu denen ein bestimmter Benutzer gehört: /users/{id}/chats Änderungen an allen Chats, an denen ein bestimmter Benutzer teil ist, mit dem Abfrageparameter notifyOnUserSpecificProperties : /users/{id}/chats?notifyOnUserSpecificProperties={Boolean} |
Maximale Abonnementkontingente: |
| Teams chatMessage | Änderungen an Chatnachrichten in allen Kanälen in allen 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, zu der ein bestimmter Benutzer gehört: /users/{id}/chats/getAllMessages Änderungen an Chatnachrichten für alle Chats in einem organization, in dem eine bestimmte Teams-App installiert ist: /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages |
Maximale Abonnementkontingente: |
| Teams channel | Änderungen an Kanälen in allen Teams: /teams/getAllChannels Änderungen am Kanal in einem bestimmten Team: /teams/{id}/channels |
Maximale Abonnementkontingente: |
| Teams conversationMember | Änderungen an der Mitgliedschaft in einem bestimmten Team: /teams/{id}/members Änderungen an der Mitgliedschaft 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 für alle Chats in einem organization, in dem eine bestimmte Teams-App installiert ist: /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers Änderungen an der Mitgliedschaft in allen Chats: /chats/getAllMembers |
Maximale Abonnementkontingente: |
| Teams onlineMeeting* | Änderungen an einer Onlinebesprechung: /communications/onlineMeetings(joinWebUrl='{encodedJoinWebUrl}')/meetingCallEvents |
Unterstützt nicht die Verwendung von $select , um nur ausgewählte Eigenschaften zurückzugeben. Die rich-Benachrichtigung besteht aus allen Eigenschaften des geänderten instance. Pro Anwendung und Onlinebesprechung ist ein Abonnement zulässig. Weitere Informationen finden Sie unter Abrufen von Änderungsbenachrichtigungen für Aktualisierungen von Microsoft Teams-Besprechungsanrufereignissen. |
| Teams-Anwesenheit | Änderungen an der Anwesenheit eines einzelnen Benutzers: /communications/presences/{id} Änderungen an der Anwesenheit mehrerer Benutzer: /communications/presences?$filter=id in ({id},{id}...) |
Das Abonnement für die Anwesenheit mehrerer Benutzer ist auf 650 verschiedene Benutzer beschränkt. Unterstützt nicht die Verwendung von $select , um nur ausgewählte Eigenschaften zurückzugeben. Die rich-Benachrichtigung besteht aus allen Eigenschaften des geänderten instance. Pro Anwendung und delegiertem Benutzer ist ein Abonnement zulässig. Weitere Informationen finden Sie unter Abrufen von Änderungsbenachrichtigungen für Anwesenheitsupdates in Microsoft Teams. |
| Teams team | Änderungen an einem Team im Mandanten: /teams Änderungen an einem bestimmten Team: /teams/{id} |
Maximale Abonnementkontingente: |
| Angebot "Teams-Schichten" ShiftRequest | Änderungen an einer Angebotsverschiebungsanforderung in einem Team: /teams/{id}/schedule/offerShiftRequests |
Maximale Abonnementkontingente: |
| Teams Schichten openShiftChangeRequest | Änderungen an allen offenen Schichtanforderungen in einem Team: /teams/{id}/schedule/openShiftChangeRequests |
Maximale Abonnementkontingente: |
| Schichten in Teams | Änderungen an einer Schicht in einem Team: /teams/{id}/schedule/shifts |
Maximale Abonnementkontingente: |
| Teams Schichten swapShiftsChangeRequest | Änderungen an einer Verschiebungsanforderung in einem Team: /teams/{id}/schedule/swapShiftsChangeRequests |
Maximale Abonnementkontingente: |
| Teams verschiebt timeOffRequest | Änderungen an einer Anforderung für eine ausserplanende Zeit in einem Team: /teams/{id}/schedule/timeOffRequests |
Maximale Abonnementkontingente: |
| todoTask | Änderungen an allen Vorgängen in einer bestimmten Aufgabenliste: /me/todo/lists/{todoTaskListId}/tasks |
- |
| user | Änderungen an allen Benutzern: /users Änderungen an einem bestimmten Benutzer: /users/{id} |
Maximale Abonnementkontingente: Wird für persönliche Microsoft-Konten wie outlook.com nicht unterstützt. Wird für Azure AD B2C-Mandanten nicht unterstützt. ANMERKUNG: Das Erstellen und vorläufige Löschen von Benutzern löst auch den updatedchangeType aus. |
Hinweis
Für viele Ressourcen gelten Grenzwerte oder Kontingente für die Anzahl der Abonnements, die für diese Ressource erstellt werden können. Wenn dieser Grenzwert überschritten wird, führen Versuche, ein Abonnement zu erstellen, zu einer 403 Forbidden Fehlerantwort. Die Meldungseigenschaft der Fehlerantwort erklärt den Grenzwert, der überschritten wurde.
Einige dieser Ressourcen unterstützen umfangreiche Benachrichtigungen (Benachrichtigungen mit Ressourcendaten). Weitere Informationen zu Ressourcen, die umfangreiche Benachrichtigungen unterstützen, finden Sie unter Einrichten von Änderungsbenachrichtigungen, die Ressourcendaten enthalten.
Hinweis: Jeder Ressourcenpfad, der mit
/users/{id}beginnt, kann auch/meannehmen, 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, callRecording, callTranscript, channel, contact, conversation, conversationMember, driveItem, event, group, list, message, offerShiftRequest, openShiftChangeRequest, shift, swapShiftsChangeRequest, team, timeOffRequest, todoTask, user |
| Delegiert – persönliches Microsoft-Konto | contact, driveItem, event, list, message, todoTask |
| Anwendung | alert, callRecord, callRecording, callTranscript, channel, chatMessage, contact, conversationMember, driveItem, event, group, list, message, offerShiftRequest, openShiftChangeRequest, printer, printTaskDefinition, shift, swapShiftsChangeRequest, team, timeOffRequest, Benutzer |