Notifications de modification microsoft API Graph

  • Article

Espace de noms: microsoft.graph

L’API REST Microsoft Graph peut envoyer des notifications de modification aux clients via différents points de terminaison, notamment des webhooks, Event Hubs et Event Grid. Pour savoir comment s’abonner et recevoir des notifications pour votre application, consultez Configurer des notifications pour les modifications apportées aux données utilisateur.

Une application peut s’abonner aux modifications apportées aux ressources Microsoft Graph répertoriées dans le tableau.

Remarque

Les abonnements aux ressources marqués avec un astérisque (*) sont uniquement disponibles sur le point de /beta terminaison.

Ressource Chemins d’accès aux ressources pris en charge Limitations
Imprimante pour impression cloud Modifications lorsqu’un travail d’impression est prêt à être téléchargé (événement jobFetchable) : /print/printers/{id}/jobs -
Impression Cloud printTaskDefinition Change lorsqu’il y a un travail valide dans la file d’attente (événement jobStarted) : /print/printtaskdefinition/{id}/tasks -
driveItem sur OneDrive (personnel) Modifications apportées au contenu dans la hiérarchie d’un dossier : /users/{id}/drive/root -
driveItem sur OneDrive Entreprise Modifications apportées au contenu dans la hiérarchie du dossier racine : /drives/{id}/root , /users/{id}/drive/root -
groupe Modifications apportées à tous les groupes : /groups

Modifications apportées à un groupe spécifique : /groups/{id}

Modifications apportées aux propriétaires d’un groupe spécifique : /groups/{id}/owners

Modifications apportées aux membres d’un groupe spécifique : /groups/{id}/members		 Quotas maximaux d'abonnement :
  • Par application (pour tous les locataires combinés) : 50 000 abonnements au total.
  • Par locataire (pour toutes les applications combinées) : 1 000 abonnements au total sur toutes les applications.
  • Par combinaison d’application et de locataire : 100 abonnements au total.

    Non pris en charge pour les locataires Azure AD B2C.

    NOTE: La création et la suppression réversible de groupes déclenchent également le updatedchangeType.
    		•
    Une liste sous un site SharePoint Modifications apportées au contenu de la liste : /sites/{site-id}/lists/{list-id} -
    Conversation de groupe Microsoft 365 Modifications apportées aux conversations d’un groupe : groups/{id}/conversations -
    message Outlook Modifications apportées à tous les messages dans la boîte aux lettres d’un utilisateur : /users/{id}/messages , /me/messages

    Modifications apportées aux messages dans la boîte de réception d’un utilisateur : /users/{id}/mailFolders('inbox')/messages , /me/mailFolders('inbox')/messages    		 Un maximum de 1 000 abonnements actifs par boîte aux lettres pour toutes les applications est autorisé.
    événement Outlook Modifications apportées à tous les événements dans la boîte aux lettres d’un utilisateur : /users/{id}/events , /me/events Un maximum de 1 000 abonnements actifs par boîte aux lettres pour toutes les applications est autorisé.
    contact personnel Outlook Modifications apportées à tous les contacts personnels dans la boîte aux lettres d’un utilisateur : /users/{id}/contacts , /me/contacts Un maximum de 1 000 abonnements actifs par boîte aux lettres pour toutes les applications est autorisé.
    Alerte de sécurité Modifications apportées à une alerte spécifique : /security/alerts/{id}

    Modifications apportées aux alertes filtrées : /security/alerts/?$filter={parameters}    		 Pour plus d’informations, consultez alertes API de sécurité.
    Teams callRecord Modifications apportées à tous les enregistrements d’appels : /communications/callRecords Quotas maximaux d'abonnement :
  • Par organization : 100 abonnements au total.

    NOTE: La création d’enregistrements d’appel déclenche également le updatedchangeType.
    		•
    CallRecording Teams Tous les enregistrements d’un organization :communications/onlineMeetings/getAllRecordings

    Tous les enregistrements d’une réunion spécifique : communications/onlineMeetings/{onlineMeetingId}/recordings

    Enregistrement d’appel qui devient disponible dans une réunion organisée par un utilisateur spécifique : users/{id}/onlineMeetings/getAllRecordings

    Enregistrement d’appel qui devient disponible dans une réunion où une application Teams particulière est installée : appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings *    		 Quotas maximaux d'abonnement :
  • Par application et combinaison de réunion en ligne : 1
  • Par combinaison d’application et d’utilisateur : 1
  • Par utilisateur (pour les enregistrements de suivi des abonnements dans tous les onlineMeetings organisés par l’utilisateur) : 10 abonnements.
  • Par organization : 10 000 abonnements au total.
    		•
    Teams callTranscript Toutes les transcriptions d’un organization :communications/onlineMeetings/getAllTranscripts

    Toutes les transcriptions d’une réunion spécifique : communications/onlineMeetings/{onlineMeetingId}/transcripts

    Transcription d’appel qui devient disponible dans une réunion organisée par un utilisateur spécifique : users/{id}/onlineMeetings/getAllTranscripts

    Transcription d’appel qui devient disponible dans une réunion où une application Teams particulière est installée : appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts *    		 Quotas maximaux d'abonnement :
  • Par application et combinaison de réunion en ligne : 1
  • Par combinaison d’application et d’utilisateur : 1
  • Par utilisateur (pour les transcriptions de suivi des abonnements dans tous les onlineMeetings organisés par l’utilisateur) : 10 abonnements.
  • Par organization : 10 000 abonnements au total.
    		•
    Conversation Teams Modifications apportées à n’importe quelle conversation dans le locataire : /chats

    Modifications apportées à une conversation spécifique : /chats/{id}

    Modifications apportées à toutes les conversations dans un organization où une application Teams particulière est installée :/appCatalogs/teamsApps/{id}/installedToChats    		 Quotas maximaux d'abonnement :
  • Par combinaison d’application et de conversation : 1 abonnement.
  • Par organization : 10 000 abonnements au total.
    		•
    chatmessage Teams Modifications apportées aux messages de conversation dans tous les canaux de toutes les équipes : /teams/getAllMessages

    Modifications apportées aux messages de conversation dans un canal spécifique : /teams/{id}/channels/{id}/messages

    Modifications apportées aux messages de conversation dans toutes les conversations : /chats/getAllMessages

    Modifications apportées aux messages de conversation dans une conversation spécifique : /chats/{id}/messages

    Modifications apportées aux messages de conversation dans toutes les conversations dont un utilisateur particulier fait partie : /users/{id}/chats/getAllMessages

    Modifications apportées aux messages de conversation pour toutes les conversations dans un organization où une application Teams particulière est installée :/appCatalogs/teamsApps/{id}/installedToChats/getAllMessages    		 Quotas maximaux d'abonnement :
  • Par application et canal ou combinaison de conversation : 1 abonnement.
  • Par utilisateur (pour les abonnements suivi des messages de conversation dans toutes les conversations dont l’utilisateur fait partie) : 10 abonnements.
  • Par organization : 10 000 abonnements au total.
    		•
    Canal Teams Modifications apportées aux canaux dans toutes les équipes : /teams/getAllChannels

    Modifications apportées au canal dans une équipe spécifique : /teams/{id}/channels    		 Quotas maximaux d'abonnement :
  • Par combinaison d’application et d’équipe : 1 abonnement.
  • Par organization : 10 000 abonnements au total.
    		•
    conversationMember Teams Modifications apportées à l’appartenance à une équipe spécifique : /teams/{id}/members

    Modifications apportées à l’appartenance à tous les canaux d’une équipe spécifique : teams/{id}/channels/getAllMembers

    Modifications apportées à l’appartenance à une conversation spécifique : /chats/{id}/members

    Modifications apportées à l’appartenance à toutes les conversations dans un organization où une application Teams particulière est installée :/appCatalogs/teamsApps/{id}/installedToChats/getAllMembers

    Modifications apportées à l’appartenance à toutes les conversations : /chats/getAllMembers    		 Quotas maximaux d'abonnement :
  • Par combinaison d’application et d’équipe : 1 abonnement.
  • Par organization : 10 000 abonnements au total.
    		•
    Teams onlineMeeting* Modifications apportées à une réunion en ligne : /communications/onlineMeetings/?$filter=JoinWebUrl eq {joinWebUrl}
    présenceTeams Modifications apportées à la présence d’un seul utilisateur : /communications/presences/{id}

    Modifications apportées à plusieurs présences d’utilisateurs : /communications/presences?$filter=id in ({id},{id}...)
    Équipe Teams Modifications apportées à n’importe quelle équipe dans le locataire : /teams

    Modifications apportées à une équipe spécifique : /teams/{id}    		 Quotas maximaux d'abonnement :
  • Par combinaison d’application et d’équipe : 1 abonnement.
  • Par organization : 10 000 abonnements au total.
    		•
    todoTask Modifications apportées à toutes les tâches d’une liste de tâches spécifique : /me/todo/lists/{todoTaskListId}/tasks -
    utilisateur Modifications apportées à tous les utilisateurs : /users

    Modifications apportées à un utilisateur spécifique : /users/{id}    		 Quotas maximaux d'abonnement :
  • Par application (pour tous les locataires combinés) : 50 000 abonnements au total.
  • Par locataire (toutes applications combinées) : 1000 abonnements au total pour toutes les applications
  • Par combinaison d’application et de locataire : 100 abonnements au total.

    Non pris en charge pour les comptes Microsoft personnels tels que outlook.com.

    Non pris en charge pour les locataires Azure AD B2C.

    NOTE: La création et la suppression réversible d’utilisateurs déclenchent également le updatedchangeType.
    		•

    Remarque

    De nombreuses ressources ont des limites ou des quotas sur le nombre d’abonnements qui peuvent être effectués sur cette ressource. En cas de dépassement de cette limite, les tentatives de création d’un abonnement entraînent une 403 Forbidden réponse d’erreur. La propriété message de la réponse d’erreur explique la limite qui a été dépassée.

    Certaines de ces ressources prennent en charge les notifications enrichies (notifications avec des données de ressources). Pour plus d’informations sur les ressources qui prennent en charge les notifications enrichies, consultez Configurer des notifications de modification qui incluent des données de ressources.

    Remarque : les chemins d’accès aux ressources qui commencent par /users/{id} peuvent également accepter /me pour référencer l’utilisateur connecté.

    Autorisations

    En règle générale, les opérations d’abonnement nécessitent l’autorisation d’accès en lecture à la ressource. Par exemple, pour recevoir des notifications pour les messages, votre application requiert l’autorisation Mail.Read. L’article create subscription répertorie les autorisations nécessaires pour chaque type de ressource. Le tableau suivant répertorie les types d’autorisations que votre application peut demander pour utiliser des Webhooks pour des types de ressources spécifiques.

    Type d’autorisation Types de ressources pris en charge
    Délégué : compte professionnel ou scolaire alert, callRecording, callTranscript, channel, contact, conversation, conversationMember, driveItem, event, group, list, message, team, todoTask, user
    Délégué : compte Microsoft personnel contact, driveItem, événement, liste, message, todoTask
    Application alert, callRecord, callRecording, callTranscript, channel, chatMessage, contact, conversationMember, driveItem, event, group, list, message, printer, printTaskDefinition, team, user

    Contenu connexe