下载 DriveItemVersion 资源的内容

  • 项目

检索某个特定版本的 DriveItem 的内容。

权限

调用此 API 需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） Files.Read、Files.ReadWrite、Files.Read.All、Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All
委派（个人 Microsoft 帐户） Files.Read、Files.ReadWrite、Files.Read.All、Files.ReadWrite.All
应用程序 Files.Read.All、Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All

HTTP 请求

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

响应

返回 302 Found 响应，重定向到文件字节已预先验证的下载 URL。

应用必须遵循响应中的 Location 头，才能下载文件内容。 许多 HTTP 客户端库将自动遵循 302 重定向并立即开始下载文件。

预先验证的下载 URL 仅在较短的一段时间 （几分钟后）内有效，不需要 Authorization 标头即可下载。

示例

本示例检索当前用户驱动器中的文件版本。

HTTP 请求

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

响应

会返回一个重定向链接，可以在其中下载版本的内容。

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

注解

OneDrive 不保留文件以前版本的完整元数据。

当应用程序检索文件的可用版本列表时，将返回 DriveItemVersion 资源，它提供有关特定版本的可用信息。