调用Microsoft Graph API获取SharePoint列表项时缺失自定义字段

可能原因 #

1. 人员类型字段的默认返回限制：ProjectMembers属于用户/人员类型的自定义字段，Microsoft Graph API在批量获取列表项时，默认不会返回这类复杂类型字段的内容，而单个获取时则会正常返回，这是API的默认行为差异。
2. 字段内部名称不匹配：自定义字段的显示名和Graph API识别的内部名称可能不一致，比如显示名为ProjectMembers，内部名可能是ProjectMembers_x0020_或其他带后缀的名称。批量请求时必须使用内部名称才能正确获取，单个请求可能存在自动映射逻辑所以能成功。
3. API版本的局限性：v1.0版本的Graph API可能存在批量获取人员字段的bug，beta版本可能已修复该问题。

解决方案 #

• 确认字段内部名称：进入SharePoint列表的「设置」→「列」，找到ProjectMembers字段，查看其内部名称（可通过字段编辑页面的URL获取，URL中Field=后面的字符串就是内部名），将请求中的ProjectMembers替换为内部名称，示例请求：

  GET https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items?expand=fields(select=id,{internal-field-name})
  

• 调整请求语法：尝试将$select和$expand分开使用，明确指定要返回的字段，示例请求：

  GET https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items?$expand=fields&$select=fields/id,fields/{internal-field-name}
  

• 使用beta版本API测试：如果v1.0版本存在bug，切换到beta版本尝试，示例请求：

  GET https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}/items?expand=fields(select=id,ProjectMembers)
  

• 分批获取数据：如果是数据量过大导致字段被截断，使用$top参数分批获取（比如每次取500条），同时配合$skip进行分页，示例请求：

  GET https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items?$expand=fields(select=id,ProjectMembers)&$top=500&$skip=0
  

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