Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog
Generar documento (único)

Volver a la guía principal: todos los tipos de plantillas, parámetros de nodo y campos de salida.

Google Docs

Qué abarca esta guía

Esta guía le muestra cómo fusionar un Google Docs exportado .docx plantilla en n8n usando plantilla-google-docs.docx y google-docs-data.jsonLa plantilla utiliza marcadores de posición de bigote ({{nombre}}, {{curso}}, etc.). Los datos son un JSON matriz con un objeto por fila. Para Generar documento (único), utilice un objeto en el arreglo. La salida puede ser PDF o Word.

Entradas de blog relacionadas
Aún no hay ninguna entrada de blog sobre esta función; estará disponible próximamente.
Mientras tanto, echa un vistazo al blog de PDF4me para encontrar tutoriales y flujos de trabajo para todas las plataformas.
Visita el blog →

Antes de comenzar​

Exportado Google Docs plantilla
Diseña tu plantilla en Google Docs, luego descárguelo como Microsoft Word (.docx)La muestra plantilla-google-docs.docx es un certificado de curso con {{nombre}}, {{curso}}, {{fecha}}, y {{instructor}}.
JSON datos de matriz
Usar google-docs-data.json (recomendado), test.xml, o prueba.csv. Al igual que la combinación de correspondencia, Google Docs Los datos son un matriz de objetosPara un certificado, pegue una matriz con un solo objeto.
PDF4me credencial en n8n
Crear un PDF4me credencial en n8n y pega tu API clave. La misma clave funciona en todos PDF4me nodos en su instancia.

:::nota Google Docs frente a otros tipos de plantillas de Word Google Docs es para .docx archivos exportados desde Google Docs con bigote {{campo}} marcadores de posición. PDF4me Word Plantilla usos <<[fieldName]>> Sintaxis LINQ. Combinación de correspondencia utiliza clásico Word Códigos MERGEFIELD. Seleccione el tipo que coincida con la forma en que se creó su plantilla.

:::

Paquete de archivos de muestra​

Descarga los cuatro archivos a continuación. Uno exportado Google Docs plantilla más tres formatos de datos equivalentes.

¿Qué contienen los archivos de muestra?​

Marcadores de posición en google-docs-template.docx​

La muestra es una certificado de finalización del curso con cuatro campos de combinación de bigotes:

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
Sintaxis de bigotes (exportación a Google Docs) Escriba marcadores de posición directamente en Google Docs como texto plano, por ejemplo {{nombre}}. Después de la exportación a .docx, PDF4me reemplaza cada etiqueta con la correspondiente JSON clave. Este es el mismo estilo de bigote que HTML plantillas, pero el formato del archivo es Word, no HTML.

Mapeo de campos en todos los archivos de datos​

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

A diferencia de PDF4me Word Plantilla, no hay <<[campo]>> etiquetas. A diferencia de la combinación de correspondencia, no hay códigos MERGEFIELD. Claves en su JSON Los objetos de matriz se asignan a {{campo}} marcadores de posición uno a uno.

El flujo de trabajo de un vistazo​

Manual Trigger  →  Read Binary File (google-docs-template.docx)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File
Pasonodo n8nObjetivo
1Disparador manualInicie el flujo de trabajo bajo demanda.
2Leer archivo binarioCargas google-docs-template.docx en propiedad binaria data
3PDF4me → Generar documento (único)Combina plantillas + JSON matriz, salidas PDF o Word
4Escribir archivo binario o Enviar correo electrónico (opcional)Guarda o envía generated_document_output.pdf
Menú desplegable Tipo de archivo de plantilla en el nodo Generar documento (único) de n8n PDF4me que muestra Google Docs entre las opciones de Word, HTML, Formulario PDF y Combinación de correspondencia.

Colocar Tipo de archivo de plantilla a Google Docs. Elegir PDF o Word para Tipo de salida.

Paso 1: Descargue y coloque los archivos de muestra.​

  1. Descargar google-docs-template.docx y google-docs-data.json del Paquete de archivos de muestra arriba.
  2. Guarda la plantilla en algún lugar n8n Puede leerlo (ruta local en servidores propios o almacenamiento en la nube para activadores de producción).
  3. Opcionalmente, descárguelo. test.xml o test.csv para probar otros tipos de datos.

Para usar tu propio documento de Google: ábrelo en Google Docs, elegir Archivo → Descargar → Microsoft Word (.docx)y utiliza ese archivo como plantilla.

Paso 2: Crear el n8n Flujo de trabajo​

  1. En n8n, crear un nuevo flujo de trabajo.
  2. Agregar un Disparador manual nodo.
  3. Agregar un Leer archivo binario nodo después del disparador.
  4. Agregar PDF4me → Generar documento (único) Después de leer el archivo binario.
  5. Conecta tu PDF4me credencial.

:::precaución: El código HTML no es válido aquí Tipo de entrada de archivo de plantilla: HTML Código solo funciona cuando Tipo de archivo de plantilla es HTML. Para Google Docs, usar Binary Data, Base64 Cadena, o URL.

:::

Paso 3: Cargar la plantilla (Read Binary File)​

Configurar el Leer archivo binario nodo:

CampoValor
Ruta del archivoRuta completa a su descarga google-docs-template.docx
Nombre de la propiedaddata (predeterminado; utilizado como Propiedad binaria de plantilla en PDF4me)

Ejecute este nodo una vez y confirme que el elemento de salida muestra datos binarios. data con nombre de archivo google-docs-template.docx.

Paso 4: Configurar PDF4me Generar documento (único)​

Configuración principal​

CampoValorNotas
Credencial para conectarse conSu PDF4me credencialConseguir API llave
RecursoGenerate
Generar operacionesGenerar documento (único)
Tipo de archivo de plantillaGoogle DocsExportado Google Docs .docx con etiquetas de bigote
Tipo de salidaPDF o WordPDF para compartir; Word si el destinatario debe editar el documento combinado

Entrada de plantilla (desde Leer archivo binario)​

CampoValor
Tipo de entrada de archivo de plantillaBinary Data
Propiedad binaria de plantilladata
Nombre del archivo de plantillagoogle-docs-template.docx

Datos del documento (pegar matriz JSON desde google-docs-data.json)​

CampoValor
Tipo de entrada de datos del documentoTexto
Tipo de datos del documentoJSON
Texto de los datos del documentoPegue el contenido completo de google-docs-data.json (ver el bloque a continuación)
[
  {
    "name": "Alice Johnson",
    "course": "Intro to Automation",
    "date": "2026-03-10",
    "instructor": "Mr. Smith"
  }
]

:::importante: el JSON debe ser un array Google Docs Los datos de la plantilla son un JSON matriz, incluso para un solo certificado. Un objeto en el array produce un documento combinado con Generar documento (único).

:::

Opciones de salida​

CampoValor
Mantener el PDF editableDesactivado (predeterminado) cuando el tipo de salida es PDF
Nombre de salida de datos binariosdata (por defecto)

Paso 5: Ejecutar y verificar el resultado.​

  1. Haga clic Ejecutar flujo de trabajo.
  2. Abrir el PDF4me Salida del nodo. Bajo Binario, propiedad abierta data (generated_document_output.pdf o .docx).
  3. Confirme que los cuatro marcadores de posición estén completos:
    • nombre → Alice Johnson
    • curso → Introducción a la automatización
    • fecha → 10/03/2026
    • instructor → Señor Smith

Si un campo está en blanco, compare su JSON claves con las etiquetas de bigote en el exportado .docx personaje por personaje.

Paso 6: Guardar o enviar el resultado (opcional)​

Escribir archivo binario:

CampoValor
Nombre del archivocertificate-output.pdf
Nombre de la propiedad de datosdata
Ruta de salidaCarpeta de destino en su n8n anfitrión

Enviar correo electrónico: adjuntar el binario data de PDF4me como el PDF o Word adjunto.

Formatos de datos alternativos​

Opción A: Archivo JSON como binario (google-docs-data.json)​

  1. Agregar Leer archivo binario para google-docs-data.json (utilizar un Unir nodo si la plantilla y los datos comparten el elemento del flujo de trabajo).
  2. Colocar Tipo de entrada de datos del documento a Binary Data, Tipo de datos del documento a JSON, Propiedad binaria del documento a su campo de datos, Nombre del archivo de datos del documento a google-docs-data.json.

:::precaución: Colisión de nombres de propiedades binarias Si tanto la plantilla como los datos utilizan la propiedad data, uno sobrescribe al otro. Utilice nombres separados (p. ej. template y rowData) o fusionar elementos de dos nodos de lectura de archivos binarios.

:::

Opción B: XML (test.xml)​

Colocar Tipo de datos del documento a XML y pegue un registro (el archivo de ejemplo contiene dos; utilice el primero para una sola ejecución):

<?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>

Los nombres de los elementos coinciden con las claves del bigote y JSON propiedades.

Opción C: CSV (test.csv)​

Colocar Tipo de datos del documento a CSV y pegar (fila de encabezado + una fila de datos):

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

Los encabezados de columna coinciden directamente con los nombres de los marcadores de posición del bigote.

Entrada de plantilla alternativa: URL​

Anfitrión google-docs-template.docx en un público HTTPS URL, luego establecer:

CampoValor
Tipo de entrada de archivo de plantillaURL
URL del archivo de plantillaEnlace público a google-docs-template.docx
Nombre del archivo de plantillagoogle-docs-template.docx

No se requiere el nodo Leer archivo binario. Los datos aún se pueden pegar como Texto de los datos del documento o cargado desde un URL.

Patrones de flujo de trabajo de producción​

Métodos comunes para generar plantillas de Google Docs en producciónOnce the sample test works, replace the Manual Trigger with these patterns.
Fila de Google Sheets a certificado
  1. Las hojas de cálculo se activan al completarse una nueva fila.
  2. Código El nodo envuelve la fila en un JSON matriz: [{"nombre": "...", "curso": "...", ...}].
  3. PDF4me Google Docs con fijo plantilla-google-docs.docx de binario o URL.
  4. Enviar por correo electrónico el combinado PDF al participante.
Activador de carpeta de Dropbox
  1. Nuevo JSON El archivo se encuentra en una carpeta vigilada.
  2. Cargar el fijo Google Docs plantilla de la misma carpeta o una URL.
  3. Pasar el contenido del archivo como datos del documento (Binary Data o Texto).
  4. Cargar salida PDF a una carpeta de salida. Consulte la Zapier blog de trigger para un patrón similar.
Certificados masivos (muchas filas)
  1. Exportar participantes como un JSON matriz (un objeto por persona).
  2. Cambiar a Generar documentos (múltiples) por una PDF por fila.
  3. Mantenga la opción Generar documento (único) cuando solo necesite un archivo combinado por ejecución.

Preguntas frecuentes​

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.

Guías relacionadas​

Back to overviewGoogle Docs workflow (Make)