Google Apps Script‘Service Spreadsheets’报错排查及Excel导入咨询

1. 错误产生原因 #

• SpreadsheetApp.open()仅支持打开Google Sheets格式的文件，你传入的是Excel（.xlsx/.xls）文件，格式不兼容导致服务调用失败。
• 额外风险：DriveApp.getFilesByName().next()如果遇到Drive中存在多个同名文件，会随机获取第一个；如果无匹配文件，会直接抛出找不到文件的异常。

2. 修复方法 & 本地文件加载问题 #

修复Google Drive Excel导入代码 #

修改后的代码通过Drive API将Excel转换为Google Sheets后再导入，解决格式兼容问题：

function importExcelSheet() {
  var fileName = Browser.inputBox("Enter the name of the Excel file to load:");
  var files = DriveApp.getFilesByName(fileName);
  
  if (!files.hasNext()) {
    Browser.msgBox("No file found with that name!");
    return;
  }
  
  var excelFile = files.next();
  // 将Excel转换为Google Sheets格式
  var resource = {
    title: excelFile.getName().replace(/\.[^/.]+$/, ""),
    mimeType: MimeType.GOOGLE_SHEETS,
    parents: [{id: excelFile.getParents().next().getId()}]
  };
  
  var convertedSheet = Drive.Files.copy(resource, excelFile.getId());
  var spreadsheet = SpreadsheetApp.openById(convertedSheet.id);
  var sourceSheet = spreadsheet.getSheets()[0];
  
  var currentSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  // 创建新工作表并复制数据
  var newSheet = currentSpreadsheet.insertSheet(0);
  sourceSheet.getDataRange().copyTo(newSheet.getRange(1,1), SpreadsheetApp.CopyPasteType.PASTE_NORMAL, false);
  
  // 设置工作表名称为YYYY.MMM格式
  var date = new Date();
  var year = date.getFullYear();
  var monthName = Utilities.formatDate(date, "GMT", "MMM");
  newSheet.setName(`${year}.${monthName}`);
  
  // 可选：删除转换后的临时Google Sheets文件
  DriveApp.getFileById(convertedSheet.id).setTrashed(true);
}

function onOpen() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var menuEntries = [{name: "Import Excel Sheet", functionName: "importExcelSheet"}];
  spreadsheet.addMenu("Custom Menu", menuEntries);
}

关键修复点：

• 使用Drive.Files.copy()完成Excel到Google Sheets的格式转换，这是导入Excel的核心步骤。
• 修正insertSheet的错误用法：原代码直接传入sheet对象无效，改为创建新工作表后复制数据。
• 增加文件不存在的判断逻辑，避免无匹配文件时崩溃。

本地文件加载限制 #

Google Apps Script是云端执行环境，无法直接读取本地硬盘文件。可行的替代方案：

• 手动将本地Excel上传到Google Drive，再用上述脚本导入。
• 开发简单的网页界面（通过HtmlService），提供文件上传控件，让用户选择本地文件后自动上传到Drive并执行导入流程。

3. 权限与配置要求 #

• 文件权限：运行脚本的账号必须拥有目标Excel文件的至少查看权限（转换操作需要编辑权限）。
• API配置：你已在Services菜单添加Drive API，这是正确的，Drive.Files.copy()依赖该服务；若未添加，会触发"Drive is not defined"错误。
• 授权流程：第一次运行脚本时，会弹出授权窗口，需允许脚本访问你的Google Drive和Google Sheets服务。
• 团队Drive注意事项：若文件存储在团队Drive，需确保脚本账号有权限访问该团队Drive，Drive API默认支持团队Drive操作。

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