使用GraphApi筛选SharePoint文档lastModifiedDate的问题

需求回顾 #

指定SharePoint目标文件夹，筛选出任意日期后修改的所有文档（适配多租户多站点/驱动器场景）

推荐方案：使用DriveItem列表接口替代Search接口 #

针对你的精准筛选需求，不建议使用Search接口，直接调用DriveItem的列表接口更高效、稳定，且完全匹配多站点/驱动器的场景：

请求示例 #

GET https://graph.microsoft.com/v1.0/sites/{siteId}/drives/{driveId}/root:/TestSharePoint:/children?$filter=lastModifiedDateTime ge 2024-07-16T00:00:00Z&$select=id,name,lastModifiedDateTime,webUrl

参数说明 #

• root:/TestSharePoint:/：直接定位到「Shared Documents」驱动器下的「TestSharePoint」文件夹（替换为你的实际文件夹路径）
• $filter=lastModifiedDateTime ge 2024-07-16T00:00:00Z：筛选指定日期后修改的文件
• $select：按需返回所需字段，减少响应数据量

权限要求 #

当前已有的Files.Read.All或Sites.Selected权限即可满足调用需求。

现有问题排查 #

1. 站点级搜索接口报错（/sites/{siteId}/drives/{driveId}/root/search/query） #

报错「General exception while processing」的核心原因：

• 该接口设计用于驱动器内的全文内容搜索，而非简单的元数据（如修改时间）筛选，强行用它做属性筛选容易触发异常。
• 如果一定要用该接口做搜索，需使用正确的搜索语法，例如：

  {"requests": [{"entityTypes": ["driveItem"],"query": {"queryString": "lastmodified>2024-07-16"}}]}
  

  但仍不推荐，因为其性能和稳定性远不如列表筛选接口。

2. 全局搜索接口region报错（/search/query） #

报错「SearchRequest Invalid (Region is required when request with application permission.)」的排查点：

• 权限缺失：应用权限下调用全局搜索接口需要Search.All应用权限，你当前的权限列表中缺少该权限，需在Azure AD中申请并授予。
• Region参数值错误：需确保region参数与租户实际所在区域匹配，可通过调用GET https://graph.microsoft.com/v1.0/organization查看租户的countryLetterCode字段，填入对应值（例如US、EU、GBR等）。
• Graph Explorer差异：Graph Explorer使用的是用户权限上下文，无需指定Region；而应用权限上下文强制要求该参数，两者逻辑不同。

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