如何在Apps Script中向函数传递电子表格ID/URL参数并解决id无效报错

报错根因 #

Exception: Invalid argument: id 报错出在SpreadsheetApp.openById()调用时，传入的ID参数不符合要求，常见触发场景如下：

• 传入的是完整电子表格URL，没有提取其中的纯ID段
• 传入的纯ID存在多余空格、字符遗漏、拼写错误
• 执行脚本的Google账号对目标电子表格没有查看/编辑权限

修复方案 #

方案1：直接修正传入参数 #

电子表格的有效ID是URL中d/和下一个/之间的字符串，示例URL https://docs.google.com/spreadsheets/d/14TJ9n_hRH_2sfUr7DKljRNnLoJ9UKUD1aMeR-f5pQig/edit中，14TJ9n_hRH_2sfUr7DKljRNnLoJ9UKUD1aMeR-f5pQig就是有效ID，确认你传入的参数和这个ID完全一致、无多余字符，且当前账号有权限访问目标表格即可。

方案2：兼容URL/ID双参数输入 #

如果你希望函数可以同时接收完整URL或者纯ID自动识别，修改代码如下：

function pasteDailyTotals(sourceInput) {
  // 自动识别提取ID，URL和纯ID都可正常传入
  const sourceID = sourceInput.includes('/d/') 
    ? sourceInput.match(/\/d\/([a-zA-Z0-9-_]+)/)[1] 
    : sourceInput;
  var sourceS = SpreadsheetApp.openById(sourceID);
  // 后续原有逻辑保持不变
}

function run(){
  // 传纯ID可运行
  pasteDailyTotals("14TJ9n_hRH_2sfUr7DKljRNnLoJ9UKUD1aMeR-f5pQig");
  // 传完整URL也可运行，无需手动提取ID
  // pasteDailyTotals("https://docs.google.com/spreadsheets/d/14TJ9n_hRH_2sfUr7DKljRNnLoJ9UKUD1aMeR-f5pQig/edit#gid=0");
}

调试方法 #

如果修改后仍报错，可在openById前添加日志打印语句，核对输出的ID是否正确：

console.log("提取到的表格ID：", sourceID);

执行脚本后在编辑器的「执行日志」栏即可查看ID输出，手动和目标表格ID核对即可定位问题。

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