使用DriveApp访问共享云端硬盘时触发getFolderById异常的问题

核心错误原因 #

你传入getFolderById()的ID包含了共享链接里的额外参数?usp，这不是合法的Google Drive文件夹ID。Drive的文件夹/文件ID是一串无参数的纯字符序列，共享链接里的?usp=xxx是权限相关的查询参数，必须去掉。

你的代码里两次调用getFolderById都带了无效的参数后缀：

var driveID = "1U4q5e-6bTxUrqC1yvyGAYQCii4aKcbwA?usp";
var folder = DriveApp.getFolderById(driveID);

var folder = DriveApp.getFolderById('1U4q5e-6bTxUrqC1yvyGAYQCii4aKcbwA?usp');

修正后的代码 #

去掉ID里的?usp后缀，使用纯ID即可正常获取文件夹：

function combineFiles() {
  // 正确的文件夹ID，移除多余的查询参数
  var driveID = "1U4q5e-6bTxUrqC1yvyGAYQCii4aKcbwA";
  var folder = DriveApp.getFolderById(driveID);

  Logger.log(folder.getName()); // 打印文件夹名称验证是否获取成功

  var filesIterator = folder.getFiles();
  if (filesIterator.hasNext()) { // 先判断是否存在文件，避免无文件时抛出异常
    var file = filesIterator.next();
    var fn = file.getName();
    Logger.log(fn);
  }
}

额外排查点 #

如果修正ID后仍报错，可检查以下内容：

• 确认该共享文件夹已被添加到你的Google Drive界面（而非仅通过链接临时访问）
• 确认你对该文件夹拥有至少查看权限
• 如果是团队共享盘，需确保你的账号有权限访问该团队盘，必要时可启用高级Drive Service（Drive）处理团队盘资源

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