如何通过Graph API实现Office桌面端直接打开SharePoint文档

这个需求完全可以实现，最终效果和网页版Excel自带的「在桌面应用中打开」功能完全一致，不需要申请额外的Graph API特殊权限。

核心原理 #

微软为Office桌面客户端提供了系统级的URI协议唤起能力，你不需要调用额外接口，只需要从已拿到的Graph API文件响应结果中提取必要字段，按规则拼接唤起链接即可。

具体操作步骤 #

• 从当前Graph接口返回的文件元数据中，提取目标Excel文件的webUrl字段，这是文件在SharePoint中的固定访问地址。
• 按照Office官方URI规则拼接Excel唤起链接，格式如下：

  ms-excel:ofe|u|<URL编码后的文件webUrl>
  

  格式说明：
  • ms-excel:是Excel桌面客户端的专属协议标识，Word、PPT对应替换为ms-word:、ms-powerpoint:即可
  • ofe|u|是固定参数，代表打开存储在云端、支持回存编辑的文件
  • 后续拼接的webUrl需要做标准URL编码，避免特殊字符导致客户端解析失败
• 将拼接完成的链接绑定到自研应用的对应功能按钮上即可。用户点击链接时，系统会自动拉起本地安装的Excel桌面客户端，自动校验当前登录账号的文件访问权限，打开后支持直接编辑、实时保存回SharePoint原位置。

你可以先手动拼接一个测试链接粘贴到浏览器地址栏验证，整个拉起流程、打开后的使用体验和网页端触发的效果没有任何区别。

注意事项 #

• 该方案要求用户设备本地安装2016及以上版本的Office桌面客户端，且客户端登录的账号对目标文件拥有对应访问权限，否则会出现拉起失败、无权限访问的问题。
• 不要使用Graph返回的临时下载链接@microsoft.graph.downloadUrl拼接，这类链接有固定有效期，过期后会直接失效；使用webUrl拼接的链接没有有效期限制，只要文件未被删除/移动、用户权限正常就可以一直使用。

内容的提问来源于stack exchange，提问作者Tomas