如何构造Graph API查询仅返回SharePoint列表项的fields对象？

基础查询逻辑 #

要只获取列表项的fields对象，必须在$select参数中明确指定fields；如果需要过滤特定项，$filter里的字段必须以fields/为前缀，否则Graph API无法识别目标字段。

具体查询示例 #

1. 获取所有列表项的fields对象 #

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

返回结果仅包含id（列表项唯一标识）和fields两个顶级属性，fields内是完整的列表字段数据。

2. 过滤特定项并返回fields对象 #

比如筛选Title等于"项目方案"的列表项：

GET https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items?$select=fields&$filter=fields/Title eq '项目方案'

3. 仅返回fields中的指定字段 #

如果不需要fields里的所有字段，可嵌套指定具体字段（比如只拿Title和Created）：

GET https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items?$select=fields/Title,fields/Created

此时fields对象只会包含你指定的这两个字段。

常见错误排查 #

• 不要直接写$select=Title或$filter=Title eq 'xxx'：这种写法没有指定fields前缀，Graph API会认为你要操作的是列表项的顶级属性（而非自定义字段），导致请求的字段缺失。
• 检查权限：确保访问令牌拥有Sites.Read.All或对应列表的读写权限，权限不足会导致字段无法正常返回。

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