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 文档,详细了解如何使用 drivedriveItem 资源。 若要详细了解 Microsoft Graph 中的所有资源,请参阅 Microsoft Graph 文档

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