Google Apps Script中onEdit()调用DocumentApp.openById权限问题求助

我是Javascript和Google Apps Script新手，正在开发邮件合并工具：在Spreadsheet手动填写字段后，勾选U列（第21列）的复选框（值变为TRUE），将该行数据存入变量，复制Google Doc模板并替换占位符。单独运行功能函数或复选框逻辑都正常，但合并后执行日志报错：

Exception: You do not have permission to call DocumentApp.openById. Required permissions: https://www.googleapis.com/auth/documents at onEdit(mmt:12:23)

我推测DocumentApp.openById仅支持服务端调用，不确定能不能授权客户端使用；也怀疑和Docs API有关，已经启用Docs API并添加相关OAuth Scope，但问题还是没解决。

精简版代码 #

//@NotOnlyCurrentDoc

function onEdit(e) {
let currentDate = new Date();
var formattedDate = Utilities.formatDate(currentDate, "UTC", "dd/MM/yyyy");

var sheet = e.source.getActiveSheet();
if (sheet.getName() !== "mailMergeData") return;

var row = e.range.getRow();
var col = e.range.getColumn();

 if (col === 21 && row > 3) {
    if (sheet.getRange(row, 22).getValue() == "") {
      var values = sheet.getRange(row, 1, 1, 19).getValues()[0];
        var agentName = values[1];
        var date = values[2];
        var accountNo = values[3];
        var letter = values[17];
        var letterId = values[18];
        var numberofpages = values[19];

        var doc = DocumentApp.openById("letterId");

        var file = DriveApp.getFileById(doc.getId());
        var newDoc = file.makeCopy(accountNo + letter + formattedDate );
        var newDocId =  newDoc.getId()
        doc.saveAndClose();
        newDocFile = DocumentApp.openById(newDocId)
        var body = newDocFile.getBody();

        body.replaceText('{{Agent_Name}}',agentName);
        body.replaceText('{{Date}}',date);
        body.replaceText('{{Account_No}}',accountNo);
        body.replaceText('{{Letter}}',letter);


      }
    }
  }

appsscript.json配置 #

{
  "timeZone": "Europe/London",
  "dependencies": {
    "enabledAdvancedServices": [
      {
        "userSymbol": "Docs",
        "version": "v1",
        "serviceId": "docs"
      },
      {
        "userSymbol": "Drive",
        "version": "v2",
        "serviceId": "drive"
      },
      {
        "userSymbol": "Sheets",
        "version": "v4",
        "serviceId": "sheets"
      }
    ]
  },
 "oauthScopes": [
      "https://www.googleapis.com/auth/spreadsheets.readonly",
      "https://www.googleapis.com/auth/userinfo.email",
      "https://www.googleapis.com/auth/spreadsheets",
      "https://www.googleapis.com/auth/documents.readonly",
      "https://www.googleapis.com/auth/documents"
  ],
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8"
}

核心原因 #

onEdit是简单触发器，它运行时无授权身份，无法调用需要OAuth权限的服务（比如DocumentApp、DriveApp）——哪怕你在appsscript.json里配置了Scope也没用，简单触发器的权限被严格限制，仅能访问当前文档，不能调用外部服务或需要授权的API。

解决方案 #

1. 替换为可安装触发器 #

把onEdit改成普通函数，手动创建可安装的编辑触发器，这样函数运行时会以你的授权身份执行，拥有完整权限。

2. 修正代码中的其他问题 #

• 代码里的DocumentApp.openById("letterId")是硬编码字符串，应该用变量letterId（去掉引号）
• 变量newDocFile未声明，会变成全局变量，建议加上let
• values[19]超出了getRange(row,1,1,19)的范围（19列的索引是0-18），需要调整范围或索引

修改后的代码 #

//@NotOnlyCurrentDoc

function handleCheckboxEdit(e) {
  let currentDate = new Date();
  var formattedDate = Utilities.formatDate(currentDate, "UTC", "dd/MM/yyyy");

  var sheet = e.source.getActiveSheet();
  if (sheet.getName() !== "mailMergeData") return;

  var row = e.range.getRow();
  var col = e.range.getColumn();

  // 仅在复选框被勾选为TRUE时执行
  if (col === 21 && row > 3 && e.value === "TRUE") {
    if (sheet.getRange(row, 22).getValue() === "") {
      var values = sheet.getRange(row, 1, 1, 20).getValues()[0]; // 扩展到20列以获取numberofpages
      var agentName = values[1];
      var date = values[2];
      var accountNo = values[3];
      var letter = values[17];
      var letterId = values[18];
      var numberofpages = values[19];

      // 用变量letterId而非硬编码字符串
      var doc = DocumentApp.openById(letterId);

      var file = DriveApp.getFileById(doc.getId());
      var newDoc = file.makeCopy(`${accountNo}${letter}${formattedDate}`);
      var newDocId = newDoc.getId();
      doc.saveAndClose();
      
      // 声明变量
      let newDocFile = DocumentApp.openById(newDocId);
      var body = newDocFile.getBody();

      body.replaceText('{{Agent_Name}}', agentName);
      body.replaceText('{{Date}}', date);
      body.replaceText('{{Account_No}}', accountNo);
      body.replaceText('{{Letter}}', letter);

      // 标记处理完成，避免重复执行
      sheet.getRange(row, 22).setValue(formattedDate);
    }
  }
}

创建可安装触发器的步骤 #

1. 打开Google Apps Script编辑器
2. 点击左侧「触发器」图标（时钟形状）
3. 点击「添加触发器」按钮
4. 配置参数：
   • 选择运行函数：handleCheckboxEdit
   • 部署类型：「Head」
   • 事件源：「从电子表格」
   • 事件类型：「编辑时」
5. 点击「保存」，按提示完成授权

补充说明 #

• 可安装触发器会使用你的账号权限，确保你对模板文档和目标Drive文件夹有编辑权限
• 建议添加try/catch捕获异常，避免触发器因报错终止
• 第22列的状态标记可防止重复处理同一行数据

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