如何通过Graph API获取SharePoint文档库根目录项的自定义列？

好问题！我之前也碰到过这个坑——直接调用/drive/root/children或者随便加个expand参数确实拿不到自定义列数据，因为这些字段属于SharePoint文档库对应的列表项属性，不是Drive Item默认返回的内容。不过放心，v1.0和beta端点都支持实现这个需求，下面给你两种靠谱的解决方案：

方案1：直接调用文档库列表的项接口（推荐，更灵活） #

SharePoint文档库本质就是一个特殊的列表，所以直接针对列表项请求是最直接的方式：

• 先找到目标文档库的列表ID：
  调用GET https://graph.microsoft.com/v1.0/sites/<site-id>/lists，在返回结果里找到template为documentLibrary的列表，复制它的id。
• 调用列表项接口并指定自定义列：

  GET https://graph.microsoft.com/v1.0/sites/<site-id>/lists/<list-id>/items?expand=fields&select=fields/Title,fields/<你的自定义列内部名称>
  

  👉 重点：这里必须用自定义列的内部名称（不是页面上显示的名称），你可以在SharePoint的列表设置里查看，或者调用GET /lists/<list-id>/columns获取所有列的内部名称。

方案2：通过Drive Item扩展列表项字段 #

如果想保留/drive/root/children的调用路径，需要嵌套扩展listItem资源，因为自定义列存在于列表项的fields里：

GET https://graph.microsoft.com/v1.0/sites/<site-id>/drive/root/children?expand=listItem($expand=fields)&select=id,name,listItem/fields/<你的自定义列内部名称>

这个请求会在每个Drive Item的返回结果里，嵌套带上对应的列表项字段，包括你要的自定义列数据。

几个关键注意事项 #

• 复杂类型列（比如人员、查找列）需要进一步指定字段，比如人员列要写listItem/fields/<人员列内部名称>/email才能拿到邮箱地址
• beta端点的调用逻辑和v1.0完全一致，只是可能包含一些预览阶段的字段，核心功能没有区别
• 如果还是拿不到数据，先检查自定义列的内部名称是否正确，这是最常见的错误原因

举个实际的请求例子，假设自定义列内部名称是ProjectCode：

GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,abc123-def456-ghi789,jkl012-mno345/personal/john_contoso_com/drive/root/children?expand=listItem($expand=fields)&select=id,name,listItem/fields/ProjectCode

这样返回的每个子项里就会包含listItem.fields.ProjectCode，就是你需要的自定义列值了。

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