使用Google Drive API写入Shared Drive文件夹时提示“folder not found”问题求助

这个问题我之前帮不少开发者排查过，核心是Shared Drive（共享云端硬盘）的API调用有特殊要求，和个人云端硬盘的逻辑不一样，咱们一步步解决：

1. 必须添加supportsAllDrives: true参数 #

默认情况下，Google Drive API的调用只针对个人云端硬盘，访问Shared Drive需要显式声明支持这个特性。你的代码里缺少了这个关键参数，这是最常见的原因。

修改你的上传代码，在drive.files.create的配置里加上supportsAllDrives: true：

drive.files.create(
  { 
    resource: fileMetadata, 
    media: media, 
    fields: 'id',
    supportsAllDrives: true // 新增这个参数
  }, 
  (err, file) => { 
    if (err) { 
      console.error(`Failure`); 
      callback(err); 
    } else { 
      console.log('Success', file.data.id); 
      callback(undefined, "done"); 
    } 
  }
);

2. 确认服务账号的权限配置 #

虽然你已经把服务账号设为文件夹的"内容管理者"，但还有几个细节要检查：

• 确保服务账号不仅被添加到目标文件夹，还能访问整个Shared Drive：有些Shared Drive的设置会限制外部账号访问，即使文件夹权限给了，Drive本身的权限没开也会报错。可以去Shared Drive的「设置」→「成员」里确认服务账号是否在列表中，或者直接把服务账号添加到Shared Drive层级（角色选"内容管理者"即可）。
• 权限生效有延迟：Google Drive的权限同步有时候需要几分钟，设置完别急着测试，等个2-3分钟再试。

3. 验证文件夹ID的正确性 #

仔细核对gSuiteFolder变量对应的ID是否正确：

• Shared Drive里的文件夹ID，是浏览器地址栏中folders/后面的那串字符（比如https://drive.google.com/drive/folders/abc123xyz里的abc123xyz），不要把Shared Drive的ID当成文件夹ID。
• 可以先调用drive.files.get接口测试能不能读取到这个文件夹的信息，同样要加supportsAllDrives: true：

drive.files.get(
  {
    fileId: gSuiteFolder,
    supportsAllDrives: true
  },
  (err, res) => {
    if (err) console.error(err);
    else console.log(res.data);
  }
);

如果这个调用返回"not found"，那说明要么ID错了，要么权限还是没配好。

额外提示 #

如果你的代码需要频繁操作Shared Drive，建议把supportsAllDrives: true作为默认参数配置到Drive客户端初始化里，避免每次调用都要加：

const drive = google.drive({ 
  version: 'v3', 
  auth: driveauth,
  params: { supportsAllDrives: true } // 全局默认参数
});

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