如何通过Graph API依据自定义元数据itemid检索SharePoint项

可以通过自定义属性查询，但你当前的请求方式有误——自定义元数据存储在ListItem的Fields中，而非DriveItem本身，直接在/drive/root/children端点用itemid筛选会失效，以下是正确的解决方法：

1. 核心问题说明 #

/drive/root/children返回的是DriveItem资源，默认不会包含自定义元数据字段。你设置的ItemId实际存储在该DriveItem关联的ListItem.Fields里，因此必须通过关联的ListItem字段来筛选。

2. 正确的查询方式 #

方式一：直接查询文档库的列表项（推荐） #

SharePoint文档库本质是一个列表，你可以直接调用列表项端点，结合自定义字段的内部名称进行筛选，同时展开关联的DriveItem获取文件/文件夹信息：

GET https://graph.microsoft.com/v1.0/sites/{siteId}/lists/{documentLibraryListId}/items?$filter=fields/[内部名称] eq 'Z'&$expand=driveItem

• 替换[内部名称]：自定义字段的显示名称（如ItemId）可能和内部名称不一致。你可以在SharePoint文档库的「设置→列→编辑对应列」中，查看地址栏里Field=后的字符串，这就是该字段的内部名称。

方式二：在DriveItem查询中展开ListItem并筛选 #

如果要保留/drive相关端点，可以通过$expand展开ListItem及其Fields，再针对字段进行筛选：

GET https://graph.microsoft.com/v1.0/sites/{siteId}/drive/root/children?$expand=listItem($expand=fields)&$filter=listItem/fields/[内部名称] eq 'Z'

• 注意：部分自定义字段需要在SharePoint字段设置中勾选「允许在列表视图中筛选」，才能支持OData筛选。

3. 验证字段存储状态 #

你当前的更新代码是正确的，但可以先调用以下接口确认自定义字段是否已成功写入：

GET https://graph.microsoft.com/v1.0/sites/{siteId}/drives/{driveId}/items/{fileItemId}/listItem/fields

返回结果中如果能看到ItemId字段和对应值，说明存储没问题，只需调整查询方式即可。

代码示例（Graph SDK） #

如果用C# SDK实现查询，可参考以下代码：

// 查询文档库列表项并关联DriveItem
var targetItems = await graphClient.Sites[siteId].Lists[documentLibraryListId].Items
    .Request()
    .Filter($"fields/{internalFieldName} eq 'Z'")
    .Expand("driveItem")
    .GetAsync();

// 遍历结果获取DriveItem信息
foreach (var item in targetItems)
{
    var driveItem = item.DriveItem;
    // 处理文件/文件夹逻辑
}

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