通过

OneDrive API 入门

  • 项目

本页简要概述了使用 Microsoft Graph 和 OneDrive API 时需要执行的步骤。 若要查看具体演练，请参阅 Microsoft Graph 快速入门。

如果使用的是 SharePoint Server 2016 或未使用 Microsoft Graph，请参阅将 OneDrive API 用于 SharePoint Server 2016 主题。

1.用户身份验证和应用授权

Microsoft Graph 和 OneDrive API 使用 OAuth 2.0 进行授权。 通过完成 OAuth 流，应用会收到访问令牌，这样便能获得一组特定的用户权限，从而有权访问 Microsoft Graph。

应用通过 HTTP 头在每个请求中提供访问令牌：

Authorization: bearer {token}

若要详细了解如何授权应用和获取访问令牌，请参阅 Microsoft Graph 的应用授权。

2.调用资源

在获得授权并收到访问令牌后，应用便可以向 Microsoft Graph 终结点发出请求，以获取 OneDrive 或 SharePoint 资源。 必须知道根资源（如 user、group 或 site）的相对 URL，以及请求获取的目标 drive 资源或 driveItem 资源，才能构造资源 URL。

请求 URL 由以下部分组成：

  • Microsoft Graph 根 URL 和版本 (https://graph.microsoft.com/v1.0)
  • 目标根资源 (/users/{id})
  • 目标 OneDrive API 资源（/drive、/drives/{id}/items/{item-id} 或 /drive/root:/path/to/item）

注意：为简洁起见，整个文档都只使用了部分语法（如 GET /drive/items/{item-id}）。 请在路径前面加上正确的根 URL 和目标根资源作为前缀，以获取完整的资源路径或 URL。

3.继续学习

请查看 GitHub 上的 OneDrive 示例和 GitHub 上的 Microsoft Graph 示例，详细了解如何在 Microsoft Graph 中使用文件。

请仔细阅读 OneDrive API HTTP 文档，详细了解如何使用 drive 和 driveItem 资源。 若要详细了解 Microsoft Graph 中的所有资源，请参阅 Microsoft Graph 文档。

有疑问或需要获得支持吗？ 可以通过 Stack Overflow 和我们文档的 GitHub 问题网页与我们联系。