如何用Graph API Search端点精准搜索OneDrive指定文件夹及子内容？

当使用/v1.0/search/query端点搜索OneDrive中test文件夹及其子文件夹时，当前查询会意外匹配到test (1)文件夹的内容，无论是否添加通配符都无法精确限定范围，且代码过滤无法处理分页场景，以下是可行的解决思路：

思路1：使用path字段精确匹配路径前缀 #

利用path字段的精确前缀匹配替代parentLink，可以避免匹配类似命名的文件夹。path格式为/personal/tony/Documents/test/，在查询字符串中用双引号包裹基础路径，再加上通配符覆盖子目录：

{
    "requests": [
        {
            "entityTypes": ["driveItem"],
            "fields": ["id", "name", "path", "lastModifiedDateTime", "webUrl"],
            "query": {
                "queryString": "title:image* AND path:\"/personal/tony/Documents/test/*\""
            },
            "from": 0,
            "size": 100
        }
    ]
}

• 原理：path:"/.../test/*"会严格匹配以/personal/tony/Documents/test/开头的所有路径，而test (1)的路径为/.../test (1)/，不会被匹配。

思路2：通过文件夹ID精确限定范围 #

先获取目标test文件夹的ID和所属Drive ID，再用parentReference相关字段过滤：

1. 调用API获取文件夹核心信息：

GET /me/drive/root:/Documents/test

从返回结果中提取id（文件夹ID）和parentReference/driveId（Drive ID）。

2. 构建精准的搜索请求：

{
    "requests": [
        {
            "entityTypes": ["driveItem"],
            "fields": ["id", "name", "parentReference", "lastModifiedDateTime"],
            "query": {
                "queryString": "title:image* AND (parentReference/driveId:{driveId} AND (parentReference/id:{folderId} OR parentReference/ancestorIds:{folderId}))"
            },
            "from": 0,
            "size": 100
        }
    ]
}

• 原理：parentReference/id:{folderId}匹配文件夹的直接子项，parentReference/ancestorIds:{folderId}匹配所有嵌套子文件夹的项，结合driveId确保范围锁定在当前Drive内，完全不会涉及其他文件夹。

思路3：改用文件夹专属搜索端点 #

放弃全局/search/query，直接使用针对特定文件夹的搜索API，天然限定范围且支持分页：

GET /me/drive/items/{folderId}/search(q='image*')?$top=100&$skip=0

• 优势：无需构建复杂的查询字符串，API本身就会只搜索指定文件夹及其所有子目录的内容，分页直接通过$top和$skip参数处理，完全不需要额外过滤。

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