使用Google Drive API获取文件夹直接子项及父项的问题

问题场景 #

使用Node.js的googleapis包调用Google Drive API v3时遇到两个核心问题：

1. 调用drive.files.list()并指定'${parent}' in parents条件时，会递归返回目标父文件夹的所有后代文件/文件夹，而非仅直接子项
2. 调用drive.files.get()获取文件parents字段时，始终返回root文件夹ID，无法获取文件的实际直接父项

文件结构示例 #

"root"
 - "test"（文件夹，root的直接子项）
  - "test.txt"（文件，test文件夹的直接子项）

问题代码片段 #

列表查询代码（返回所有后代）

const drive = // 已授权的googleapis.google.drive实例

drive.files.list({
    q: `'${rootid}' in parents`,
    fields: `files(id, name, parents)`
})

预期仅返回test文件夹，但实际返回test和test.txt。

获取父项代码（返回root ID）

drive.files.get({
    fileId: someFileId,
    fields: `parents`
})

查询test.txt的父项时，返回root的ID而非test文件夹的ID。

完整业务代码

const { google } = require('googleapis')
const drive = google.drive({
    version: `v3`,
    auth: driveClient,
})

const listFolders = async (foldersOnly = true, parent = `root`) => await drive.files.list({
    q: `'${parent}' in parents ${foldersOnly ? `and mimeType='application/vnd.google-apps.folder'` : ``}`,
    fields: `nextPageToken, files(id, name, parents)`,
})

// 调用示例
listFolders(false).then((r) => console.log(r?.data?.files)).catch(console.log)
listFolders(false, `1MheLbFrr2LIn_KKa7XHDGvw1NVKIWCvY`).then((r) => console.log(r?.data?.files)).catch(console.log)
drive.files.get({
    fileId: `1eRm-efvklMQcsSggdjorOgsWwmeQ07pu`,
    fields: `parents`,
}).then((r) => console.log(r.data)).catch(console.log)

解决方案 #

1. 仅获取直接子项（避免递归返回后代） #

Google Drive API v3默认不会递归返回后代，出现该问题的核心原因是文件被添加到了多个父文件夹中（比如test.txt同时被挂载在root和test文件夹下）。

修正后的列表查询代码，确保仅返回指定父文件夹的直接子项：

const listDirectChildren = async (parentId = 'root', includeFiles = false) => {
  const queryParts = [`'${parentId}' in parents`, 'trashed = false']
  // 可选：仅返回文件夹
  if (!includeFiles) {
    queryParts.push(`mimeType='application/vnd.google-apps.folder'`)
  }
  const res = await drive.files.list({
    q: queryParts.join(' and '),
    fields: 'nextPageToken, files(id, name, parents)',
    orderBy: 'name' // 可选：按名称排序
  })
  return res.data.files
}

如果仍然返回后代，需检查目标文件的父项是否唯一：通过drive.files.get()获取完整的parents数组确认。

2. 正确获取文件的所有父项 #

Google Drive API v3中，files.get()默认只返回第一个父项（若文件被多父挂载，通常优先返回root）。要获取所有父项，需确保请求的fields参数明确指定parents，同时文件存在多个父项时才会返回完整数组。

修正后的获取父项代码：

const getFileParents = async (fileId) => {
  const res = await drive.files.get({
    fileId: fileId,
    fields: 'parents'
  })
  // 返回父项ID数组，无父项则返回空数组
  return res.data.parents || []
}

若返回结果仍不符合预期，需在Google Drive网页端检查文件的「位置」属性，确认实际父文件夹；若存在误挂载，可通过以下代码移除冗余父项：

// 移除文件的指定冗余父项
await drive.files.update({
  fileId: fileId,
  removeParents: unwantedParentId,
  fields: 'id, parents'
})

关键注意事项 #

Google Drive支持多父文件夹特性：一个文件/文件夹可以同时存在于多个父目录中，这会导致'parentId' in parents条件匹配所有包含该父项的文件，包括被手动挂载到该父项的间接后代。

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