Google Docs
O que este guia abrange
Este guia orienta você no processo de fusão de um Google Docs exportado .docx modelo em n8n usando google-docs-template.docx e google-docs-data.jsonO modelo usa espaços reservados para bigodes ({{nome}}, {{curso}}, etc.). Os dados são um JSON variedade com um objeto por linha. Para Gerar Documento (Único), use um objeto na matriz. A saída pode ser PDF ou Word.
Antes de começar
google-docs-template.docx é um certificado de curso com {{nome}}, {{curso}}, {{data}}, e {{instrutor}}.google-docs-data.json (recomendado), test.xml, ou test.csvAssim como a Mala Direta, Google Docs dados são um matriz de objetosPara um certificado, cole uma matriz com um único objeto.:::nota Google Docs vs outros tipos de modelos do Word
Google Docs é para .docx arquivos exportados de Google Docs com bigode {{campo}} espaços reservados. PDF4me Word Modelo usa <<[nomeDoCampo]>> Sintaxe LINQ. Mala direta usa clássico Word Códigos MERGEFIELD. Escolha o tipo que corresponde à forma como seu modelo foi criado.
:::
Pacote de Arquivos de Amostra
Faça o download dos quatro arquivos abaixo. Um deles foi exportado. Google Docs modelo mais três formatos de dados equivalentes.
O que há dentro dos arquivos de amostra?
Espaços reservados em google-docs-template.docx
A amostra é uma certificado de conclusão do curso com quatro campos de mesclagem de bigode:
| Mustache placeholder | Certificate label in template | Sample value (google-docs-data.json) |
|---|---|---|
{{name}} | Participant name | Alice Johnson |
{{course}} | Course title | Intro to Automation |
{{date}} | Completion date | 2026-03-10 |
{{instructor}} | Instructor name | Mr. Smith |
:::dica Sintaxe Mustache (exportação para o Google Docs)
Digite os marcadores de posição diretamente em Google Docs como texto simples, por exemplo {{nome}}Após a exportação para .docx, PDF4me substitui cada tag pela correspondente. JSON chave. Este é o mesmo estilo de bigode que HTML modelos, mas o formato do arquivo é Word, não HTML.
:::
Mapeamento de campos em todos os arquivos de dados
| Placeholder | JSON key (google-docs-data.json) | XML element (test.xml) | CSV column (test.csv) | Sample value |
|---|---|---|---|---|
{{name}} | name | name | name | Alice Johnson |
{{course}} | course | course | course | Intro to Automation |
{{date}} | date | date | date | 2026-03-10 |
{{instructor}} | instructor | instructor | instructor | Mr. Smith |
Diferente PDF4me Word Modelo, não há nenhum. <<[campo]>> tags. Ao contrário da Mala Direta, não há códigos MERGEFIELD. Chaves em seu JSON Os objetos de matriz mapeiam para {{campo}} marcadores de posição um para um.
Visão geral do fluxo de trabalho
Manual Trigger → Read Binary File (google-docs-template.docx) → PDF4me Generate Document (Single) → (optional) Write Binary File
| Etapa | nó n8n | Propósito |
|---|---|---|
| 1 | Gatilho manual | Inicie o fluxo de trabalho sob demanda |
| 2 | Ler arquivo binário | Cargas google-docs-template.docx em propriedade binária data |
| 3 | PDF4me → Gerar documento (único) | Mescla o modelo + JSON matriz, saídas PDF ou Word |
| 4 | Escrever arquivo binário ou Enviar e-mail (opcional) | Salva ou envia generated_document_output.pdf |
/generate-document-single-template-file-type.png "Clique para ampliar")
Definir Tipo de arquivo de modelo para Google Docs. Escolher PDF ou Word para Tipo de saída.
Passo 1: Baixe e coloque os arquivos de exemplo.
- Download
google-docs-template.docxegoogle-docs-data.jsondo Pacote de Arquivos de Amostra acima. - Salve o modelo em algum lugar n8n É possível lê-lo (caminho local em servidores próprios ou armazenamento em nuvem para gatilhos de produção).
- Opcionalmente, faça o download.
test.xmloutest.csvpara testar outros tipos de dados.
Para usar seu próprio documento do Google: abra-o em Google Docs, escolher Arquivo → Baixar → Microsoft Word (.docx)E use esse arquivo como seu modelo.
Passo 2: Crie o n8n Fluxo de trabalho
- Em n8nCrie um novo fluxo de trabalho.
- Adicionar um Gatilho manual nó.
- Adicionar um Ler arquivo binário nó após o gatilho.
- Adicionar PDF4me → Gerar documento (único) após ler o arquivo binário.
- Conecte seu PDF4me credencial.
:::cuidado O código HTML não é válido aqui Tipo de entrada do arquivo de modelo: HTML Código só funciona quando Tipo de arquivo de modelo é HTML. Para Google Docs, usar Binary Data, Base64 Corda, ou URL. :::
Passo 3: Carregar o modelo (Read Binary File)
Configure o Ler arquivo binário nó:
| Campo | Valor |
|---|---|
| Caminho do arquivo | Caminho completo para o arquivo baixado. google-docs-template.docx |
| Nome da propriedade | data (padrão; usado como Propriedade binária do modelo em PDF4me) |
Execute este nó uma vez e confirme se o item de saída mostra o valor binário. data com nome de arquivo google-docs-template.docx.
Etapa 4: Configurar PDF4me Gerar documento (único)
Configurações principais
| Campo | Valor | Notas |
|---|---|---|
| Credencial para se conectar com | Seu PDF4me credencial | Pegar API chave |
| Recurso | Generate | |
| Gerar operações | Gerar documento (único) | |
| Tipo de arquivo de modelo | Google Docs | Exportado Google Docs .docx com etiquetas de bigode |
| Tipo de saída | PDF ou Word | PDF para compartilhar; Word se o destinatário precisar editar o documento mesclado |
Entrada de modelo (de Ler arquivo binário)
| Campo | Valor |
|---|---|
| Tipo de entrada de arquivo de modelo | Binary Data |
| Propriedade binária do modelo | data |
| Nome do arquivo de modelo | google-docs-template.docx |
Dados do documento (cole o array JSON de google-docs-data.json)
| Campo | Valor |
|---|---|
| Tipo de entrada de dados do documento | Texto |
| Tipo de dados do documento | JSON |
| Texto dos dados do documento | Cole o conteúdo completo de google-docs-data.json (ver bloco abaixo) |
[
{
"name": "Alice Johnson",
"course": "Intro to Automation",
"date": "2026-03-10",
"instructor": "Mr. Smith"
}
]
:::importante O JSON deve ser uma matriz Google Docs Os dados do modelo são um JSON variedade, mesmo para um único certificado. Um objeto na matriz produz um documento mesclado com Gerar Documento (Único). :::
Opções de saída
| Campo | Valor |
|---|---|
| Manter PDF editável | Desativado (padrão) quando o Tipo de Saída é PDF |
| Nome da saída de dados binários | data (padrão) |
Etapa 5: Execute e verifique o resultado
- Clique Executar fluxo de trabalho.
- Abra o PDF4me Saída do nó. Em Binário, propriedade aberta
data(generated_document_output.pdfou.docx). - Confirme se todos os quatro campos reservados estão preenchidos:
- nome → Alice Johnson
- curso → Introdução à Automação
- data → 10/03/2026
- instrutor → Sr. Smith
Se um campo estiver em branco, compare o seu JSON chaves com as etiquetas de bigode nos exportados .docx caractere por caractere.
Etapa 6: Salvar ou enviar a saída (opcional)
Escrever arquivo binário:
| Campo | Valor |
|---|---|
| Nome do arquivo | certificate-output.pdf |
| Nome da propriedade de dados | data |
| Caminho de saída | Pasta de destino no seu n8n hospedar |
Enviar e-mail: Anexe o binário data de PDF4me como o PDF ou Word anexo.
Formatos de dados alternativos
Opção A: Arquivo JSON como binário (google-docs-data.json)
- Adicionar Ler arquivo binário para
google-docs-data.json(use um Fusão nó se o modelo e os dados compartilharem o item de fluxo de trabalho). - Definir Tipo de entrada de dados do documento para Binary Data, Tipo de dados do documento para JSON, Propriedade binária do documento para o seu campo de dados, Nome do arquivo de dados do documento para
google-docs-data.json.
:::cuidado Conflito de nomes de propriedades binárias
Se o modelo e os dados usarem a propriedade data, um sobrescreve o outro. Use nomes separados (por exemplo, template e rowData) ou mesclar itens de dois nós de Leitura de Arquivo Binário.
:::
Opção B: XML (test.xml)
Definir Tipo de dados do documento para XML e cole um registro (o arquivo de exemplo contém dois; use o primeiro para uma única execução):
<?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>
Os nomes dos elementos correspondem às chaves do bigode e JSON propriedades.
Opção C: CSV (test.csv)
Definir Tipo de dados do documento para CSV e colar (linha de cabeçalho + uma linha de dados):
name,course,date,instructor
"Alice Johnson","Intro to Automation","2026-03-10","Mr. Smith"
Os cabeçalhos das colunas correspondem diretamente aos nomes dos marcadores de posição do bigode.
Entrada de modelo alternativo: URL
Hospedar google-docs-template.docx em público HTTPS URL, então defina:
| Campo | Valor |
|---|---|
| Tipo de entrada de arquivo de modelo | URL |
| URL do arquivo de modelo | Link público para google-docs-template.docx |
| Nome do arquivo de modelo | google-docs-template.docx |
Não é necessário nenhum nó de leitura de arquivo binário. Os dados ainda podem ser colados como Texto dos dados do documento ou carregado de um URL.
Padrões de fluxo de trabalho de produção
Formas comuns de gerar documentos a partir de modelos do Google Docs em produção.Once the sample test works, replace the Manual Trigger with these patterns.
- As planilhas são acionadas quando uma nova linha é concluída.
- Código O nó envolve a linha em um JSON variedade:
[{"nome": "...", "curso": "...", ...}]. - PDF4me Google Docs com fixo
google-docs-template.docxde binário ou URL. - Envie por e-mail o arquivo mesclado PDF ao participante.
- Novo JSON O arquivo é salvo em uma pasta monitorada.
- Carregue o fixo Google Docs modelo da mesma pasta ou um URL.
- Passe o conteúdo do arquivo como dados do documento (Binary Data ou Texto).
- Carregar saída PDF para uma pasta de saída. Veja o Zapier blog de gatilho para um padrão semelhante.
- Participantes de exportação como um JSON matriz (um objeto por pessoa).
- Mudar para Gerar documentos (múltiplos) por um PDF por linha.
- Mantenha a opção Gerar Documento (Único) ativada quando precisar apenas de um arquivo mesclado por execução.
Perguntas frequentes
Guias relacionados
- Visão geral da geração de documento (único): todos os parâmetros, campos de saída e tipos de modelo
- PDF4me Word Modelo:
<<[fieldName]>>sintaxe em vez de bigode - Mala direta: clássico Word Modelos MERGEFIELD
- Gerar documentos (múltiplos): um arquivo de saída por linha em seu JSON variedade
- Google Docs fluxo de trabalho (Make)fluxo manual de quatro etapas em Make