Microsoft Graph-APIMicrosoft Graph API

Die Microsoft Graph-API ist eine RESTful-Web-API, die Ihnen den Zugriff auf Microsoft Cloud-Dienstressourcen ermöglicht.The Microsoft Graph API is a RESTful web API that enables you to access Microsoft Cloud service resources. Nachdem Sie Ihre App registriert und Authentifizierungstoken für einen Benutzer oder Dienst abgerufen haben, können Sie Anforderungen an die Microsoft Graph-API senden.After you register your app and get authentication tokens for a user or service, you can make requests to the Microsoft Graph API. Weitere Informationen finden Sie in der Übersicht zu Microsoft Graph.For more information, see Overview of Microsoft Graph.

Microsoft Graph macht Rest-APIs und Clientbibliotheken für den Zugriff auf Daten für die folgenden Microsoft 365-Dienste verfügbar:Microsoft Graph exposes REST APIs and client libraries to access data on the following Microsoft 365 services:

  • Microsoft 365-Dienste: Delve, Excel, Microsoft Bookings, Microsoft Teams, OneDrive, OneNote, Outlook/Exchange, Planner und SharePointMicrosoft 365 services: Delve, Excel, Microsoft Bookings, Microsoft Teams, OneDrive, OneNote, Outlook/Exchange, Planner, and SharePoint
  • Enterprise Mobility + Security-Dienste: Advanced Threat Analytics, Advanced Threat Protection, Azure Active Directory, Identity Manager und IntuneEnterprise Mobility and Security services: Advanced Threat Analytics, Advanced Threat Protection, Azure Active Directory, Identity Manager, and Intune
  • Windows 10-Dienste: Aktivitäten, Geräte, BenachrichtigungenWindows 10 services: activities, devices, notifications
  • Dynamics 365 Business CentralDynamics 365 Business Central

VersionenVersions

Microsoft Graph unterstützt derzeit zwei Versionen: v1.0 und Beta.Microsoft Graph currently supports two versions: v1.0 and beta. Die Version v1.0 enthält allgemein verfügbare APIs.The v1.0 version includes generally available APIs. Verwenden Sie die Version v1.0 für alle Produktions-Apps.Use the v1.0 version for all production apps. Die Betaversion enthält APIs, die sich derzeit in der Vorschau befinden.The beta includes APIs that are currently in preview. Weil wir möglicherweise wichtige Änderungen (Breaking Changes) an unseren Beta-APIs einführen, empfehlen wir, die Betaversion nur zum Testen von Apps zu verwenden, die sich in der Entwicklung befinden. Verwenden Sie Beta-APIs nicht in Ihren Produktions-Apps.Because we might introduce breaking changes to our beta APIs, we recommend that you use the beta version only to test apps that are in development; do not use beta APIs in your production apps. Weitere Informationen finden Sie unter Versionsverwaltung, Support und Breaking Change-Richtlinien für Microsoft Graph.For more information, see Versioning, support, and breaking change policies for Microsoft Graph.

Wenn Sie mit der Verwendung der Beta-APIs beginnen möchten, lesen Sie Microsoft Graph beta endpoint reference (Microsoft Graph – Beta-Endpunkt-Referenz).To start using the beta APIs, see Microsoft Graph beta endpoint reference

Wenn Sie mit der Verwendung der v1.0-APIs beginnen möchten, lesen Sie Microsoft Graph REST API v1.0 reference (Microsoft Graph – REST-API v1.0-Referenz).To start using the v1.0 APIs, see Microsoft Graph REST API v1.0 reference

Erste SchritteGet started

Zum Lesen aus einer oder Schreiben in eine Ressource, z. B. einen Benutzer oder eine E-Mail-Nachricht, erstellen Sie eine Anforderung, die folgendermaßen aussieht:To read from or write to a resource such as a user or an email message, you construct a request that looks like the following:

{HTTP method} https://graph.microsoft.com/{version}/{resource}?{query-parameters}

Weitere Informationen zu den Elementen der erstellten Anforderung finden Sie unter Verwenden der Microsoft Graph-API.For more information about the elements of the constructed request, see Use the Microsoft Graph API

Schnellstartbeispiele stehen zur Verfügung, die Ihnen zeigen sollen, wie Sie auf die Leistung der Microsoft Graph-API zugreifen können.Quickstart samples are available to show you how to access the power of the Microsoft Graph API. Die verfügbaren Beispiele greifen auf zwei Dienste mit einer Authentifizierung zu: Microsoft-Konto und Outlook.The samples that are available access two services with one authentication: Microsoft account and Outlook. Jeder Schnellstart greift auf Informationen aus den Benutzerprofilen des Microsoft-Kontos zu und zeigt Ereignisse aus dem Kalender dieser Benutzer an.Each quickstart accesses information from Microsoft account users' profiles and displays events from their calendar. Die Schnellstarts umfassen vier Schritte:The quickstarts involve four steps:

  • Auswählen Ihrer PlattformSelect your platform
  • Abrufen Ihrer App-ID (Client-ID)Get your app ID (client ID)
  • Erstellen des BeispielsBuild the sample
  • Anmelden und Anzeigen von Ereignissen in Ihrem KalenderSign in, and view events on your calendar

Nach Abschluss des Schnellstarts verfügen Sie über eine ausführungsbereite App.When you complete the quickstart, you have an app that's ready to run. Weitere Informationen finden Sie in Microsoft Graph-Schnellstart – Häufig gestellte Fragen (FAQ).For more information, see the Microsoft Graph quickstart FAQ. Erste Schritte mit den Beispielen finden Sie unter Microsoft Graph – Schnellstart.To get started with the samples, see Microsoft Graph QuickStart.

ToolsTools

Der Microsoft Graph-Tester ist ein webbasiertes Tool, mit dem Sie Anforderungen über die Microsoft Graph-APIs erstellen und testen können.Microsoft Graph Explorer is a web-based tool that you can use to build and test requests using Microsoft Graph APIs. Sie können auf den Microsoft Graph-Tester zugreifen unter: https://developer.microsoft.com/graph/graph-explorer.You can access Microsoft Graph Explorer at: https://developer.microsoft.com/graph/graph-explorer.

Postman ist ein Tool, mit dem Sie Anforderungen über die Microsoft Graph-APIs ebenfalls erstellen und testen können.Postman is a tool that you can also use to build and test requests using the Microsoft Graph APIs. Sie können Postman herunterladen unter: https://www.getpostman.com/.You can download Postman at: https://www.getpostman.com/. Für die Interaktion mit Microsoft Graph in Postman verwenden Sie die Microsoft Graph-Sammlung in Postman.To interact with Microsoft Graph in Postman, you use the Microsoft Graph collection in Postman. Weitere Informationen finden Sie unter Use Postman with the Microsoft Graph API (Verwenden von Postman bei der Microsoft Graph-API).For more information, see Use Postman with the Microsoft Graph API.