入门:将 OneDrive API 用于 SharePoint Server 2016
本文包含不再相关的信息
若要开始将 OneDrive API 用于 SharePoint Server 2016,请按照下列步骤操作。
如果使用的是 Microsoft Graph 或已连接 OneDrive、OneDrive for Business 或 SharePoint Online,请参阅 OneDrive API 入门。
1.验证应用
OneDrive 倾向于使用 OAuth 2.0进行授权/身份验证。 可获取访问令牌,以便向应用授予一组特定的用户权限。 访问令牌通过 HTTP 头提供:
Authorization: bearer {token}
若要获取访问令牌并让用户登录,请参阅 OneDrive for Business 身份验证。
2.相对于 URL 根进行调用
至此,已验证应用,可以相对于下面的 URL 根(加上一个根资源)调用 OneDrive API,从而获取访问令牌了。 有关如何调用 OneDrive API 的示例,请参阅 drive 资源和 driveItem 资源。 除非另有说明,否则 OneDrive API URL 是相对于以下根。
服务 | URL 根 |
---|---|
OneDrive for Business | https://{tenant}-my.sharepoint.com/_api/v2.0 |
SharePoint Online | https://{tenant}.sharepoint.com/{site-relative-path}/_api/v2.0 |
SharePoint Server 2016 | https://{server}/{site-relative-path}/_api/v2.0 |
注意:为简洁起见,整个文档都只使用了部分语法(如 GET /drive/items/{item-id}
)。
请在路径前面加上正确的根 URL 和版本号作为前缀,以获取完整的资源路径或 URL。
3.继续学习
请查看 GitHub 上的 OneDrive 示例,详细了解如何使用 OneDrive API。
请仔细阅读 OneDrive API HTTP 文档,详细了解如何使用 OneDrive API HTTP 终结点中的 drive 和 driveItem 资源。
了解如何使用 path 或 item id 语法寻址 OneDrive 中的项。
有疑问或需要获得支持吗? 可以通过 Stack Overflow 和我们文档的 GitHub 问题网页与我们联系。