Freigeben über

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 Aufrufe an die Microsoft Graph-API in Office-Add-Ins zu tätigen, implementieren Sie die Lösung für die Authentifizierung geschachtelter Apps (NAA), um ein Token anzufordern.

Wichtig

Legacy-Exchange-Token sind veraltet. Ältere Exchange-Benutzeridentitäten und Rückruftoken wurden für die meisten Exchange Online Mandanten deaktiviert. Administratoren können Legacytoken für Mandanten und Add-Ins bis Juni 2025 wieder zulassen. Im Oktober 2025 werden Legacytoken für alle Mandanten vollständig deaktiviert. Die Zeitleiste und Details finden Sie auf unserer Faq-Seite. Dies ist Teil der Secure Future Initiative von Microsoft, die Organisationen die Tools zur Verfügung stellt, die sie benötigen, um auf die aktuelle Bedrohungslandschaft zu reagieren. Exchange-Benutzeridentitätstoken funktionieren weiterhin für lokale Exchange-Instanzen. Die Authentifizierung geschachtelter Apps ist der empfohlene Ansatz für token in Zukunft.

Aufrufen der Microsoft Graph-API

Sobald Sie über ein Zugriffstoken verfügen, können Sie es verwenden, um Microsoft Graph aufzurufen.

Die Microsoft Graph-API besteht aus den v1.0- und Beta-Endpunkten. Beachten Sie Folgendes zum Endpunktmuster.

  • version gibt die v1.0 API oder beta an.
  • resource gibt die Ressource an, mit der Ihr Add-In interagiert, z. B. einen Benutzer, eine Gruppe oder eine Website.
  • query_parameters gibt Parameter an, um Ihre Anforderung anzupassen. Beispielsweise können Sie die Nachrichten filtern, die nur an die nachrichten eines bestimmten Absenders zurückgegeben werden.
https://graph.microsoft.com/[version]/[resource]?[query_parameters]

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

Siehe auch