Ana içeriğe geç
PDF4me APIEntegrasyonlarBilgi BankasıUzantılarAPI Test CihazıBlog
Belge Oluştur (Tekli)

Ana kılavuza geri dön: tüm şablon türleri, düğüm parametreleri ve çıktı alanları

Google Docs

Bu kılavuz neleri kapsıyor?

Bu kılavuz, birleştirme işlemini adım adım açıklıyor. Google Docs ihraç edildi .docx şablon içinde n8n kullanarak google-docs-template.docx Ve google-docs-data.jsonŞablon şu şekilde kullanılır: bıyık yer tutucuları ({{isim}}, {{kurs}}(vb.). Veri bir JSON sıralamak Her satırda bir nesne olacak şekilde. Belge Oluştur (Tekli) için şunu kullanın: bir nesne Dizide. Çıktı şu olabilir: PDF veya Word.

İlgili Blog Yazıları
Bu özellik için henüz bir blog yazısı yok — yakında yayınlanacak.
Bu arada, her platforma yönelik eğitimler ve iş akışları için PDF4me bloguna göz atın.
Blogu ziyaret edin →

Başlamadan Önce​

İhraç edildi Google Docs şablon
Şablonunuzu tasarlayın Google Docsardından şu şekilde indirin: Microsoft Word (.docx)Örnek google-docs-template.docx Bu bir kurs sertifikasıdır. {{isim}}, {{kurs}}, {{tarih}}, Ve {{eğitmen}}.
JSON dizi verileri
Kullanmak google-docs-data.json (tavsiye edilen), test.xml, veya test.csvTıpkı Toplu E-posta gibi, Google Docs veri bir nesne dizisiTek bir sertifika için, tek bir nesne içeren bir diziyi yapıştırın.
PDF4me kimlik belgesi n8n
Bir tane oluşturun PDF4me kimlik belgesi n8n ve yapıştırın API Aynı tuş tüm cihazlarda çalışır. PDF4me Örneğinizdeki düğümler.

:::Not: Google Dokümanlar ile diğer Word şablon türleri arasındaki farklar Google Docs bunun içindir .docx dışa aktarılan dosyalar Google Docs bıyıklı {{alan}} Yer tutucular. PDF4me Word Şablon kullanımlar <<[alanAdı]>> LINQ sözdizimi. Posta Birleştirme klasik yöntemleri kullanıyor Word MERGEFIELD kodları. Şablonunuzun oluşturulma şekline uygun türü seçin.

:::

Örnek Dosya Paketi​

Aşağıdaki dört dosyanın tamamını indirin. Biri dışa aktarıldı. Google Docs Şablon ve üç eşdeğer veri formatı.

Örnek Dosyaların İçeriği​

Yer tutucular google-docs-template.docx​

Örnek bir Kurs tamamlama sertifikası Dört bıyık birleştirme alanı ile:

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

:::ipucu Bıyık sözdizimi (Google Dokümanlar dışa aktarma) Yer tutucuları doğrudan yazın Google Docs örneğin düz metin olarak {{isim}}Dışa aktardıktan sonra... .docx, PDF4me Her etiketi eşleşen etiketle değiştirir. JSON Anahtar. Bu, aynı bıyık stilidir. HTML şablonlar, ancak dosya formatı şu şekildedir: Word, Olumsuz HTML.

:::

Tüm veri dosyalarında alan eşlemesi​

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

Farklı PDF4me Word Şablon, yok <<[alan]>> Etiketler. Posta Birleştirme'nin aksine, MERGEFIELD kodları yoktur. Anahtarlarınız JSON dizi nesneleri eşlenir {{alan}} Yer tutucular bire bir.

İş Akışına Genel Bakış​

Manual Trigger  →  Read Binary File (google-docs-template.docx)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File
Adımn8n düğümüAmaç
1Manuel Tetikleyiciİş akışını isteğe bağlı olarak başlatın
2İkili Dosyayı OkuYükler google-docs-template.docx ikili özelliğe data
3PDF4me → Belge Oluştur (Tekli)Şablonu birleştirir + JSON dizi, çıktılar PDF veya Word
4İkili Dosya Yaz veya E-posta gönder (isteğe bağlı)Kaydeder veya gönderir generated_document_output.pdf
n8n PDF4me Belge Oluştur (Tek) düğümündeki Şablon Dosya Türü açılır menüsünde Word, HTML, PDF Formu ve Posta Birleştirme seçeneklerinin yanı sıra Google Dokümanlar da gösteriliyor.

Ayarlamak Şablon Dosya Türü ile Google Docs. Seçmek PDF veya Word için Çıktı Türü.

Adım 1: Örnek Dosyaları İndirin ve Yerleştirin​

  1. İndirmek google-docs-template.docx Ve google-docs-data.json -den Örnek Dosya Paketi üstünde.
  2. Şablonu bir yere kaydedin. n8n (Kendi sunucunuzda barındırdığınız yerel yol veya üretim tetikleyicileri için bulut depolama alanı) okunabilir.
  3. İsteğe bağlı olarak indirin test.xml veya test.csv Diğer veri türlerini test etmek için.

Kendi Google Dokümanınızı kullanmak için: onu açın. Google Docs, seçmek Dosya → İndir → Microsoft Word (.docx)ve bu dosyayı şablon olarak kullanın.

Adım 2: Oluşturun n8n İş Akışı​

  1. İçinde n8nYeni bir iş akışı oluşturun.
  2. Ekle Manuel Tetikleyici düğüm.
  3. Ekle İkili Dosyayı Oku Tetikleyiciden sonraki düğüm.
  4. Eklemek PDF4me → Belge Oluştur (Tekli) İkili dosyayı okuduktan sonra.
  5. Bağlantınızı kurun. PDF4me kimlik belgesi.

:::Dikkat: HTML kodu burada geçerli değil Şablon Dosyası Giriş Türü: HTML Kod yalnızca şu durumlarda işe yarar Şablon Dosya Türü dır HTML. İçin Google Docs, kullanmak Binary Data, Base64 Sicim, veya URL.

:::

Adım 3: Şablonu Yükle (Read Binary File)​

Yapılandırın İkili Dosyayı Oku düğüm:

AlanDeğer
Dosya Yoluİndirdiğiniz dosyanın tam yolu google-docs-template.docx
Mülk Adıdata (varsayılan; şu amaçla kullanılır: Şablon İkili Özelliği içinde PDF4me)

Bu düğümü bir kez çalıştırın ve çıktı öğesinin ikili veri gösterdiğini doğrulayın. data dosya adı ile google-docs-template.docx.

Adım 4: Yapılandırma PDF4me Belge Oluştur (Tekli)​

Temel ayarlar​

AlanDeğerNotlar
Bağlantı kurmak için kimlik bilgisiSenin PDF4me kimlik belgesiElde etmek API anahtar
KaynakGenerate
Operasyonları OluşturBelge Oluştur (Tekli)
Şablon Dosya TürüGoogle Docsİhraç edildi Google Docs .docx bıyık etiketleriyle
Çıktı TürüPDF veya WordPDF paylaşmak için; Word Alıcının birleştirilmiş belgeyi düzenlemesi gerekip gerekmediği

Şablon girişi (İkili Dosyayı Oku bölümünden)​

AlanDeğer
Şablon Dosyası Giriş TürüBinary Data
Şablon İkili Özelliğidata
Şablon Dosya Adıgoogle-docs-template.docx

Belge verileri (JSON dizisini yapıştırın) google-docs-data.json)​

AlanDeğer
Belge Veri Giriş TürüMetin
Belge Veri TürüJSON
Belge Verileri MetniLütfen aşağıdaki metnin tamamını yapıştırın. google-docs-data.json (aşağıdaki bloğa bakınız)
[
  {
    "name": "Alice Johnson",
    "course": "Intro to Automation",
    "date": "2026-03-10",
    "instructor": "Mr. Smith"
  }
]

:::Önemli: JSON bir dizi olmalıdır Google Docs Şablon verileri bir JSON sıralamakTek bir sertifika için bile. Dizideki her bir nesne, Belge Oluştur (Tekli) seçeneğiyle birleştirilmiş tek bir belge oluşturur.

:::

Çıkış seçenekleri​

AlanDeğer
PDF'i düzenlenebilir halde tutun.Çıkış Türü kapalı olduğunda (varsayılan) PDF
İkili Veri Çıkış Adıdata (varsayılan)

Adım 5: Çalıştırın ve Çıktıyı Doğrulayın​

  1. Tıklamak İş akışını yürüt.
  2. Açın PDF4me Düğüm çıktısı altında. İkiliaçık mülk data (generated_document_output.pdf veya .docx).
  3. Dört yer tutucunun da doldurulmuş olduğundan emin olun:
    • isim → Alice Johnson
    • kurs → Otomasyona Giriş
    • tarih → 2026-03-10
    • eğitmen → Bay Smith

Bir alan boşsa, kendi bilgilerinizle karşılaştırın. JSON Dışa aktarılan dosyalarda bıyık etiketli anahtarlar bulunmaktadır. .docx Karakter karakter.

Adım 6: Çıktıyı Kaydedin veya Gönderin (İsteğe bağlı)​

İkili Dosyayı Yaz:

AlanDeğer
Dosya adıcertificate-output.pdf
Veri Özelliği Adıdata
Çıkış YoluHedef klasörünüzde n8n ev sahibi

E-posta gönder: ikili dosyayı ekle data itibaren PDF4me olarak PDF veya Word EK.

Alternatif Veri Biçimleri​

Seçenek A: JSON dosyası ikili formatta (google-docs-data.json)​

  1. Eklemek İkili Dosyayı Oku için google-docs-data.json (kullanın Birleştir Şablon ve verilerin iş akışı öğesini paylaştığı düğüm).
  2. Ayarlamak Belge Veri Giriş Türü ile Binary Data, Belge Veri Türü ile JSON, Belge İkili Özelliği Veri alanınıza, Belge Veri Dosyası Adı ile google-docs-data.json.

:::Dikkat İkili özellik adı çakışması Hem şablon hem de veri aynı özelliği kullanıyorsa dataBiri diğerinin üzerine yazılır. Ayrı isimler kullanın (örneğin, template Ve rowData) veya iki İkili Dosya Oku düğümünden öğeleri birleştirin.

:::

Seçenek B: XML (test.xml)​

Ayarlamak Belge Veri Türü ile XML ve bir kaydı yapıştırın (örnek dosya iki kayıt içeriyor; tek çalıştırma için ilkini kullanı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>

Öğe adları bıyık tuşlarıyla eşleşiyor ve JSON özellikler.

Seçenek C: CSV (test.csv)​

Ayarlamak Belge Veri Türü ile CSV ve yapıştırın (başlık satırı + bir veri satırı):

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

Sütun başlıkları, bıyık yer tutucu adlarıyla doğrudan eşleşir.

Alternatif Şablon Girişi: URL​

Ev sahibi google-docs-template.docx halka açık bir yerde HTTPS URLArdından şunu ayarlayın:

AlanDeğer
Şablon Dosyası Giriş TürüURL
Şablon Dosyası URL'siHerkese açık bağlantı google-docs-template.docx
Şablon Dosya Adıgoogle-docs-template.docx

"İkili Dosya Oku" düğümüne gerek yoktur. Veriler yine de yapıştırılabilir. Belge Verileri Metni veya bir yerden yüklendi URL.

Üretim İş Akışı Kalıpları​

Üretim ortamında Google Dokümanlar şablonlarından çıktı oluşturmanın yaygın yollarıOnce the sample test works, replace the Manual Trigger with these patterns.
Google Sheets satırından sertifikaya
  1. Yeni satır tamamlandığında sayfalar tetiklenir.
  2. Kod Düğüm, satırı bir sarmal içine alır. JSON sıralamak: [{"name": "...", "course": "...", ...}].
  3. PDF4me Google Docs sabit ile google-docs-template.docx ikiliden veya URL.
  4. Birleştirilmiş e-postayı gönderin PDF katılımcıya.
Dropbox klasör tetikleyicisi
  1. Yeni JSON Dosya izlenen bir klasöre düşüyor.
  2. Sabit olanı yükle Google Docs aynı klasörden bir şablon veya URL.
  3. Dosya içeriğini Belge Verisi olarak iletin (Binary Data veya Metin).
  4. Yükleme çıktısı PDF Çıktı klasörüne. Bakınız Zapier tetikleyici blog benzer bir desen için.
Toplu sertifikalar (çok sayıda satır)
  1. İhracat katılımcıları olarak JSON Dizi (kişi başına bir nesne).
  2. Şuna geçin Belge Oluştur (Birden Fazla) örneğin PDF satır başına.
  3. Her çalıştırmada yalnızca bir birleştirilmiş dosyaya ihtiyacınız olduğunda "Belge Oluştur (Tek)" seçeneğini koruyun.

Sıkça Sorulan Sorular​

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.

İlgili Kılavuzlar​

Back to overviewGoogle Docs workflow (Make)