Freigeben über

Microsoft Graph-API Änderungsbenachrichtigungen

  • Artikel

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:
  • Pro App (für alle Mandanten kombiniert): insgesamt 50.000 Abonnements.
  • Pro Mandant (für alle Anwendungen kombiniert): insgesamt 1.000 Abonnements für alle Apps.
  • Kombination aus App und Mandant: insgesamt 100 Abonnements.

    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:
  • Pro Mandant (für alle Anwendungen kombiniert): 1000 Abonnements insgesamt über alle Apps hinweg
  • Kombination pro App und Mandant: 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 Änderungsbenachrichtigungen für Anrufdatensätze.

    Maximale Abonnementkontingente:
  • Pro organization: insgesamt 100 Abonnements.

    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:
  • Kombination pro App und Onlinebesprechung: 1
  • Kombination pro App und Benutzer: 1
  • Pro Benutzer (für Abonnements, die Aufzeichnungen in allen onlineMeetings nachverfolgen, die vom Benutzer organisiert werden): 10 Abonnements.
  • Pro organization: insgesamt 10.000 Abonnements.
    		•
    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:
  • Kombination pro App und Onlinebesprechung: 1
  • Kombination pro App und Benutzer: 1
  • Pro Benutzer (für Abonnements, die Transkripte in allen vom Benutzer organisierten onlineMeetings nachverfolgen): 10 Abonnements.
  • Pro organization: insgesamt 10.000 Abonnements.
    		•
    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:
  • Kombination pro App und Chat: 1 Abonnement.
  • Pro organization: insgesamt 10.000 Abonnements.
  • Pro Benutzer (für Abonnements, die alle Chats nachverfolgen, zu denen ein bestimmter Benutzer gehört): 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, 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:
  • Kombination aus App und Kanal oder Chat: 1 Abonnement.
  • Pro Benutzer (für Abonnements, die Chatnachrichten in allen Chats nachverfolgen): 10 Abonnements.
  • Pro organization: insgesamt 10.000 Abonnements.
    		•
    Teams channel Änderungen an Kanälen in allen Teams: /teams/getAllChannels

    Änderungen am Kanal in einem bestimmten Team: /teams/{id}/channels    		 Maximale Abonnementkontingente:
  • Kombination pro App und Team: 1 Abonnement.
  • Pro organization: insgesamt 10.000 Abonnements.
    		•
    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:
  • Kombination pro App und Team: 1 Abonnement.
  • Pro organization: insgesamt 10.000 Abonnements.
    		•
    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:
  • Kombination pro App und Team: 1 Abonnement.
  • Pro organization: insgesamt 10.000 Abonnements.
    		•
    Angebot "Teams-Schichten" ShiftRequest Änderungen an einer Angebotsverschiebungsanforderung 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 allen offenen Schichtanforderungen 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: insgesamt 10.000 Abonnements.
    		•
    Schichten in Teams Ä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: insgesamt 10.000 Abonnements.
    		•
    Teams Schichten swapShiftsChangeRequest Änderungen an einer Verschiebungsanforderung 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: insgesamt 10.000 Abonnements.
    		•
    Teams verschiebt timeOffRequest Änderungen an einer Anforderung für eine ausserplanende Zeit 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: insgesamt 10.000 Abonnements.
    		•
    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:
  • Pro App (für alle Mandanten kombiniert): insgesamt 50.000 Abonnements.
  • Pro Mandant (für alle Anwendungen kombiniert): 1.000 Abonnements insgesamt für alle Apps
  • Kombination aus App und Mandant: insgesamt 100 Abonnements.

    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 /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, 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

    Verwandte Inhalte