能否用Sites.Selected替代Files.Read.All实现指定SharePoint文档搜索？

核心限制说明 #

Microsoft Search API（POST /search/query）的权限要求是硬性规则——即使你在查询中限定了站点/文件夹范围，该端点仍要求租户级权限（如Files.Read.All），无法用Sites.Selected替代。

替代实现方案 #

改用SharePoint站点级的Graph API端点，结合Sites.Selected权限，直接在目标站点的文档库中按DlcDocId搜索：

1. 先配置Sites.Selected权限

   • 由Azure AD管理员为你的应用添加Sites.Selected应用权限
   • 通过Graph API为应用分配目标站点的访问权限（示例命令）：

     POST https://graph.microsoft.com/v1.0/sites/{site-id}/permissions
     Content-Type: application/json
     {
       "roles": ["read"],
       "grantedToIdentities": [{
         "application": {
           "id": "YOUR_APP_ID",
           "displayName": "YOUR_APP_NAME"
         }
       }]
     }
     

2. 按文档ID+文件夹路径搜索
   针对目标站点的文档库，直接查询内置的DlcDocId字段，同时可通过FileDirRef字段限定文件夹路径：

   GET https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{library-id}/items?$filter=DlcDocId eq '{目标文档ID}' and FileDirRef eq '/sites/{站点名称}/{文件夹路径}'&$select=id,webUrl,fields
   

   如果你不知道文档库ID，也可以通过站点的Drive端点搜索：

   GET https://graph.microsoft.com/v1.0/sites/{site-id}/drive/root:/{文件夹路径}:/search(q='DlcDocId:{目标文档ID}')
   

关键优势 #

• 权限范围严格限定在指定站点，符合安全团队要求
• 直接针对目标内容库查询，性能比全局搜索更高效

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