Uso de la API REST de Microsoft Graph desde un complemento de Outlook

La API de JavaScript de Outlook (Office.js) recupera las propiedades de mensajes y citas y ejecuta operaciones en estos elementos del complemento. Sin embargo, puede haber instancias en las que los datos que necesita no estén disponibles a través de la API. Por ejemplo, es posible que el complemento tenga que implementar el inicio de sesión único o identificar los mensajes en el buzón de correo de un usuario que se originaron desde el mismo remitente. Para obtener la información que necesita, use la API REST de correo de Outlook a través de Microsoft Graph.

Introducción

Para llamar a Microsoft Graph desde el complemento, implemente la solución de autenticación de aplicaciones anidadas (NAA) para obtener un token de acceso. NAA usa la Biblioteca de autenticación de Microsoft (MSAL) para adquirir de forma silenciosa un token para el usuario que ha iniciado sesión sin necesidad de redirigirlo a una página de inicio de sesión. El token se limita a los puntos de conexión de Microsoft Graph API que necesita el complemento.

Llamar a la API de Microsoft Graph

Una vez que tenga un token de acceso, úselo para llamar a Microsoft Graph pasándolo como token de portador en el Authorization encabezado.

Microsoft Graph API usa el siguiente patrón de punto de conexión.

• version especifica v1.0 (estable) o beta (versión preliminar).
• resource especifica el recurso con el que interactúa el complemento, como un usuario, un grupo o un sitio.
• query_parameters son parámetros opcionales para filtrar, ordenar o paginar resultados.

https://graph.microsoft.com/[version]/[resource]?[query_parameters]

En el ejemplo siguiente se muestra cómo obtener los mensajes del usuario que ha iniciado sesión mediante fetch API después de adquirir un token de acceso.

// Call the Microsoft Graph API to get the user's messages.
const response = await fetch('https://graph.microsoft.com/v1.0/me/messages', {
    headers: {
        'Authorization': 'Bearer ' + accessToken
    }
});
const data = await response.json();
console.log(data.value); // Array of message objects

Para obtener más información sobre microsoft Graph API y sus componentes, consulte Uso de Microsoft Graph API.

Vea también

• Referencia del punto de conexión de la API de REST v1.0 de Microsoft Graph
• Información general sobre la API de correo de Outlook
• Usar la API de REST de Correo de Outlook
• Habilitación del inicio de sesión único en un complemento de Office mediante la autenticación de aplicaciones anidadas