Zum Hauptinhalt springen

Google Docs

Was dieser Leitfaden umfasst

Diese Anleitung führt Sie durch das Zusammenführen eines Google Docs exportiert .docx Vorlage In n8n Verwendung google-docs-template.docx Und google-docs-data.jsonDie Vorlage verwendet Platzhalter für Schnurrbärte ({{Name}}, {{Kurs}}Daten sind ein JSON Array mit einem Objekt pro Zeile. Verwenden Sie für „Dokument generieren (Einzeln)“ die folgende Funktion: ein Objekt im Array. Die Ausgabe kann sein PDF oder WordDie

Verwandte Blog-Beiträge
Zu dieser Funktion gibt es noch keinen Blogbeitrag – folgt in Kürze.
Schauen Sie sich in der Zwischenzeit im PDF4me-Blog Tutorials und Arbeitsabläufe für alle Plattformen an.
Besuchen Sie den Blog

Bevor Sie beginnen

Exportiert Google Docs Vorlage
Gestalten Sie Ihre Vorlage in Google Docsdann herunterladen als Microsoft Word (.docx)Die Probe google-docs-template.docx ist ein Kurszertifikat mit {{Name}}, {{Kurs}}, {{Datum}}, Und {{Lehrer}}Die
JSON Array-Daten
Verwenden google-docs-data.json (empfohlen), test.xml, oder test.csvÄhnlich wie bei der Serienbrieffunktion Google Docs Daten sind ein Array von ObjektenFür ein Zertifikat fügen Sie ein Array mit einem einzelnen Objekt ein.
PDF4me Berechtigung in n8n
Erstellen Sie einen PDF4me Berechtigung in n8n und fügen Sie Ihren ein API Schlüssel. Derselbe Schlüssel funktioniert für alle PDF4me Knoten in Ihrer Instanz.

:::Hinweis: Google Docs im Vergleich zu anderen Word-Vorlagentypen

[Anmerkung: Google Docs vs. andere Word-Vorlagentypen] Google Docs ist für .docx exportierte Dateien Google Docs mit Schnurrbart {{Feld}} Platzhalter. PDF4me Word Vorlage Verwendung <<[fieldName]>> LINQ-Syntax. Serienbrief verwendet klassische Word MERGEFIELD-Codes. Wählen Sie den Typ, der der Erstellung Ihrer Vorlage entspricht.

:::

Beispieldateipaket

Laden Sie alle vier Dateien unten herunter. Eine exportierte Datei Google Docs Vorlage plus drei gleichwertige Datenformate.

Was ist in den Beispieldateien enthalten?

Platzhalter in google-docs-template.docx

Die Probe ist eine Kursabschlusszertifikat mit vier Schnurrbart-Merge-Feldern:

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

:::Tipp Mustache-Syntax (Google Docs-Export) Platzhalter direkt eingeben in Google Docs als Klartext, zum Beispiel {{Name}}Nach dem Export nach .docx, PDF4me ersetzt jedes Tag durch das passende JSON Schlüssel. Dies ist der gleiche Schnurrbartstil wie HTML Vorlagen, aber das Dateiformat ist Word, nicht HTML.

:::

Feldzuordnung über alle Datendateien hinweg

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

Im Gegensatz PDF4me Word Vorlage, es gibt keine <<[Feld]>> Tags. Im Gegensatz zur Serienbrieffunktion gibt es keine MERGEFIELD-Codes. Geben Sie Ihre Daten in Ihre Felder ein. JSON Array-Objekte werden abgebildet auf {{Feld}} Platzhalter eins zu eins.

Der Arbeitsablauf im Überblick

Manual Trigger → Read Binary File (google-docs-template.docx) → PDF4me Generate Document (Single) → (optional) Write Binary File
Schrittn8n-KnotenZweck
1Manueller AuslöserStarten Sie den Workflow bei Bedarf
2Binärdatei lesenLasten google-docs-template.docx in binäre Eigenschaften data
3PDF4me → Dokument generieren (Einzeln)Zusammenführungsvorlage + JSON Array, Ausgaben PDF oder Word
4Binärdatei schreiben oder E-Mail senden (optional)Speichert oder sendet generated_document_output.pdf
Die Dropdown-Liste „Vorlagendateityp“ im Knoten „Dokument generieren (Einzeln)“ von n8n PDF4me zeigt Google Docs neben den Optionen Word, HTML, PDF-Formular und Serienbrief an.

Satz Vorlagendateityp Zu Google Docs. Wählen PDF oder Word für AusgabetypDie


Schritt 1: Beispieldateien herunterladen und platzieren

  1. Herunterladen google-docs-template.docx Und google-docs-data.json von Beispieldateipaket über.
  2. Speichern Sie die Vorlage irgendwo n8n kann es lesen (lokaler Pfad bei selbst gehosteten Systemen oder Cloud-Speicher für Produktionsauslöser).
  3. Optionaler Download test.xml oder test.csv um andere Datentypen zu testen.

So verwenden Sie Ihr eigenes Google Doc: Öffnen Sie es in Google Docs, wählen Datei → Herunterladen → Microsoft Word (.docx)und verwenden Sie diese Datei als Vorlage.


Schritt 2: Erstellen Sie die n8n Workflow

  1. In n8n, einen neuen Workflow erstellen.
  2. Füge ein Manueller Auslöser Knoten.
  3. Füge ein Binärdatei lesen Knoten nach dem Auslöser.
  4. Hinzufügen PDF4me → Dokument generieren (Einzeln) nach dem Lesen der Binärdatei.
  5. Verbinden Sie Ihr PDF4me BerechtigungDie

:::Achtung: HTML-Code ist hier ungültig.

Dieser HTML-Code ist hier ungültig. Eingabetyp der Vorlagendatei: HTML Code Funktioniert nur wenn Vorlagendateityp Ist HTML. Für Google Docs, verwenden Binary Data, Base64 Zeichenkette, oder URL.

:::


Schritt 3: Vorlage laden (Read Binary File)

Konfigurieren Sie die Binärdatei lesen Knoten:

FeldWert
DateipfadVollständiger Pfad zu Ihrer heruntergeladenen Datei google-docs-template.docx
Name der Immobiliedata (Standardeinstellung; verwendet als Vorlage Binäre Eigenschaft In PDF4me)

Führen Sie diesen Knoten einmal aus und überprüfen Sie, ob das Ausgabeelement Binärdaten anzeigt. data mit Dateinamen google-docs-template.docxDie


Schritt 4: Konfigurieren PDF4me Dokument generieren (Einzeln)

Kerneinstellungen

FeldWertAnmerkungen
Anmeldeinformationen zum Verbinden mitDein PDF4me BerechtigungErhalten API Schlüssel
RessourceGenerate
Operationen generierenDokument generieren (Einzeln)
VorlagendateitypGoogle DocsExportiert Google Docs .docx mit Schnurrbart-Etiketten
AusgabetypPDF oder WordPDF zum Teilen; Word wenn der Empfänger das zusammengeführte Dokument bearbeiten soll

Vorlageneingabe (aus „Binärdatei lesen“)

FeldWert
Eingabetyp der VorlagendateiBinary Data
Vorlage Binäre Eigenschaftdata
Vorlagendateinamegoogle-docs-template.docx

Dokumentdaten (JSON-Array einfügen von google-docs-data.json)

FeldWert
Dokumentdaten-EingabetypText
DokumentdatentypJSON
Dokumentdaten TextFügen Sie den vollständigen Inhalt ein von google-docs-data.json (siehe unten stehenden Block)
[
{
"name": "Alice Johnson",
"course": "Intro to Automation",
"date": "2026-03-10",
"instructor": "Mr. Smith"
}
]

:::Wichtig: JSON muss ein Array sein.

Wichtig: JSON muss ein Array sein. Google Docs Vorlagendaten sind ein JSON ArrayAuch für ein einzelnes Zertifikat. Ein Objekt im Array erzeugt mit „Dokument generieren (Einzeln)“ ein zusammengeführtes Dokument.

:::

Ausgabeoptionen

FeldWert
PDF bearbeitbar lassenAus (Standardeinstellung), wenn Ausgabetyp PDF
Name der Binärdatenausgabedata (Standard)

Schritt 5: Ausführen und Ausgabe überprüfen

  1. Klicken Workflow ausführenDie
  2. Öffne die PDF4me Knotenausgabe. Unter Binäroffenes Grundstück data (generated_document_output.pdf oder .docx).
  3. Bitte prüfen Sie, ob alle vier Platzhalter ausgefüllt sind:
    • Name → Alice Johnson
    • Kurs → Einführung in die Automatisierung
    • Datum → 10.03.2026
    • Lehrer → Herr Smith

Wenn ein Feld leer ist, vergleichen Sie Ihre JSON Schlüssel mit den Schnurrbart-Tags im exportierten .docx Charakter für Charakter.


Schritt 6: Ausgabe speichern oder senden (optional)

Binärdatei schreiben:

FeldWert
Dateinamecertificate-output.pdf
Name der Dateneigenschaftdata
AusgabepfadZielordner auf Ihrem n8n Gastgeber

E-Mail senden: Hängen Sie die Binärdatei an. data aus PDF4me als die PDF oder Word Anhang.


Alternative Datenformate

Option A: JSON-Datei als Binärdatei (google-docs-data.json)

  1. Hinzufügen Binärdatei lesen für google-docs-data.json (verwenden Sie ein Verschmelzen Knoten, falls Vorlage und Daten das Workflow-Element gemeinsam nutzen).
  2. Satz Dokumentdaten-Eingabetyp Zu Binary Data, Dokumentdatentyp Zu JSON, Dokument-Binär-Eigenschaft zu Ihrem Datenfeld, Dokumentdatendateiname Zu google-docs-data.jsonDie

:::Vorsicht: Namenskonflikt bei binären Eigenschaften Wenn sowohl Vorlage als auch Daten diese Eigenschaft verwenden dataDer eine überschreibt den anderen. Verwenden Sie separate Namen (z. B. template Und rowData) oder Elemente aus zwei Read Binary File-Knoten zusammenführen.

:::

Option B: XML (test.xml)

Satz Dokumentdatentyp Zu XML und fügen Sie einen Datensatz ein (die Beispieldatei enthält zwei; verwenden Sie den ersten für einen einzelnen Durchlauf):

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

Die Elementnamen stimmen mit den Mustache-Schlüsseln überein und JSON Eigenschaften.

Option C: CSV (test.csv)

Satz Dokumentdatentyp Zu CSV und einfügen (Kopfzeile + eine Datenzeile):

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

Die Spaltenüberschriften entsprechen direkt den Platzhalternamen.


Alternative Vorlageneingabe: URL

Gastgeber google-docs-template.docx bei einer öffentlichen HTTPS URLdann einstellen:

FeldWert
Eingabetyp der VorlagendateiURL
URL der VorlagendateiÖffentlicher Link zu google-docs-template.docx
Vorlagendateinamegoogle-docs-template.docx

Es wird kein Knoten zum Lesen von Binärdateien benötigt. Daten können weiterhin eingefügt werden als Dokumentdaten Text oder geladen von einem URLDie


Produktionsablaufmuster

Gängige Methoden zur Generierung von Dokumenten aus Google Docs-Vorlagen in der ProduktionOnce the sample test works, replace the Manual Trigger with these patterns.
Google Sheets-Zeile zu Zertifikat
  1. Die Tabellen werden bei jeder neuen abgeschlossenen Zeile ausgelöst.
  2. Code Der Knoten umschließt die Zeile mit einem JSON Array: [{"name": "...", "course": "...", ...}]Die
  3. PDF4me Google Docs mit fest google-docs-template.docx aus Binär- oder URLDie
  4. Die zusammengeführte Datei per E-Mail senden PDF an den Teilnehmer.
Dropbox-Ordner-Trigger
  1. Neu JSON Die Datei landet in einem überwachten Ordner.
  2. Laden Sie die feste Google Docs Vorlage aus demselben Ordner oder eine URLDie
  3. Übergeben Sie den Dateiinhalt als Dokumentdaten (Binary Data oder Text).
  4. Upload-Ausgabe PDF in einen Ausgabeordner. Siehe die Zapier Trigger-Blog für ein ähnliches Muster.
Massenzertifikate (viele Zeilen)
  1. Exportteilnehmer als JSON Array (ein Objekt pro Person).
  2. Wechseln zu Dokumente generieren (mehrere) für einen PDF pro Zeile.
  3. Behalten Sie die Option „Dokument generieren (Einzeln)“ bei, wenn Sie pro Durchlauf nur eine zusammengeführte Datei benötigen.

Häufig gestellte Fragen

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.

Verwandte Leitfäden