Verwenden der Microsoft Graph-REST-API aus einem Outlook-Add-In

Die Outlook-JavaScript-API (Office.js) ruft die Eigenschaften von Nachrichten und Terminen ab und führt Vorgänge für diese Elemente in Ihrem Add-In aus. Es kann jedoch Vorkommen geben, in denen die benötigten Daten nicht über die API verfügbar sind. Beispielsweise muss Ihr Add-In möglicherweise einmaliges Anmelden implementieren oder Nachrichten im Postfach eines Benutzers identifizieren, die vom gleichen Absender stammen. Um die benötigten Informationen zu erhalten, verwenden Sie die Outlook-Mail-REST-API über Microsoft Graph.

Erste Schritte

Um Microsoft Graph aus Ihrem Add-In aufzurufen, implementieren Sie die Lösung für die geschachtelte App-Authentifizierung (NAA), um ein Zugriffstoken abzurufen. NAA verwendet die Microsoft Authentication Library (MSAL) (MSAL), um automatisch ein Token für den angemeldeten Benutzer abzurufen, ohne dass eine Umleitung zu einer Anmeldeseite erforderlich ist. Das Token ist auf die Microsoft Graph-API Endpunkte ausgerichtet, die Ihr Add-In benötigt.

Wichtig

Legacy-Exchange Online Benutzeridentitätstoken und Rückruftoken werden nicht mehr unterstützt und für alle Microsoft 365-Mandanten deaktiviert. Wenn ein Outlook-Add-In delegierten Benutzerzugriff oder eine Benutzeridentität erfordert, empfehlen wir die Verwendung von MSAL (Microsoft Authentication Library (MSAL)) und geschachtelter App-Authentifizierung. Exchange-Benutzeridentitätstoken werden für lokale Exchange-Instanzen weiterhin unterstützt.

Aufrufen der Microsoft Graph-API

Sobald Sie über ein Zugriffstoken verfügen, verwenden Sie es, um Microsoft Graph aufzurufen, indem Sie es als Bearertoken im Authorization Header übergeben.

Die Microsoft Graph-API verwendet das folgende Endpunktmuster.

  • version gibt an v1.0 (stabil) oder beta (Vorschau).
  • resource gibt die Ressource an, mit der Ihr Add-In interagiert, z. B. einen Benutzer, eine Gruppe oder eine Website.
  • query_parameters sind optionale Parameter zum Filtern, Sortieren oder Paginieren von Ergebnissen.
https://graph.microsoft.com/[version]/[resource]?[query_parameters]

Das folgende Beispiel zeigt, wie Die Nachrichten des angemeldeten Benutzers mithilfe der Fetch-API nach dem Abrufen eines Zugriffstokens abgerufen werden.

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

Weitere Informationen zum Microsoft Graph-API und den zugehörigen Komponenten finden Sie unter Verwenden des Microsoft-Graph-API.

Siehe auch

  • Last updated on