Graph API Sites Search返回‘item not found’，是否需特定权限？

执行这类Graph API查询确实需要特定的应用或委派权限——哪怕你是SharePoint站点管理员、能直接访问站点内容，也不等于自动拥有Graph API的调用权限。

具体权限要求（以SharePoint站点/内容查询场景为例） #

• 以用户身份调用（委派权限）：
  • Sites.Read.All：允许读取所有站点内容；若仅需访问特定站点，Sites.Selected（需管理员提前配置站点授权）或Sites.ReadWrite.All更合适
  • Sites.ReadWrite.All：允许读写所有站点内容
• 以服务身份调用（应用权限）：
  • 需管理员在Azure AD中授予Sites.Read.All、Sites.ReadWrite.All或Sites.FullControl.All权限

除权限外的常见排查点 #

• 确认查询的站点ID、列表ID或项目ID是否正确：截图中的“item not found”大概率是资源路径/ID拼写错误，比如站点URL格式不对、ID字符缺失
• 检查资源范围：若查询的是你权限范围外的站点（比如其他站点的内容），即便你是某个站点的管理员，也会触发该错误
• 验证权限生效状态：委派权限需用户重新登录刷新令牌，应用权限需确认管理员已完成Azure AD中的授权流程

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