Freigeben über

Herunterladen von Inhalten einer DriveItemVersion-Ressource

  • Artikel

Rufen Sie die Inhalte einer bestimmten DriveItem-Version ab.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Anwendung Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-Anforderung

GET /drives/{drive-id}/items/{item-id}/versions/{version-id}/content
GET /groups/{group-id}/drive/{item-id}/versions/{version-id}/content
GET /me/drive/items/{item-id}/versions/{version-id}/content
GET /sites/{site-id}/drive/items/{item-id}/versions/{version-id}/content
GET /users/{user-id}/drive/items/{item-id}/versions/{version-id}/content

Antwort

Die Methode gibt eine Antwort 302 Found zurück, die auf eine vorab authentifizierte URL zum Download der Bytes der Datei umleitet.

Zum Herunterladen des Dateiinhalts muss die Anwendung den Location-Header in der Antwort aufrufen. Viele HTTP-Clientbibliotheken folgen automatisch der 302-Umleitung und beginnen sofort mit dem Download der Datei.

Zuvor authentifizierte Download-URLs sind nur für einen kurzen Zeitraum (einige Minuten) gültig und erfordern keinen Authorization-Header für den Download.

Beispiel

In diesem Beispiel wird die Version einer Datei auf dem Laufwerk des aktuellen Benutzers abgerufen.

HTTP-Anforderung

GET /me/drive/items/{item-id}/versions/{version-id}/content

Antwort

Diese Methode gibt eine Umleitung zurück, über die der Inhalt der Version heruntergeladen werden kann.

HTTP/1.1 302 Found
Location: https://onedrive.com/34FF49D6...

Hinweise

OneDrive behält nicht die kompletten Metadaten für vorherige Versionen einer Datei bei.

Wenn Ihre App die Liste verfügbarer Versionen für eine Datei abruft, wird eine DriveItemVersion-Ressource zurückgegeben, welche die verfügbaren Informationen zu der jeweiligen Version bereitstellt.