如何通过AppScript自动填充Google Doc模板时插入带超链接文本

你之前用的纯文本replace方法只能替换无格式内容，Google Docs的可跳转超链接属于富文本属性，需要通过文档服务接口操作文本属性实现，分两种适用场景处理：

场景1：直接替换Google Doc模板内的占位符 #

这是你当前操作Google Doc模板的适配方案，不要直接提取全文字符串做替换，用文档原生API定位占位符后插入带链接的文本：

1. 先替换普通纯文本类占位符，用Body对象自带的replaceText方法即可，比手动提取全文替换更稳定
2. 针对{{WEBSITE}}超链接占位符，循环查找所有匹配位置，删除原占位符后插入展示文本，再给对应文本段绑定跳转链接

完整代码示例：

// 初始化文档对象，如果你是通过模板ID新建副本，就用DocumentApp.openById(你的模板ID)
const doc = DocumentApp.getActiveDocument();
const body = doc.getBody();

// ------------ 配置项 ------------
const name = "你的姓名字段值";
const surname = "你的姓氏字段值";
const websiteDisplayText = "公司官网"; // 占位符位置显示的可点击文本，也可直接填website变量显示域名
const websiteUrl = "https://www.companywebsite.com/home/xxx"; // 实际跳转地址，必须带http/https前缀
// --------------------------------

// 替换普通纯文本占位符
body.replaceText("{{NAME}}", name);
body.replaceText("{{SURNAME}}", surname);

// 循环替换所有{{WEBSITE}}占位符为带超链接的文本
let searchResult = body.findText("{{WEBSITE}}");
while (searchResult) {
  const textElement = searchResult.getElement().asText();
  const startPos = searchResult.getStartOffset();
  const endPos = searchResult.getEndOffsetInclusive();
  // 删除原占位符
  textElement.deleteText(startPos, endPos);
  // 插入展示文本
  textElement.insertText(startPos, websiteDisplayText);
  // 给插入的文本绑定超链接
  textElement.setLinkUrl(
    startPos,
    startPos + websiteDisplayText.length - 1,
    websiteUrl
  );
  // 查找下一个匹配的占位符
  searchResult = body.findText("{{WEBSITE}}", searchResult);
}

注意事项 #

• 跳转链接必须带http://或https://前缀，否则Google Docs不会识别为有效外部链接，点击无法跳转
• 如果模板里{{WEBSITE}}只出现一次，可以去掉循环，只执行一次查找替换逻辑即可

场景2：生成HTML格式邮件正文 #

如果你的emailBody变量是用来拼接HTML邮件内容（后续调用Gmail发件接口时作为htmlBody参数传入），不需要操作Doc富文本接口，直接替换为HTML的a标签即可：

// 普通文本替换保持原有逻辑
emailBody = emailBody.replace(/{{NAME}}/g, ""+name);
emailBody = emailBody.replace(/{{SURNAME}}/g,""+surname);
// 替换为超链接HTML标签
const websiteDisplayText = "公司官网";
const websiteUrl = "https://www.companywebsite.com/home/xxx";
emailBody = emailBody.replace(/{{WEBSITE}}/g, `<a href="${websiteUrl}">${websiteDisplayText}</a>`);

该方案仅适用于HTML邮件场景，直接把这段内容写回Google Doc会把HTML标签当纯文本显示，不会渲染为超链接。

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