能否用同一MS Graph API跨SharePoint、OneDrive、Teams编程检索文件文档

三类平台的文件实际存储位置 #

• 根本不存在物理上互相独立的Teams专属文件存储区，Teams本身只是个前端交互入口，不承担文件存储的核心能力，三类平台的文件底层实际共用同一套存储栈：
  • Teams公开频道、私有频道中共享的文件，实体存储在该Teams团队关联的对应SharePoint站点的专属文档库内
  • Teams一对一聊天、临时群聊（非团队关联频道）中传输的文件，实体存储在文件上传者个人OneDrive for Business的专属聊天文件夹路径下
  • 普通用户自主存在个人OneDrive的文件、企业独立SharePoint站点文档库内的文件，和上述两类Teams场景引用的文件完全共用同一套底层存储基础设施，不存在物理隔离

统一使用MS Graph API实现三类平台检索的可行性 #

• 完全可以基于同一套MS Graph API完成跨三类平台的文件统一检索，不存在需要单独对接的Teams专属文件接口——这也是很多人在Graph Explorer里翻半天找不到对应Teams文件接口的本质原因，从架构设计上就不需要这类独立接口
• 常见的检索实现路径：
  • 全局检索场景：可直接调用Graph的统一搜索接口/search/query，指定检索目标为file类型，接口会自动遍历当前授权主体有权限访问的所有内容，包括个人OneDrive、企业SharePoint站点、Teams关联的所有文件路径，一次调用即可拿到跨三类场景的检索结果
  • 定向遍历场景：可通过/sites系列接口拉取所有有权限访问的SharePoint站点文档库内容（包含Teams团队关联站点的文件），再通过/drive系列接口拉取对应账号个人OneDrive下的所有内容（包含Teams私人聊天路径下的文件），两类接口的返回结构完全统一，不需要做额外的格式转换

权限注意点：所有文件的检索权限完全和访问主体的Office 365权限对齐，只要应用/用户有对应SharePoint、OneDrive的访问权限，就可以直接检索到挂载在这些存储上的Teams场景文件，不需要额外申请Teams专属的文件访问权限。

内容的提问来源于stack exchange，提问作者m.alahdab