Google Drive API无法在父文件夹中创建文件夹问题求助

排查步骤及修复方法 #

1. 确认父文件夹已共享给服务账号 #

服务账号是独立身份实体，默认无法访问个人Drive或未共享的文件夹。必须手动将父文件夹共享给服务账号邮箱（格式为[服务账号ID]@[项目ID].iam.gserviceaccount.com），至少授予编辑者权限。

2. 核对父文件夹ID的正确性 #

• 父文件夹ID是Drive URL中https://drive.google.com/drive/folders/后的字符串，比如1XyZabcDefGhiJklMnOpQrsTuv
• 检查代码中folderId变量是否有拼写错误、多余空格或引号，确保赋值准确

3. 检查服务账号的权限配置 #

• 在Google Cloud控制台中，确认服务账号已被授予Drive File Creator或Editor角色，仅项目级的Contributor角色可能不足以操作Drive资源
• 确保你的Google Cloud项目已经启用了Drive API（未启用API会导致权限验证失败）

4. 针对共享驱动器（Team Drive）的额外配置 #

如果父文件夹在共享驱动器中：

• 必须将服务账号添加到该共享驱动器，且至少拥有内容管理器权限
• 创建文件夹的代码需要添加supportsAllDrives: true参数：

const folderCreate = await drive.files.create({
  resource: folderMetaData,
  fields: "id",
  supportsAllDrives: true // 共享驱动器必须添加此参数
});

5. 验证服务账号对父文件夹的访问权 #

可以通过以下代码测试服务账号能否正常访问父文件夹：

try {
  const checkAccess = await drive.files.get({
    fileId: folderId,
    supportsAllDrives: true // 共享驱动器场景需添加
  });
  console.log("父文件夹可访问:", checkAccess.data.name);
} catch (err) {
  console.error("访问失败原因:", err.message);
}

如果此测试报错，说明服务账号确实无访问权限，回到第一步重新配置共享。

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