如何通过Postman调用Microsoft Graph API按自定义列值搜索SharePoint文档

原请求的核心问题 #

• $filter参数不适用此场景：Microsoft Graph Search API的$filter不支持直接对listItem/fields下的自定义列进行过滤，且all()操作符的用法不符合Search API的过滤规则，Search API主要依赖query参数而非$filter实现精准搜索。
• 自定义列引用错误：直接使用列的显示名称UniqueCustomID大概率无效，SharePoint自定义列在Graph中会使用内部名称（可能和显示名称不同，比如带后缀_x0020_或数字），必须用内部名称才能匹配。

正确实现步骤 #

1. 改用Search API的query参数
   针对自定义列的搜索，需要使用property:value的语法，同时指定entitytypes=driveItem限定只搜索文档：

   GET https://graph.microsoft.com/v1.0/search?q=UniqueCustomID:081212&entitytypes=driveItem
   

2. 确认自定义列的内部名称
   如果上述请求无结果，先获取列的内部名称：

   • 打开SharePoint列表设置，找到目标自定义列，进入列设置页面
   • 查看页面URL，Field=后面的字符串就是内部名称（比如Field=UniqueCustomID_x0020_1）

3. 替换为内部名称后的请求示例
   用内部名称替换显示名称后，请求如下：

   GET https://graph.microsoft.com/v1.0/search?q=UniqueCustomID_x0020_1:081212&entitytypes=driveItem
   

4. 验证权限
   确保调用账号拥有Sites.Read.All或Sites.ReadWrite.All权限，否则无法遍历所有SharePoint站点的内容。

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