跳到主要内容
PDF4me API集成知识库扩展API 测试员博客
生成文档（单个）

返回主指南：所有模板类型、节点参数和输出字段

Google Docs

本指南涵盖的内容

本指南将引导您完成合并操作。 Google Docs 导出 .docx 模板 在 n8n 使用 google-docs-template.docx 和 google-docs-data.json该模板使用 胡子占位符 （{{姓名}}， {{课程}}等等）。数据是 JSON 大批 每行一个对象。对于“生成文档（单个）”，请使用 一个物体 在数组中。输出可以是 PDF 或者 Word。

相关博客文章
目前尚无关于此功能的博客文章——敬请期待。
在此期间，您可以浏览 PDF4me 博客，查看适用于各平台的教程和工作流程。
访问博客 →

开始之前​

已出口 Google Docs 模板
在模板中设计您的模板 Google Docs然后下载为 微软 Word （.docx）样本 google-docs-template.docx 这是一份课程证书 {{姓名}}， {{课程}}， {{日期}}， 和 {{讲师}}。
JSON 数组数据
使用 google-docs-data.json （受到推崇的）， 测试.xml， 或者 测试.csv例如邮件合并， Google Docs 数据是一种 对象数组对于单个证书，请粘贴一个包含单个对象的数组。
PDF4me 证书 n8n
创建一个 PDF4me 证书 n8n 并粘贴你的 API 密钥。同一个密钥适用于所有设备。 PDF4me 实例中的节点。

:::注意 Google 文档与其他 Word 模板类型的区别 Google Docs 是为 .docx 从文件导出 Google Docs 留着胡子 {{场地}} 占位符。 PDF4me Word 模板 用途 <<[fieldName]>> LINQ 语法。 邮件合并 使用经典 Word MERGEFIELD 代码。请选择与您的模板构建方式相匹配的类型。

:::

示例文件包​

请下载以下全部四个文件。其中一个文件已导出。 Google Docs 模板加上三种等效数据格式。

示例文件包含哪些内容​

占位符 google-docs-template.docx​

样本是 课程结业证书 四个带有胡子状合并字段：

Mustache placeholderCertificate label in templateSample value (google-docs-data.json)
{{name}}Participant nameAlice Johnson
{{course}}Course titleIntro to Automation
{{date}}Completion date2026-03-10
{{instructor}}Instructor nameMr. Smith

:::提示 Mustache 语法（Google Docs 导出）

直接输入占位符 Google Docs 例如，以纯文本形式。 {{姓名}}导出后 .docx， PDF4me 将每个标签替换为匹配的标签 JSON 关键。这与……的胡须样式相同。 HTML 模板，但文件格式是 Word， 不是 HTML.

:::

所有数据文件中的字段映射​

PlaceholderJSON key (google-docs-data.json)XML element (test.xml)CSV column (test.csv)Sample value
{{name}}namenamenameAlice Johnson
{{course}}coursecoursecourseIntro to Automation
{{date}}datedatedate2026-03-10
{{instructor}}instructorinstructorinstructorMr. Smith

与……不同 PDF4me Word 模板，没有 <<[字段]>> 标签。与邮件合并不同，这里没有 MERGEFIELD 代码。在您的键中 JSON 数组对象映射到 {{场地}} 占位符一一对应。

工作流程概览​

Manual Trigger  →  Read Binary File (google-docs-template.docx)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File
步n8n 节点目的
1手动扳机按需启动工作流程
2读取二进制文件负载 google-docs-template.docx 进入二元属性 data
3PDF4me → 生成文档（单个）合并模板 + JSON 数组，输出 PDF 或者 Word
4写入二进制文件 或者 发送电子邮件 （选修的）保存或发送 generated_document_output.pdf
n8n PDF4me“生成文档（单个）”节点中的“模板文件类型”下拉菜单显示了 Google Docs，以及 Word、HTML、PDF 表单和邮件合并选项。

放 模板文件类型 到 Google Docs。 选择 PDF 或者 Word 为了 输出类型。

步骤 1：下载并放置示例文件​

  1. 下载 google-docs-template.docx 和 google-docs-data.json 从 示例文件包 多于。
  2. 将模板保存到某个位置 n8n 可以读取它（自托管的本地路径，或生产触发器的云存储）。
  3. （可选）下载 test.xml 或者 test.csv 测试其他数据类型。

要使用您自己的 Google 文档：请将其打开 Google Docs， 选择 文件 → 下载 → 微软 Word （.docx）并使用该文件作为模板。

步骤 2：创建 n8n 工作流程​

  1. 在 n8n创建一个新的工作流程。
  2. 添加一个 手动扳机 节点。
  3. 添加一个 读取二进制文件 触发器之后的节点。
  4. 添加 PDF4me → 生成文档（单个） 读取二进制文件之后。
  5. 连接您的 PDF4me 凭证。

注意：此处的 HTML 代码无效 模板文件输入类型： HTML 代码 仅在以下情况下有效 模板文件类型 是 HTML。 为了 Google Docs， 使用 Binary Data， Base64 细绳， 或者 URL.

:::

步骤 3：加载模板（Read Binary File）​

配置 读取二进制文件 节点：

场地价值
文件路径下载文件的完整路径 google-docs-template.docx
物业名称data （默认值；用作 模板二进制属性 在 PDF4me）

执行此节点一次，并确认输出项显示为二进制。 data 文件名 google-docs-template.docx。

步骤 4：配置 PDF4me 生成文档（单个）​

核心设置​

场地价值笔记
用于连接的凭证你的 PDF4me 凭证得到 API 钥匙
资源Generate
生成操作生成文档（单个）
模板文件类型Google Docs已出口 Google Docs .docx 带有胡须标签
输出类型PDF 或者 WordPDF 供分享； Word 如果收件人需要编辑合并后的文档

模板输入（来自读取二进制文件）​

场地价值
模板文件输入类型Binary Data
模板二进制属性data
模板文件名google-docs-template.docx

文档数据（粘贴来自以下位置的 JSON 数组） google-docs-data.json）​

场地价值
文档数据输入类型文本
文档数据类型JSON
文档数据文本粘贴全部内容 google-docs-data.json （见下方方框）
[
  {
    "name": "Alice Johnson",
    "course": "Intro to Automation",
    "date": "2026-03-10",
    "instructor": "Mr. Smith"
  }
]

重要提示：JSON 必须为数组 Google Docs 模板数据是一个 JSON 大批即使只包含一个证书，数组中的一个对象也会使用“生成文档（单个）”功能生成一个合并文档。

:::

输出选项​

场地价值
保持 PDF 可编辑当输出类型为“关闭”（默认）时 PDF
二进制数据输出名称data （默认）

步骤 5：执行并验证输出​

  1. 点击 执行工作流程。
  2. 打开 PDF4me 节点输出。 二进制开放属性 data （generated_document_output.pdf 或者 .docx）。
  3. 请确认所有四个占位符都已填写：
    • 姓名 → 爱丽丝·约翰逊
    • 课程 → 自动化入门
    • 日期 → 2026-03-10
    • 讲师 → 史密斯先生

如果某个字段为空，请比较您的 JSON 导出的键中带有胡子标签。 .docx 逐个角色进行。

步骤 6：保存或发送输出（可选）​

写入二进制文件：

场地价值
文件名certificate-output.pdf
数据属性名称data
输出路径在您的目标文件夹中 n8n 主持人

发送电子邮件： 附加二进制文件 data 从 PDF4me 作为 PDF 或者 Word 依恋。

替代数据格式​

选项 A：JSON 文件为二进制文件（google-docs-data.json）​

  1. 添加 读取二进制文件 为了 google-docs-data.json （使用 合并 如果模板和数据共享工作流项，则为节点）。
  2. 放 文档数据输入类型 到 Binary Data， 文档数据类型 到 JSON， 文档二进制属性 添加到您的数据字段中， 文档数据文件名 到 google-docs-data.json。

:::注意：二进制属性名称冲突

如果模板和数据都使用属性 data一个会覆盖另一个。请使用不同的名称（例如： template 和 rowData或者合并来自两个“读取二进制文件”节点的条目。

:::

选项 B：XML（test.xml）​

放 文档数据类型 到 XML 并粘贴一条记录（示例文件包含两条记录；单次运行使用第一条记录）：

<?xml version="1.0" encoding="UTF-8"?>
<Records>
    <Record>
        <name>Alice Johnson</name>
        <course>Intro to Automation</course>
        <date>2026-03-10</date>
        <instructor>Mr. Smith</instructor>
    </Record>
</Records>

元素名称与 Mustache 键匹配，并且 JSON 特性。

选项 C：CSV（test.csv）​

放 文档数据类型 到 CSV 并粘贴（标题行 + 一行数据）：

name,course,date,instructor
"Alice Johnson","Intro to Automation","2026-03-10","Mr. Smith"

列标题与胡子占位符名称直接匹配。

备选模板输入： URL​

主持人 google-docs-template.docx 在公共场合 HTTPS URL然后设置：

场地价值
模板文件输入类型URL
模板文件 URL公开链接 google-docs-template.docx
模板文件名google-docs-template.docx

不需要“读取二进制文件”节点。数据仍然可以粘贴为 文档数据文本 或从 URL。

生产工作流程模式​

生产环境中从 Google Docs 模板生成内容的常用方法Once the sample test works, replace the Manual Trigger with these patterns.
Google Sheets 行到证书
  1. 表格会在新完成行时触发。
  2. 代码 节点将行包裹在一个 JSON 大批： [{"name": "...", "course": "...", ...}]。
  3. PDF4me Google Docs 固定 google-docs-template.docx 来自二进制或 URL。
  4. 通过电子邮件发送合并后的邮件 PDF 对参与者而言。
Dropbox文件夹触发器
  1. 新的 JSON 文件已放入受监控的文件夹中。
  2. 加载固定 Google Docs 来自同一文件夹的模板或 URL。
  3. 将文件内容作为文档数据传递（Binary Data 或文本）。
  4. 上传输出 PDF 输出到输出文件夹。请参阅 Zapier 触发博客 遵循类似的模式。
批量证书（多行）
  1. 出口参与者 JSON 数组（每人一个对象）。
  2. 切换到 生成文档（多个） 一 PDF 每行。
  3. 如果每次运行只需要一个合并文件，请保留“生成文档（单个）”选项。

常见问题解答​

How is Google Docs different from PDF4me Word Template?+
Google Docs templates are .docx files exported from Google Docs with mustache {{field}} placeholders. PDF4me Word Template uses <<[fieldName]>> LINQ syntax in a native Word .docx. Both accept PDF or Word output, but the placeholder syntax and Template File Type differ.
Do I upload the Google Doc directly?+
No. Export the Google Doc as Microsoft Word (.docx) first, then load that file in n8n as Binary Data or via URL. PDF4me reads the exported .docx, not a live Google Docs link.
Why must JSON be an array?+
Google Docs template data follows the same array pattern as Mail Merge. Generate Document (Single) uses the first row when you pass one object. Generate Documents (Multiple) processes every row and returns multiple output files.
Why is a placeholder blank?+
JSON keys must match mustache tag names exactly, including case. name works; Name or full_name usually does not. Open the exported .docx in Word and search for {{ to list every tag.
PDF or Word output?+
Choose PDF for emailing, archiving, or printing certificates. Choose Word when the recipient needs to edit the merged document after generation.

相关指南​

Back to overviewGoogle Docs workflow (Make)