如何通过SharePoint Graph API获取指定文件夹文档及Description元数据？

要获取指定SharePoint文件夹内的文档列表并包含Description元数据，可通过以下两种有效方法实现：

方法一：修正Filter参数的API调用 #

你之前使用的$$filter是错误格式，正确参数为$filter。同时需确保{folderId}是目标文件夹的DriveItem ID（而非列表项ID），调用示例：

GET https://graph.microsoft.com/v1.0/drives/{driveId}/list/items?expand=driveItem(select=name,id,description)&$filter=parentReference/id eq '{folderId}'

该调用会过滤出指定文件夹下的所有列表项，并展开DriveItem以获取Description元数据。

方法二：通过文件夹路径直接获取子项并展开元数据 #

直接通过文件夹路径定位，同时展开关联的ListItem字段来获取Description，调用示例：

GET https://graph.microsoft.com/v1.0/drives/{driveId}/root:/{folderPath}:/children?expand=listItem(select=fields/Description)&select=name,id,description

如果需要获取更多元数据，可调整fields后的字段列表。此方法无需依赖文件夹ID，直接使用路径即可，且支持应用权限。

权限说明 #

以上两种方法均支持应用权限，只需为你的应用配置Sites.Read.All或Sites.ReadWrite.All应用权限即可。

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