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

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Achtung

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

Die Microsoft Graph-REST-API kann Änderungsbenachrichtigungen über verschiedene Endpunkte an Clients übermitteln, einschließlich Webhooks, Event Hubs und Event Grid. Informationen zum Abonnieren und Empfangen von Benachrichtigungen für Ihre Anwendung finden Sie unter Einrichten von Benachrichtigungen für Änderungen in Benutzerdaten.

Eine App kann Änderungen an den in der Tabelle aufgeführten Microsoft Graph-Ressourcen abonnieren. Abonnements für Ressourcen, die mit einem Sternchen (*) gekennzeichnet sind, sind nur auf dem /beta Endpunkt verfügbar.

Hinweis

Für Microsoft Teams-Ressourcen wird das Limit pro organization von 10.000 Abonnements insgesamt kumulativ für alle Microsoft Teams-Änderungsbenachrichtigungsabonnements im Mandanten freigegeben. Darin enthalten sind Abonnements, die für verschiedene Teams-Ressourcen erstellt wurden, z. B. Chats, Chatnachrichten, Anruftranskripte, Anrufaufzeichnungen, Kanäle, Teams und Unterhaltungsteilnehmer, die alle auf dasselbe Organisationskontingent angerechnet werden. Wenn die kombinierte Anzahl aktiver Teams-Abonnements dieses Limit erreicht, schlägt jede zusätzliche Anforderung zur Abonnementerstellung für eine Teams-Ressource mit einem 403 Forbidden Fehler fehl.

Ressource Unterstützte Ressourcenpfade Begrenzungen
Drucken in der Cloud Drucker Änderungen, wenn ein Druckauftrag zum Download bereit ist (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 -
Copilot aiInsights Copilot KI-Erkenntnisse aus Besprechungen, an denen ein bestimmter Benutzer beteiligt ist: /copilot/users/{userId}/onlineMeetings/getAllAiInsights

Copilot KI-Erkenntnisse für eine bestimmte Besprechung: /copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights		 Maximale Abonnementkontingente für KI Insights in allen Besprechungen für einen Benutzer:
  • Pro App und Benutzerkombination: 1
  • Pro Benutzer (delegiert): 10
  • Pro organization: 10.000 Abonnements insgesamt.


Maximale Abonnementkontingente für KI Insights einer bestimmten Besprechung:
  • Pro App und Benutzer + Besprechungskombination: 1
  • Pro Benutzer- und Besprechungskombination (delegiert): 1
  • Pro organization: 10.000 Abonnements insgesamt (freigegeben)
Copilot aiInteraction Copilot KI-Interaktionen, an denen ein bestimmter Benutzer beteiligt ist: copilot/users/{userId}/interactionHistory/getAllEnterpriseInteractions

Copilot KI-Interaktionen in einer organization:copilot/interactionHistory/getAllEnterpriseInteractions		 Maximale Abonnementkontingente:
  • Kombination aus App und Mandant (für Abonnements, die KI-Interaktionen in einem Mandanten nachverfolgen): 1
  • Pro App und Benutzerkombination (für Abonnements, die KI-Interaktionen nachverfolgen, an denen ein bestimmter Benutzer beteiligt ist): 1
  • Pro Benutzer (für Abonnements, die KI-Interaktionen nachverfolgen, an denen ein bestimmter Benutzer beteiligt ist): 10 Abonnements.
  • Pro organization: 10.000 Abonnements insgesamt.
driveItem in OneDrive (persönlich) Änderungen an Inhalten in der Hierarchie eines beliebigen Ordners: /users/{id}/drive/root -
driveItem auf OneDrive für den Arbeitsplatz oder die Schule/Universität Änderungen an Inhalten in 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:
  • Pro App (für alle Mandanten zusammen): 50.000 Abonnements insgesamt.
  • Pro Mandant (für alle Anwendungen zusammen): 1.000 Gesamtabonnements für alle Apps.
  • Kombination aus App und Mandant: 100 Abonnements insgesamt.


Nicht unterstützt für Azure AD B2C-Mandanten.

HINWEIS: Das Erstellen und vorläufige Löschen von Gruppen löst ebenfalls den updatedchangeType aus.
Microsoft Entra Health Monitoring-Warnung Änderungen an allen Systemüberwachungswarnungen: /reports/healthmonitoring/alerts

Änderungen an einem bestimmten Warnungstyp: /reports/healthmonitoring/alert wobei die Eigenschaft in der notificationQueryOptions Anforderungsnutzlast als $filter=alertType eq '{alertType}'		 -
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		 Maximal sind 1.000 aktive Abonnements pro Postfach für alle Anwendungen zulässig.
Outlook-Ereignis Änderungen an allen Ereignissen im Postfach eines Benutzers: /users/{id}/events , /me/events Maximal sind 1.000 aktive Abonnements pro Postfach 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 Maximal sind 1.000 aktive Abonnements pro Postfach 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.
Microsoft Teams-Genehmigungen Änderungen an allen Genehmigungen in einem Mandanten: /solutions/approval/approvalItems Maximale Abonnementkontingente:
  • Pro Mandant (für alle Anwendungen kombiniert): 1000 Abonnements insgesamt über alle Apps hinweg
  • Pro App- und Mandantenkombination: 1 Abonnement.
Teams callRecord Änderungen an allen Anrufeinträgen: /communications/callRecords

Änderungen an gefilterten Anrufdatensätzen: /communications/callRecords?$filter={parameters}		 Weitere Informationen finden Sie unter Ändern von Benachrichtigungen für Anrufdatensätze.

Maximale Abonnementkontingente:
  • Pro organization: 100 Abonnements insgesamt.


HINWEIS: Das Anlegen von Anrufdatensätzen löst auch den updatedchangeType aus.
Teams-AnrufAufzeichnung Alle Aufzeichnungen in einer organization:communications/onlineMeetings/getAllRecordings

Alle Aufzeichnungen für eine bestimmte Besprechung: communications/onlineMeetings/{onlineMeetingId}/recordings

Eine Anrufaufzeichnung, die in einer von einem bestimmten Benutzer organisierten Besprechung verfügbar 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:
  • Pro App und Kombination aus Onlinebesprechungen: 1
  • Pro App und Benutzerkombination: 1
  • Pro Benutzer (für Abonnements, die Aufzeichnungen in allen vom Benutzer organisierten onlineMeetings nachverfolgen): 10 Abonnements.
  • Pro organization: 10.000 Abonnements insgesamt.
Teams callTranscript Alle Transkripte in einer organization:communications/onlineMeetings/getAllTranscripts

Alle Transkripte für eine bestimmte Besprechung: communications/onlineMeetings/{onlineMeetingId}/transcripts

Ein Anruftranskript, das in einer von einem bestimmten Benutzer organisierten Besprechung verfügbar 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:
  • Pro App und Kombination aus Onlinebesprechungen: 1
  • Pro App und Benutzerkombination: 1
  • Pro Benutzer (für Abonnements, die Transkripte in allen vom Benutzer organisierten OnlineMeetings nachverfolgen): 10 Abonnements.
  • Pro organization: 10.000 Abonnements insgesamt.
Teams Chat Änderungen an jedem Chat 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 einer organization, in der eine bestimmte Teams-App installiert ist:/appCatalogs/teamsApps/{id}/installedToChats

Änderungen an allen Chats, an denen ein bestimmter Benutzer beteiligt ist: /users/{id}/chats

Änderungen an allen Chats, an denen ein bestimmter Benutzer beteiligt ist, mit dem Abfrageparameter notifyOnUserSpecificProperties : /users/{id}/chats?notifyOnUserSpecificProperties={Boolean}		 Maximale Abonnementkontingente:
  • Pro App- und Chat-Kombination: 1 Abonnement.
  • Pro organization: 10.000 Abonnements insgesamt.
  • Pro Benutzer (für Abonnements, die alle Chats nachverfolgen, an denen ein bestimmter Benutzer beteiligt ist): 10 Abonnements.
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, an denen ein bestimmter Benutzer beteiligt ist: /users/{id}/chats/getAllMessages

Änderungen an Chatnachrichten für alle Chats in einer organization, in der eine bestimmte Teams-App installiert ist:/appCatalogs/teamsApps/{id}/installedToChats/getAllMessages		 Maximale Abonnementkontingente:
  • Pro App und Kanal- oder Chatkombination: 1 Abonnement.
  • Pro Benutzer (für Abonnements, die Chatnachrichten in allen Chats nachverfolgen, an denen der Benutzer beteiligt ist): 10 Abonnements.
  • Pro organization: 10.000 Abonnements insgesamt.
Teams channel Änderungen an Kanälen in allen Teams: /teams/getAllChannels

Änderungen am Kanal in einem bestimmten Team: /teams/{id}/channels		 Maximale Abonnementkontingente:
  • Pro App- und Teamkombination: 1 Abonnement.
  • Pro organization: 10.000 Abonnements insgesamt.
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 einer organization, in der eine bestimmte Teams-App installiert ist:/appCatalogs/teamsApps/{id}/installedToChats/getAllMembers

Änderungen an der Mitgliedschaft in allen Chats: /chats/getAllMembers		 Maximale Abonnementkontingente:
  • Pro App- und Teamkombination: 1 Abonnement.
  • Pro organization: 10.000 Abonnements insgesamt.
Teams onlineMeeting* Änderungen an einer Onlinebesprechung: /communications/onlineMeetings(joinWebUrl='{encodedJoinWebUrl}')/meetingCallEvents Unterstützt die Verwendung $select nicht, um nur ausgewählte Eigenschaften zurückzugeben. Die umfassende Benachrichtigung enthält alle Eigenschaften der geänderten Instance. Pro Anwendung und Onlinebesprechung ein Abonnement zulässig. Weitere Informationen finden Sie unter Abrufen von Änderungsbenachrichtigungen für Aktualisierungen von Microsoft Teams-Besprechungsterminen.
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 die Verwendung $select nicht, um nur ausgewählte Eigenschaften zurückzugeben. Die umfassende Benachrichtigung enthält alle Eigenschaften der 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 jedem Team im Mandanten: /teams

Änderungen an einem bestimmten Team: /teams/{id}		 Maximale Abonnementkontingente:
  • Pro App- und Teamkombination: 1 Abonnement.
  • Pro organization: 10.000 Abonnements insgesamt.
Teams Schichten AngebotShiftRequest Änderungen an einer Angebotsschichtanfrage in einem Team: /teams/{id}/schedule/offerShiftRequests Maximale Abonnementkontingente:
  • Kombination aus App und Ressourcenpfad: 1 Abonnement pro Mandant.
  • Pro Ressourcenpfad und Benutzerkombination: 10 delegierte Benutzerabonnements pro Mandant.
Teams Schichten openShiftChangeRequest Änderungen an einer offenen Schichtanfrage in einem Team: /teams/{id}/schedule/openShiftChangeRequests Maximale Abonnementkontingente:
  • Kombination aus App und Ressourcenpfad: 1 Abonnement pro Mandant.
  • Kombination aus Benutzer und Ressourcenpfad: 10 Abonnements
  • Pro organization: 10.000 Abonnements insgesamt.
Microsoft Teams-Schichten schichtet Änderungen an einer Schicht in einem Team: /teams/{id}/schedule/shifts Maximale Abonnementkontingente:
  • Kombination aus App und Ressourcenpfad: 1 Abonnement pro Mandant.
  • Kombination aus Benutzer und Ressourcenpfad: 10 Abonnements
  • Pro organization: 10.000 Abonnements insgesamt.
Teams Schichten swapShiftsChangeRequest Änderungen an einer Schichttauschanfrage in einem Team: /teams/{id}/schedule/swapShiftsChangeRequests Maximale Abonnementkontingente:
  • Kombination aus App und Ressourcenpfad: 1 Abonnement pro Mandant.
  • Kombination aus Benutzer und Ressourcenpfad: 10 Abonnements
  • Pro organization: 10.000 Abonnements insgesamt.
Teams Schichten timeOffRequest Änderungen an jedem Abwesenheitsantrag in einem Team: /teams/{id}/schedule/timeOffRequests Maximale Abonnementkontingente:
  • Kombination aus App und Ressourcenpfad: 1 Abonnement pro Mandant.
  • Kombination aus Benutzer und Ressourcenpfad: 10 Abonnements
  • Pro organization: 10.000 Abonnements insgesamt.
todoTask Änderungen an allen Aufgaben in einer bestimmten Aufgabenliste: /me/todo/lists/{todoTaskListId}/tasks -
user Änderungen für alle Benutzer: /users

Änderungen an einem bestimmten Benutzer: /users/{id}		 Maximale Abonnementkontingente:
  • Pro App (für alle Mandanten zusammen): 50.000 Abonnements insgesamt.
  • Pro Mandant (für alle Anwendungen kombiniert): 1.000 Abonnements für alle Apps insgesamt
  • Kombination aus App und Mandant: 100 Abonnements insgesamt.


Wird für persönliche Microsoft-Konten wie outlook.com nicht unterstützt.

Nicht unterstützt für Azure AD B2C-Mandanten.

HINWEIS: Das Erstellen und vorläufige Löschen von Benutzern löst ebenfalls den updatedchangeType aus.

Hinweis

Viele Ressourcen weisen Grenzwerte oder Kontingente auf, wie viele Abonnements für diese Ressource erstellt werden können. Wenn dieses Limit überschritten wird, führen Versuche, ein Abonnement zu erstellen, zu einer 403 Forbidden Fehlerantwort. Die message-Eigenschaft der Fehlerantwort erklärt, welcher Grenzwert überschritten wurde.

Einige dieser Ressourcen unterstützen umfassende Benachrichtigungen (Benachrichtigungen mit Ressourcendaten). Weitere Informationen finden Sie unter Einrichten von Änderungsbenachrichtigungen, die Ressourcendaten enthalten.

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 aiInsights, aiInteraction, Warnung, callRecording, callTranscript, Kanal, Chat, ChatMessage (Vorschau), Kontakt, Konversation, conversationMember, driveItem, Ereignis, Gruppe, Liste, Nachricht, offerShiftRequest, openShiftChangeRequest, Anwesenheit, Schicht, swapShiftsChangeRequest, team, timeOffRequest, todoTask, user, baseTask (veraltet)
Delegiert – persönliches Microsoft-Konto contact, driveItem, event, list, message, todoTask, baseTask (veraltet)
Application aiInsights, aiInteraction, Warnung, callRecord, Genehmigungen, callRecording, callTranscript, Kanal, Chat, ChatMessage, Kontakt, conversationMember, driveItem, Ereignis, Gruppe, Liste, Nachricht, offerShiftRequest, onlineMeeting, openShiftChangeRequest, Drucker, printTaskDefinition, shift, swapShiftsChangeRequest, team, timeOffRequest, Benutzer

Verwandte Inhalte

  • Last updated on