Graph API全局搜索SharePoint文档版本字段问题咨询

关于全局搜索fields属性的可用字段文档 #

Microsoft Graph全局搜索（/v1.0/search/query）没有单独的文档专门罗列所有可通过fields指定的返回字段。你需要结合两部分内容确认可用字段：

• 目标实体的属性文档：你搜索的是SharePoint文档，对应Graph中的driveItem类型，参考driveItem的属性列表，但只有被SharePoint搜索索引收录的属性才能通过全局搜索的fields参数返回。
• SharePoint搜索架构配置：站点的搜索架构决定了哪些字段会被纳入搜索索引，未被索引的字段即使是driveItem的属性，也无法在全局搜索结果中获取。

版本字段的正确名称及返回问题 #

针对你需要的文档主要版本字符串（如1.0），正确的字段名确实是_UIVersionString，请求未返回该值的常见原因：

1. 字段未加入搜索索引：默认情况下_UIVersionString可能不在SharePoint默认搜索索引字段中。需要通过SharePoint管理员中心或PnP PowerShell将该字段添加到搜索架构的可索引字段集合。
2. 请求格式错误：确保fields数组中正确指定该字段，示例请求payload：

{
  "requests": [
    {
      "entityTypes": ["driveItem"],
      "query": {
        "queryString": "site:https://your-tenant.sharepoint.com/sites/target-site"
      },
      "fields": ["_UIVersionString", "name", "webUrl"]
    }
  ]
}

如果需要完整的版本历史记录，全局搜索无法直接返回，需先通过全局搜索获取driveItem的id，再调用/v1.0/drives/{driveId}/items/{itemId}/versions接口查询详细版本信息。

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