Google Apps Script邮件合并报错Exception: action not allowed求助

核心错误原因排查 #

你遇到的Exception: action not allowed错误，结合代码和场景，大概率是以下两个原因：

1. 变量重复赋值导致逻辑混乱
   代码中你先给docFinalId赋值了一个固定文档ID，随后又立即用DocumentApp.create覆盖了这个变量：

   var docFinalId = "1fgg_nX-IaN4xOwN7rwey3EX_pGatF136P8GlG0u299w";
   var docFinalId = DocumentApp.create('El Letters').getId();
   

   这行重复赋值完全多余，虽不一定直接触发错误，但会混淆代码逻辑，建议删除第一行。

2. 段落复制触发权限限制
   直接复制模板文档的段落对象（p.copy()）时，若段落包含受保护元素（比如模板段落被设置了编辑权限、嵌入第三方内容，或是带特殊格式的系统元素），即使你是文档所有者，也可能触发Google Apps Script的安全限制，抛出"action not allowed"异常。

修复方案 #

方案1：优化段落复制逻辑（推荐） #

放弃直接复制段落对象，改为提取段落文本后创建新段落，避免复制潜在受限元素：

function createMailMerge(
  firstname,
  lastname,
  school,
  level,
  r,
  w,
  s,
  l,
  status,
  test_date,
  templateParagraphs,
  docFinal){

    templateParagraphs.forEach(function(p){
      // 提取段落文本，创建新段落再替换变量
      var newPara = docFinal.getBody().appendParagraph(p.getText());
      newPara.replaceText("{{first_name}}", firstname)
             .replaceText('{{last_name}}', lastname)
             .replaceText("{{school}}", school)
             .replaceText("{{level}}",level)
             .replaceText("{{r}}", r)
             .replaceText("{{w}}", w)
             .replaceText("{{s}}", s)
             .replaceText("{{l}}", l)
             .replaceText("{{status}}",status)
             .replaceText("{{test_date}}", test_date);
    });

    docFinal.getBody().appendPageBreak()
}

方案2：移除模板文档的保护设置 #

打开你的模板文档（ID：1PBm3Oghmtf7ZPWolCIY9xGkEyW3l3jR4_3olDDaBvMk），执行以下操作：

• 点击顶部菜单栏工具 → 保护文档
• 检查是否有段落或整个文档被设置编辑限制，如有则移除保护
• 确认文档中没有嵌入无法编辑的第三方插件或内容

方案3：减少频繁的文档API调用 #

若数据量较大，频繁调用appendParagraph和replaceText可能触发Google速率限制。可先将所有合并内容拼接成字符串，再一次性添加到文档：

function createLetters() {
  //Ids for docs and sheets 
  var docTemplateId = "1PBm3Oghmtf7ZPWolCIY9xGkEyW3l3jR4_3olDDaBvMk";
  var docFinal = DocumentApp.create('El Letters');
  var ssID = "1DlWAglK8IJwLtBSH-kUtg3rH6bmuS-MGhl0R7JalM5Q";

  //Get the docs and sheet 
  var docTemplate = DocumentApp.openById(docTemplateId);
  var sheet = SpreadsheetApp.openById(ssID).getSheetByName("ELPA Scores");

  var data = sheet.getRange(2, 1, sheet.getLastRow() - 1, sheet.getLastColumn()).getValues();
  // 提取模板文本作为字符串
  var templateText = docTemplate.getBody().getText();
  
  var finalContent = "";

  for(var i =0;i < data.length;i++){
    var row = data[i];
    // 替换所有变量
    var mergedText = templateText.replace("{{first_name}}", row[0])
                                .replace('{{last_name}}', row[1])
                                .replace("{{school}}", row[2])
                                .replace("{{level}}",row[3])
                                .replace("{{r}}", row[4])
                                .replace("{{w}}", row[5])
                                .replace("{{s}}", row[6])
                                .replace("{{l}}", row[7])
                                .replace("{{status}}",row[8])
                                .replace("{{test_date}}", row[9]);
    finalContent += mergedText + "\n\n" + "\f"; // \f 代表分页符
  }

  docFinal.getBody().setText(finalContent);
}

额外检查项 #

• 确认所有关联的Google Sheets和Docs都在你的主账号下，无跨账号权限问题
• 运行脚本时，确保授权弹窗中允许了所有必要权限（比如编辑文档、读取表格数据）

内容的提问来源于stack exchange，提问作者Ian Propst-Campbell