Usar la API de Microsoft Graph para obtener notificaciones de cambiosUse the Microsoft Graph API to get change notifications

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

La API de REST de Microsoft Graph utiliza un mecanismo webhook para entregar notificaciones a los clientes.The Microsoft Graph REST API uses a webhook mechanism to deliver change notifications to clients. Un cliente es un servicio web que configura su propia dirección URL para recibir notificaciones.A client is a web service that configures its own URL to receive notifications. Las aplicaciones cliente utilizan notificaciones para actualizar su estado cuando se realizan cambios.Client apps use notifications to update their state upon changes. Para obtener más información, incluido cómo suscribirse y controlar las notificaciones de entrada, vea Configurar las notificaciones de cambios en los datos de usuario.For more details, including how to subscribe to and handle incoming notifications, see Set up notifications for changes in user data.

Mediante la API de Microsoft Graph, una aplicación puede suscribirse a cambios en los siguientes recursos:Using the Microsoft Graph API, an app can subscribe to changes on the following resources:

RecursoResource Rutas de acceso de recursos compatiblesSupported resource paths Los datos de los recursos se pueden incluir en las notificacionesResource data can be included in notifications
mensaje de OutlookOutlook message Cambios en todos los mensajes de un buzón de usuario:Changes to all messages in a user's mailbox:
/users/{id}/messages
Cambios en mensajes en la bandeja de entrada de un usuario:Changes to messages in a user's Inbox:
/users/{id}/mailFolders('inbox')/messages
NoNo
[evento][] de OutlookOutlook event Cambios en todos los eventos del buzón de un usuario:Changes to all events in a user's mailbox:
/users/{id}/events
NoNo
[contacto][] personal de OutlookOutlook personal contact Cambios en todos los contactos personales en el buzón de un usuario:Changes to all personal contacts in a user's mailbox:
/users/{id}/contacts
NoNo
usuariouser Cambios en todos los usuarios:Changes to all users:
/users
Cambios en un usuario específico:Changes to a specific user:
/users/{id}
NoNo
grupogroup Cambios en todos los grupos:Changes to all groups:
/groups
Cambios en un grupo específico:Changes to a specific group:
/groups/{id}
Cambios en los propietarios de un grupo específico:Changes to owners of a specific group:
/groups/{id}/owners
Cambios en los miembros de un grupo específico:Changes to members of a specific group:
/groups/{id}/members
NoNo
conversation de grupo de Microsoft 365 Microsoft 365 group conversation Cambios en las conversaciones de un grupo:Changes to a group's conversations:
groups/{id}/conversations
NoNo
driveItem en OneDrive (personal)driveItem on OneDrive (personal) Cambios en el contenido de la jerarquía de cualquier carpeta:Changes to content within the hierarchy of any folder:
/users/{id}/drive/root
NoNo
driveItem en OneDrive para la EmpresadriveItem on OneDrive for Business Cambios en el contenido de la jerarquía de la _carpeta raíz _:Changes to content within the hierarchy of the root folder:
/drives/{id}/root
/users/{id}/drive/root
NoNo
[lista][] en un sitio [de SharePoint][]list under a SharePoint site Cambios en el contenido de la lista:Changes to content within the list:
/sites/{id}/lists/{id}
NoNo
alerta de seguridadSecurity alert Cambios en una alerta específica:Changes to a specific alert:
/security/alerts/{id}
Cambios en alertas filtradas:Changes to filtered alerts:
/security/alerts/?$filter
NoNo
callRecord de TeamsTeams callRecord Cambios en todos los registros de llamadas: /communications/callRecordsChanges to all call records: /communications/callRecords NoNo
chatmessage de Teams Teams chatmessage Cambios en mensajes de chat de todos los canales de todos los equipos:Changes to chat messages in all channels in all teams:
/teams/getAllMessages
Cambios en mensajes de chat en un canal específico:Changes to chat messages in a specific channel:
/teams/{id}/channels/{id}/messages
Cambios en mensajes de chat de todos los chats:Changes to chat messages in all chats:
/chats/getAllMessages
Cambios en mensajes de chat en un chat específico:Changes to chat messages in a specific chat:
/chats/{id}/messages
Yes

Nota: cualquiera de las rutas de acceso a los recursos que empiece por /users/{id} también pueden aceptar /me para hacer referencia al usuario que ha iniciado sesión.Note: Any resource path that begins with /users/{id} can also accept /me to reference the signed-in user.

PermissionsPermissions

En general, las operaciones de suscripción requieren permiso de lectura en el recurso.In general, subscription operations require read permission to the resource. Por ejemplo, para obtener notificaciones en mensajes, la aplicación necesita el permiso Mail.Read.For example, to get notifications for messages, your app needs the Mail.Read permission. En el artículo sobre cómo crear suscripciones se muestran los permisos necesarios para cada tipo de recurso.The create subscription article lists permissions needed for each resource type. En la siguiente tabla aparecen los tipos de permisos que la aplicación puede solicitar para usar webhooks con tipos de recurso concretos.The following table lists the types of permissions your app can request to use webhooks for specific resource types.

Tipo de permisoPermission type Tipos de recursos admitidosSupported resource types
Delegado: cuenta profesional o educativaDelegated - work or school account alerta, [contacto][], conversación, driveItem, [lista][], [evento][],grupo,mensaje,usuarioalert, contact, conversation, driveItem, list, event, group, message, user
Delegado: cuenta de Microsoft personalDelegated - personal Microsoft account [contacto][], driveItem, [lista][],[evento][],mensajecontact, driveItem, list, event, message
AplicaciónApplication alerta, [contacto][], [lista][], driveItem, [evento][], grupo, mensaje, usuario, callRecord, chatMessagealert, contact, list, driveItem, event, group, message, user, callRecord, chatMessage

Vea tambiénSee also