Google Drive API搜索异常：仅指定精确文件夹时才可检索内容

核心原因 #

1. Drive全局搜索索引未同步：Google Drive的全局搜索依赖后台索引服务，若文件是近期上传/修改，或索引服务临时异常，会导致无parent限制的全局查询无法命中文件。而指定父文件夹的查询是直接遍历该文件夹的本地文件列表，不依赖全局索引，因此能找到结果。
2. API查询参数误用：'folder-id' in parents仅匹配目标文件夹的直接子项，无法覆盖嵌套子文件夹；而ancestors参数才是用来匹配所有层级父目录的正确字段。

可行解决方案 #

• 用ancestors实现全层级搜索：
  无需递归遍历子文件夹，直接通过ancestors参数搜索根目录下所有层级的文件，查询语句如下：

  'root' in ancestors and name contains 'ZL210109'
  

  若要指定非根文件夹的所有子层级，将root替换为对应文件夹ID即可。
• 强制刷新Drive索引：
  若全局搜索仍无结果，可对目标文件做微小修改（比如临时重命名后改回原名称），或重新上传文件，触发Drive后台重新索引，之后再尝试全局查询。
• 验证索引状态：
  先在Drive网页端直接搜索该文件名，若网页端也搜不到，说明是Drive索引本身的问题，等待一段时间或触发上述刷新操作即可恢复。

内容的提问来源于stack exchange，提问作者Martin Zvarík