如何用Google表格数据和Drive指定图片自动填充Google Docs并转PDF

问题场景 #

基于Google Apps Script实现的订阅表单，收集用户数据和签名后同步到Sheets，签名图片按提交ID存在Drive指定文件夹。已实现用Sheets数据填充Docs并生成PDF，但添加签名图片替换{signature}占位符后，文档能正常显示内容和图片，但无法生成PDF。

常见原因与解决方案 #

1. 图片未完成渲染就触发PDF转换 #

脚本插入图片后立刻调用PDF转换，此时Docs可能还没完成图片的加载和渲染，导致转换失败。

解决方法：在插入图片后添加短暂延迟，确保Docs完成图片处理。

// 插入签名图片的代码逻辑后，添加延迟
Utilities.sleep(2000); // 延迟2秒，可根据图片大小调整时长

// 再执行PDF转换
const pdfBlob = doc.getAs('application/pdf');

2. 签名图片的权限不足 #

签名图片默认只有上传者或表单提交者有权限，而脚本运行时使用的账号（比如脚本所有者账号）没有访问权限，导致转换PDF时无法读取图片。

解决方法：插入图片前，将图片权限设置为脚本运行账号可访问，或直接开放为“任何人可查看”：

// 根据提交ID找到签名图片
const signatureFile = DriveApp.getFolderById('你的签名文件夹ID').getFilesByName(submitId).next();
// 设置权限为任何人可查看（或指定脚本运行账号邮箱）
signatureFile.setSharing(DriveApp.Access.ANYONE_WITH_LINK, DriveApp.Permission.VIEW);

// 再插入图片到Docs的占位符位置
const body = doc.getBody();
const placeholder = body.findText('{signature}');
if (placeholder) {
  const element = placeholder.getElement();
  const parent = element.getParent();
  const image = parent.insertImage(parent.getChildIndex(element), signatureFile.getBlob());
  // 调整图片大小（可选）
  image.setWidth(150).setHeight(50);
  // 删除占位符文本
  element.removeFromParent();
}

3. 占位符替换逻辑导致文档结构异常 #

直接替换占位符时，如果插入图片的方式破坏了Docs的文档结构（比如在文本节点中直接插入图片未清理占位符），可能导致PDF转换失败。

解决方法：确保占位符文本被完全删除，图片插入到正确的位置：

const body = doc.getBody();
const searchResult = body.findText('{signature}');
if (searchResult) {
  const textElement = searchResult.getElement().asText();
  const startOffset = searchResult.getStartOffset();
  const endOffset = searchResult.getEndOffsetInclusive();
  
  // 删除占位符文本
  textElement.deleteText(startOffset, endOffset);
  
  // 在占位符位置插入图片
  const image = body.insertImage(startOffset, signatureFile.getBlob());
  image.setWidth(150).setHeight(50);
}

4. 改用Drive API导出PDF #

Google Docs内置的getAs('application/pdf')有时会对插入的图片处理异常，改用Drive API的导出功能更稳定。

解决方法：启用Drive API服务后，使用Drive.Files.export生成PDF：

// 先保存文档
doc.saveAndClose();

// 使用Drive API导出PDF
const fileId = doc.getId();
const pdfBlob = Drive.Files.export(fileId, 'application/pdf', {
  alt: 'media'
}).getBlob();

注意：需要在脚本编辑器的“服务”中添加Drive API服务（点击“资源”→“高级Google服务”，启用Drive API）。

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