Google Doc导出HTML至Gmail格式丢失及邮件合并脚本问题咨询

原因 #

你使用的旧版Documents Feed API导出的HTML，样式多采用类选择器而非内联样式，而Gmail不支持外部样式表或类样式，导致粗体、斜体等格式无法渲染；仅超链接和图片能正常显示是因为它们的HTML标签本身被Gmail支持。

解决方案 #

改用Google Drive API的files.export方法导出HTML，该方法生成的HTML会将样式内联到元素中，完美兼容Gmail渲染。

修改后的导出代码：

// 使用Drive API导出兼容Gmail的HTML
var htmlExport = "https://www.googleapis.com/drive/v3/files/" + docID + "/export?mimeType=text/html";
var param = {
  method: "get",
  headers: {"Authorization": "Bearer " + ScriptApp.getOAuthToken()},
  muteHttpExceptions: true,
};
var htmlExportText = UrlFetchApp.fetch(htmlExport, param).getContentText();

注意：需要在脚本编辑器中启用Drive API：依次点击「资源」→「高级Google服务」，找到「Drive API」并启用。

原因 #

为每个联系人复制文档副本的方式，会产生大量IO操作，导致运行缓慢；直接修改原文档后无法重新读取的问题，是因为DocumentApp的文档对象在内存中是状态关联的，无需手动saveAndClose，但更高效的方式是避免操作文档本身。

解决方案 #

直接在导出的HTML字符串中替换占位符，无需操作Google Doc文档：

1. 在Google Doc模板中使用统一占位符，比如{{姓名}}、{{公司}}
2. 导出HTML后，用字符串替换方法批量替换占位符

示例代码：

// 从Sheet获取联系人数据（示例）
var contactData = {
  name: "张三",
  company: "XX科技"
};

// 导出HTML后替换占位符
var processedHtml = htmlExportText
  .replace(/{{姓名}}/g, contactData.name)
  .replace(/{{公司}}/g, contactData.company);

// 创建包含处理后HTML的草稿
var draftToSend = GmailApp.createDraft(contactEmail, emailSubject, '', {htmlBody: processedHtml + draftEmailBody}).getMessageId();

如果需要更复杂的占位符替换（比如多行、特殊字符），可以用正则表达式进行全局匹配替换。

GmailApp没有提供直接修改现有草稿内容的方法，若必须基于现有草稿修改，可按以下步骤：

1. 获取现有草稿的HTML内容：var existingHtml = GmailApp.getMessageById(draftEmailID).getBody();
2. 对existingHtml进行占位符替换
3. 删除原草稿：GmailApp.getMessageById(draftEmailID).moveToTrash();
4. 创建新的草稿：var newDraft = GmailApp.createDraft(contactEmail, emailSubject, '', {htmlBody: existingHtml}).getMessageId();

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