Usar la API de Microsoft Graph para obtener notificaciones de cambios

Espacio de nombres: microsoft.graph

La API de REST de Microsoft Graph utiliza un mecanismo webhook para entregar notificaciones a los clientes. Un cliente es un servicio web que configura su propia dirección URL para recibir notificaciones. Las aplicaciones cliente utilizan notificaciones para actualizar su estado cuando se realizan cambios. 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.

Mediante la API de Microsoft Graph, una aplicación puede suscribirse a cambios en los siguientes recursos:

Recurso Rutas de acceso de recursos compatibles Los datos de los recursos se pueden incluir en las notificaciones
[Impresora][] para impresión en la nube Cambios cuando un trabajo de impresión esté listo para descargarse (evento JobFetchable):
/print/printers/{id}/jobs
No
Impresión en la nube printTaskDefinition Cambia cuando haya un trabajo válido en la cola (evento JobStarted):
/print/printtaskdefinition/{id}/tasks
No
mensaje de Outlook Cambios en todos los mensajes de un buzón de usuario:
/users/{id}/messages
Cambios en mensajes en la bandeja de entrada de un usuario:
/users/{id}/mailFolders('inbox')/messages
No
[evento][] de Outlook Cambios en todos los eventos del buzón de un usuario:
/users/{id}/events
No
[contacto][] personal de Outlook Cambios en todos los contactos personales en el buzón de un usuario:
/users/{id}/contacts
No
usuario Cambios en todos los usuarios:
/users
Cambios en un usuario específico:
/users/{id}
No
grupo Cambios en todos los grupos:
/groups
Cambios en un grupo específico:
/groups/{id}
Cambios en los propietarios de un grupo específico:
/groups/{id}/owners
Cambios en los miembros de un grupo específico:
/groups/{id}/members
No
[conversation][] de grupo de Microsoft 365 Cambios en las conversaciones de un grupo:
groups/{id}/conversations
No
driveItem en OneDrive (personal) Cambios en el contenido de la jerarquía de cualquier carpeta:
/users/{id}/drive/root
No
driveItem en OneDrive para la Empresa Cambios en el contenido de la jerarquía de la carpeta raíz:
/drives/{id}/root
/users/{id}/drive/root
No
[lista][] en un sitio [de SharePoint][] Cambios en el contenido de la lista:
/sites/{id}/lists/{id}
No
alerta de seguridad Cambios en una alerta específica:
/security/alerts/{id}
Cambios en alertas filtradas:
/security/alerts/?$filter
No
callRecord de Teams Cambios en todos los registros de llamadas: /communications/callRecords No
chatmessage de Teams Cambios en mensajes de chat de todos los canales de todos los equipos:
/teams/getAllMessages
Cambios en mensajes de chat en un canal específico:
/teams/{id}/channels/{id}/messages
Cambios en mensajes de chat de todos los chats:
/chats/getAllMessages
Cambios en mensajes de chat en un chat específico:
/chats/{id}/messages

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.

Permissions

En general, las operaciones de suscripción requieren permiso de lectura en el recurso. Por ejemplo, para obtener notificaciones en mensajes, la aplicación necesita el permiso Mail.Read. En el artículo sobre cómo crear suscripciones se muestran los permisos necesarios para cada tipo de recurso. En la siguiente tabla aparecen los tipos de permisos que la aplicación puede solicitar para usar webhooks con tipos de recurso concretos.

Tipo de permiso Tipos de recursos admitidos
Delegado: cuenta profesional o educativa alerta, [contacto][], conversación, driveItem, [lista][], [evento][],grupo,mensaje,usuario
Delegado: cuenta de Microsoft personal [contacto][], driveItem, [lista][],[evento][],mensaje
Aplicación [alert][], contact, list, driveItem, event, [group][], [message][], [user][], callRecord, chatMessage, printer, printTaskDefinition

Vea también