Utiliser l’API REST Microsoft Graph à partir d’un complément Outlook

L’API JavaScript Outlook (Office.js) récupère les propriétés des messages et des rendez-vous et exécute des opérations sur ces éléments dans votre complément. Toutefois, il peut arriver que les données dont vous avez besoin ne soient pas disponibles via l’API. Par exemple, votre complément peut avoir besoin d’implémenter l’authentification unique ou d’identifier les messages dans la boîte aux lettres d’un utilisateur qui proviennent du même expéditeur. Pour obtenir les informations dont vous avez besoin, utilisez l’API REST de messagerie Outlook via Microsoft Graph.

Prise en main

Pour appeler Microsoft Graph à partir de votre complément, implémentez la solution NAA (Nested App Authentication) pour obtenir un jeton d’accès. NAA utilise la bibliothèque d’authentification Microsoft (MSAL) pour acquérir en mode silencieux un jeton pour l’utilisateur connecté sans nécessiter de redirection vers une page de connexion. Le jeton est limité aux points de terminaison Microsoft API Graph dont votre complément a besoin.

Appel de l’API Microsoft Graph

Une fois que vous disposez d’un jeton d’accès, utilisez-le pour appeler Microsoft Graph en le transmettant en tant que jeton du porteur dans l’en-tête Authorization .

Le API Graph Microsoft utilise le modèle de point de terminaison suivant.

• version spécifie v1.0 (stable) ou beta (préversion).
• resource spécifie la ressource avec laquelle votre complément interagit, par exemple un utilisateur, un groupe ou un site.
• query_parameters sont des paramètres facultatifs pour filtrer, trier ou paginer les résultats.

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

L’exemple suivant montre comment obtenir les messages de l’utilisateur connecté à l’aide de l’API Fetch après l’acquisition d’un jeton d’accès.

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

Pour plus d’informations sur microsoft API Graph et ses composants, consultez Utiliser microsoft API Graph.

Voir aussi

• Référence sur le point de terminaison de l’API REST v1.0 Microsoft Graph
• Présentation des API de courrier Outlook
• Utilisez l’API REST de messagerie Outlook
• Activer l’authentification unique dans un complément Office à l’aide de l’authentification d’application imbriquée