如何构造Graph /search/query查询用户是否向大SharePoint列表添加过项

可以通过Graph的/search/query端点实现需求，该API基于SharePoint的搜索索引查询，不受列表视图阈值限制，适合处理超大型列表的统计需求。

构造查询的核心逻辑 #

需要在queryString中组合以下筛选条件，精准定位目标数据：

• siteid:<站点ID>：限定查询范围到目标站点
• listid:<列表ID>：进一步缩小到目标列表
• createdby:<用户ID>：筛选由指定用户创建的项
• contentclass:STS_ListItem：明确只查询列表项类型的内容

完整请求示例 #

发送POST请求到https://graph.microsoft.com/v1.0/search/query，请求体如下：

{
  "requests": [
    {
      "entityTypes": ["listItem"],
      "query": {
        "queryString": "siteid:abc123-xyz-456-def-789ghi listid:jkl012-mno-345-pqr-678stu createdby:user@contoso.com contentclass:STS_ListItem"
      },
      "from": 0,
      "size": 0, // 不需要返回实际项，只统计数量
      "enableTotalResultCount": true // 开启总命中数统计
    }
  ]
}

结果判断 #

在返回的响应中，查看value[0].totalItemsCount字段：

• 若值大于0：说明该用户曾向目标列表添加过项
• 若值等于0：说明该用户未在目标列表中创建过项

注意事项 #

• 搜索索引存在延迟，新创建的列表项通常需要5-15分钟才能被纳入搜索结果
• 需确保调用API的身份拥有Sites.Read.All或更高权限（如Sites.ReadWrite.All）
• createdby参数支持用户的对象ID或UPN，两种格式均可正常匹配

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