Erste Schritte mit der OneDrive-API
Diese Seite enthält eine kurze Übersicht über die erforderlichen Schritte zum Verwenden von Microsoft Graph und der OneDrive-API. Eine ausführliche Erläuterung der Vorgehensweise finden Sie unter Microsoft Graph Quick Start (Microsoft Graph-Schnellstart).
Wenn Sie mit SharePoint Server 2016 arbeiten oder Microsoft Graph nicht verwenden, können Sie sich im Thema zur Verwendung der OneDrive-API mit SharePoint Server 2016 informieren.
1. Benutzerauthentifizierung und Autorisierung Ihrer App
Microsoft Graph und die OneDrive-API verwenden OAuth 2.0 für die Autorisierung. Mithilfe eines OAuth-Flusses erhält Ihre App ein Zugriffstoken, das den Zugriff auf Microsoft Graph und einen bestimmten Satz an Berechtigungen für einen Benutzer ermöglicht.
Ihre App stellt das Zugriffstoken in jeder Anforderung über einen HTTP-Header bereit:
Authorization: bearer {token}
Weitere Informationen zur Autorisierung Ihrer Anwendung und Anforderung eines Zugriffstokens erhalten Sie in App-Authentifizierung mit Microsoft Graph.
2. Aufrufe an Ressourcen senden
Sobald Ihre App autorisiert ist und ein Zugriffstoken zur Verfügung steht, kann sie Anforderungen an den Microsoft Graph-Endpunkt für OneDrive- oder SharePoint-Ressourcen senden. Um die URL für eine Ressource zu erstellen, müssen Sie die relative URL für die Stammressource (wie z. B. ein Benutzer, eine Gruppe oder eine Website) und die Laufwerksressource oder driveItem-Ressource kennen, auf die Ihre Anforderung abzielt.
Eine Anforderungs-URL umfasst folgende Komponenten:
- Microsoft Graph-Stamm-URL und -Version (
https://graph.microsoft.com/v1.0
) - Ein Stammressourcenziel (
/users/{id}
) - Ein OneDrive-API-Ressourcenziel (
/drive
oder/drives/{id}/items/{item-id}
oder/drive/root:/path/to/item
)
Hinweis: In der Dokumentation werden nur Syntaxteile verwendet, wie z. B. GET /drive/items/{item-id}
, damit sie nicht zu lang wird.
Stellen Sie dem Pfad die korrekte Stamm-URL und das Stammressourcenziel voran, um den vollständigen Ressourcenpfad oder die vollständige URL zu erhalten.
3. Weitere Schritte
Sehen Sie sich die OneDrive-Beispiele auf GitHub und die Microsoft Graph-Beispiele auf GitHub an, um mehr über die Verwendung von Dateien in Microsoft Graph zu erfahren.
Lesen Sie auch die OneDrive-API-HTTP-Dokumentation, um mehr über das Arbeiten mit den Laufwerks- und driveItem-Ressourcen zu erfahren. Weitere Informationen zu allen Ressourcen in Microsoft Graph finden Sie in der Microsoft Graph-Dokumentation.
Sie haben Fragen oder benötigen Unterstützung? Sie finden uns auf Stack Overflow und über die GitHub-Problemseite für unsere Dokumentation.