Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog
Genera documento (singolo)

Torna alla guida principale: tutti i tipi di modello, i parametri dei nodi e i campi di output

Google Docs

Cosa tratta questa guida

Questa guida ti illustra come unire un Google Docs esportato .docx modello In n8n utilizzando google-docs-template.docx E google-docs-data.jsonIl modello utilizza segnaposto per i baffi {{nome}}, {{corso}}, ecc.). I dati sono un JSON vettore con un oggetto per riga. Per Genera documento (singolo), utilizzare un oggetto nell'array. L'output può essere PDF O Word.

Articoli correlati del blog
Non ci sono ancora post sul blog dedicati a questa funzionalità — in arrivo a breve.
Nel frattempo, dai un'occhiata al blog di PDF4me per trovare tutorial e procedure operative su tutte le piattaforme.
Visita il blog →

Prima di iniziare​

Esportato Google Docs modello
Progetta il tuo modello in Google Docs, quindi scarica come Microsoft Word (.docx)Il campione google-docs-template.docx è un certificato di corso con {{nome}}, {{corso}}, {{data}}, E {{istruttore}}.
JSON dati dell'array
Utilizzo google-docs-data.json (consigliato), test.xml, O test.csv. Come la stampa unione, Google Docs i dati sono un serie di problemiPer un certificato, incolla un array con un singolo oggetto.
PDF4me credenziale in n8n
Crea un PDF4me credenziale in n8n e incolla il tuo API chiave. La stessa chiave funziona su tutti PDF4me nodi nella tua istanza.

:::Nota: confronto tra Google Docs e altri modelli di Word Google Docs è per .docx file esportati da Google Docs con i baffi {{campo}} segnaposto. PDF4me Word Modello usi <<[fieldName]>> Sintassi LINQ. Stampa unione utilizza il classico Word Codici MERGEFIELD. Scegli il tipo che corrisponde alla struttura del tuo modello.

:::

Pacchetto di file di esempio​

Scarica tutti e quattro i file qui sotto. Uno esportato Google Docs modello più tre formati di dati equivalenti.

Cosa contengono i file di esempio?​

Segnaposto in google-docs-template.docx​

Il campione è un attestato di completamento del corso con quattro campi di unione a forma di baffi:

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

:::suggerimento Sintassi Mustache (esportazione in Google Docs) Digita i segnaposto direttamente in Google Docs come testo semplice, ad esempio {{nome}}Dopo l'esportazione in .docx, PDF4me sostituisce ogni tag con il corrispondente JSON chiave. Questo è lo stesso stile di baffi di HTML modelli, ma il formato del file è Word, non HTML.

:::

Mappatura dei campi su tutti i file di dati​

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 differenza di PDF4me Word Modello, non ce ne sono <<[campo]>> tag. A differenza della stampa unione, non ci sono codici MERGEFIELD. Le chiavi nel tuo JSON gli oggetti array mappano a {{campo}} segnaposto uno a uno.

Panoramica del flusso di lavoro​

Manual Trigger  →  Read Binary File (google-docs-template.docx)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File
Fare un passonodo n8nScopo
1Grilletto manualeAvvia il flusso di lavoro su richiesta
2Leggere file binarioCarichi google-docs-template.docx in proprietà binaria data
3PDF4me → Genera documento (singolo)Modello di unione + JSON matrice, output PDF O Word
4Scrivi file binario O Invia e-mail (opzionale)Salva o invia generated_document_output.pdf
Il menu a tendina "Tipo di file modello" nel nodo "Genera documento (singolo)" di n8n PDF4me mostra Google Docs tra le opzioni Word, HTML, modulo PDF e stampa unione.

Impostato Tipo di file modello A Google Docs. Scegliere PDF O Word per Tipo di output.

Passaggio 1: Scarica e posiziona i file di esempio​

  1. Scaricamento google-docs-template.docx E google-docs-data.json dal Pacchetto di file di esempio Sopra.
  2. Salva il modello da qualche parte n8n può leggerlo (percorso locale su hosting autonomo o archiviazione cloud per i trigger di produzione).
  3. Download facoltativo test.xml O test.csv per testare altri tipi di dati.

Per utilizzare il tuo documento Google: aprilo in Google Docs, scegliere File → Scarica → Microsoft Word (.docx)e usa quel file come modello.

Passaggio 2: creare il n8n Flusso di lavoro​

  1. In n8n, creare un nuovo flusso di lavoro.
  2. Aggiungi un Grilletto manuale nodo.
  3. Aggiungi un Leggere file binario nodo dopo il trigger.
  4. Aggiungere PDF4me → Genera documento (singolo) dopo aver letto il file binario.
  5. Collega il tuo PDF4me credenziale.

:::attenzione Il codice HTML non è valido qui Tipo di input del file modello: HTML Codice funziona solo quando Tipo di file modello È HTML. Per Google Docs, utilizzo Binary Data, Base64 Corda, O URL.

:::

Passaggio 3: Carica il modello (Read Binary File)​

Configurare il Leggere file binario nodo:

CampoValore
Percorso del filePercorso completo del file scaricato google-docs-template.docx
Nome della proprietàdata (predefinito; utilizzato come Proprietà binaria del modello In PDF4me)

Esegui questo nodo una volta e verifica che l'elemento di output sia binario data con nome file google-docs-template.docx.

Passaggio 4: Configurare PDF4me Genera documento (singolo)​

Impostazioni principali​

CampoValoreNote
Credenziali per connettersi conTuo PDF4me credenzialeOttenere API chiave
RisorsaGenerate
Generare operazioniGenera documento (singolo)
Tipo di file modelloGoogle DocsEsportato Google Docs .docx con etichette a forma di baffi
Tipo di outputPDF O WordPDF da condividere; Word se il destinatario deve modificare il documento unito

Input del modello (da Leggi file binario)​

CampoValore
Tipo di input del file modelloBinary Data
Proprietà binaria del modellodata
Tempo di creazione del file modellogoogle-docs-template.docx

Dati del documento (incolla l'array JSON da google-docs-data.json)​

CampoValore
Tipo di immissione dati del documentoTesto
Tipo di dati del documentoJSON
Testo dei dati del documentoIncolla l'intero contenuto di google-docs-data.json (vedi il blocco sottostante)
[
  {
    "name": "Alice Johnson",
    "course": "Intro to Automation",
    "date": "2026-03-10",
    "instructor": "Mr. Smith"
  }
]

:::importante: il JSON deve essere un array Google Docs i dati del modello sono un JSON vettore, anche per un singolo certificato. Un oggetto nell'array produce un documento unito con Genera documento (singolo).

:::

Opzioni di output​

CampoValore
Mantieni il PDF modificabileDisattivato (impostazione predefinita) quando il tipo di output è PDF
Nome dell'output dei dati binaridata (predefinito)

Passaggio 5: Eseguire e verificare l'output​

  1. Fare clic Eseguire il flusso di lavoro.
  2. Apri il PDF4me output del nodo. Sotto Binarioproprietà aperta data generated_document_output.pdf O .docx).
  3. Conferma che tutti e quattro i segnaposto siano compilati:
    • nome → Alice Johnson
    • corso → Introduzione all'automazione
    • data → 2026-03-10
    • istruttore → Signor Smith

Se un campo è vuoto, confronta il tuo JSON chiavi con i tag baffi nell'esportazione .docx personaggio per personaggio.

Passaggio 6: Salva o invia l'output (facoltativo)​

Scrivi file binario:

CampoValore
Nome del filecertificate-output.pdf
Nome della proprietà datidata
Percorso di outputCartella di destinazione sul tuo n8n ospite

Invia e-mail: allega il binario data da PDF4me come il PDF O Word allegato.

Formati dati alternativi​

Opzione A: file JSON come binario (google-docs-data.json)​

  1. Aggiungere Leggere file binario per google-docs-data.json (usare un Unire nodo se il modello e i dati condividono l'elemento del flusso di lavoro).
  2. Impostato Tipo di immissione dati del documento A Binary Data, Tipo di dati del documento A JSON, Proprietà binaria del documento al tuo campo dati, Nome del file di dati del documento A google-docs-data.json.

:::attenzione Conflitto di nomi di proprietà binarie Se sia il modello che i dati utilizzano la proprietà data, uno sovrascrive l'altro. Utilizzare nomi separati (ad esempio template E rowData) oppure unisci elementi da due nodi Leggi file binario.

:::

Opzione B: XML (test.xml)​

Impostato Tipo di dati del documento A XML e incolla un record (il file di esempio ne contiene due; usa il primo per una singola esecuzione):

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

I nomi degli elementi corrispondono alle chiavi dei baffi e JSON proprietà.

Opzione C: CSV (test.csv)​

Impostato Tipo di dati del documento A CSV e incolla (riga di intestazione + una riga di dati):

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

Le intestazioni di colonna corrispondono direttamente ai nomi segnaposto dei baffi.

Input alternativo del modello: URL​

Ospite google-docs-template.docx in un luogo pubblico HTTPS URL, quindi impostare:

CampoValore
Tipo di input del file modelloURL
URL del file modelloCollegamento pubblico a google-docs-template.docx
Tempo di creazione del file modellogoogle-docs-template.docx

Non è richiesto alcun nodo Read Binary File. I dati possono comunque essere incollati come Testo dei dati del documento o caricato da un URL.

Modelli di flusso di lavoro di produzione​

Metodi comuni per generare contenuti da modelli di Google Docs in ambiente di produzioneOnce the sample test works, replace the Manual Trigger with these patterns.
Riga per certificato di Fogli Google
  1. I fogli di calcolo si attivano al completamento di una nuova riga.
  2. Codice il nodo avvolge la riga in un JSON vettore: [{"nome": "...", "corso": "...", ...}].
  3. PDF4me Google Docs con fisso google-docs-template.docx da binario o URL.
  4. Inviare un'e-mail alla versione unita PDF al partecipante.
Attivazione della cartella Dropbox
  1. Nuovo JSON Il file viene salvato in una cartella monitorata.
  2. Carica il fisso Google Docs modello dalla stessa cartella o un URL.
  3. Passa il contenuto del file come dati del documento (Binary Data o Testo).
  4. Output di caricamento PDF in una cartella di output. Vedi il Zapier blog di trigger per uno schema simile.
Certificati in blocco (molte righe)
  1. Esportare partecipanti come JSON matrice (un oggetto per persona).
  2. Passa a Genera documenti (multipli) per uno PDF per riga.
  3. Mantieni l'opzione Genera documento (singolo) quando hai bisogno di un solo file unito per ogni esecuzione.

Domande frequenti​

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.

Guide correlate​

Back to overviewGoogle Docs workflow (Make)