Google Docs no n8n: crie e edite documentos
Veja as operações Create, Get e Update do nó, como ativar as APIs e criar a credencial OAuth2 na ordem certa, os limites da API e exemplos de documentos gerados pelo fluxo.
Por Redação Eleven Host · @robson.direitodigital · 18 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para a notícia: Google Docs no n8n: crie e edite documentos Arte: Eleven Host
Usar o Google Docs no n8n é criar, ler e editar documentos do Google dentro de um fluxo: o nó Google Docs cria um documento numa pasta do Drive, lê o texto de um documento e aplica edições, como inserir texto, trocar palavras e montar tabelas.
O nó Google Docs tem três operações: Create, Get e Update. Entre as operações do nó não há apagar, listar, compartilhar nem exportar documentos; para reagir a um documento novo, o caminho é o Google Drive Trigger.
Em 18/11/2026, na versão estável n8n 2.48.5, o nó Google Docs trabalha com o recurso Document.
O que o nó Google Docs faz
O nó tem um recurso, Document, com três operações:
- Create: cria um documento novo, com o título que você escolher, num drive e numa pasta do Google Drive. Os campos pedem só o drive, a pasta e o título; o texto do documento pode entrar depois, com a operação Update.
- Get: lê um documento a partir do ID ou do endereço dele. Com a opção Simplify ligada, que é o padrão, devolve o ID e o texto dos parágrafos reunido num só campo,
content. Com ela desligada, devolve a resposta completa da API do Google. - Update: aplica uma lista de ações a um documento existente.
As ações do Update são escolhidas no botão Add Action, cada uma com um objeto e o que fazer com ele:
- Text: Insert e Find and Replace Text;
- Table: Insert; Table Row e Table Column: Insert e Delete;
- Page Break: Insert;
- Header e Footer: Create e Delete;
- Paragraph Bullets: Create e Delete, com os estilos Bullet List, Checkbox List e Numbered List;
- Named Range: Create e Delete;
- Positioned Object: Delete.
O que o nó não faz
Entre as operações do nó, não há apagar documento, listar documentos de uma pasta, mudar o compartilhamento nem exportar para PDF. Como o documento do Google é um arquivo do Drive, o nó Google Drive pode ser uma alternativa; confira no seu n8n quais operações ele oferece. Para o que nenhum nó cobre, a documentação do n8n indica o nó HTTP Request, com Authentication em Predefined Credential Type e a mesma credencial do Google.
Para disparar um fluxo quando um documento aparece numa pasta, o caminho é o Google Drive Trigger: em Trigger On, escolha Changes Involving a Specific Folder; em Watch For, File Created ou File Updated; e, em Options, o File Type Google Docs. Segundo a documentação, depois de salvo e publicado, ele consulta o Drive de tempos em tempos e dispara o fluxo para cada evento que encontra. A própria tela avisa que mudanças em subpastas não disparam o gatilho, exceto no evento Watch Folder Updated.
Para quem serve
Serve para quem gera documentos parecidos com frequência: propostas, contratos de modelo, relatórios, atas. Em vez de copiar e colar, o fluxo cria o documento e preenche o texto com os dados que chegam de um formulário, de uma planilha ou de outro sistema. Se o n8n fica numa VPS própria, o guia completo de servidor VPS explica o que é esse tipo de servidor. O n8n e o Google Docs não fazem parte do catálogo da Eleven Host.
Em plano mensal, a Eleven Host vende servidores VPS. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver planos
Passo 1: projeto no Google Cloud e APIs
Segundo a documentação do n8n, as credenciais do Google para este nó são de dois tipos: OAuth2, que ela recomenda por ser mais disponível e mais fácil de configurar, e Service Account. No n8n Cloud, o Google Docs está entre os nós com Managed OAuth2: o caminho é clicar em Sign in with Google na credencial, sem passar pelo Google Cloud. Em instalações próprias do n8n, o caminho é o OAuth2 personalizado, descrito abaixo.
No Google Cloud Console, crie um projeto, informe o nome e o local e clique em Create. Confira se ele ficou selecionado no seletor de projeto, no topo da tela.
Depois, em APIs & Services > Library, busque e ative (Enable) a Google Docs API. Segundo o n8n, o Google Docs também exige a Google Drive API ativada, então ative as duas.
Passo 2: tela de consentimento
Em APIs & Services > OAuth consent screen, clique em Get started, informe o nome do app e o e-mail de suporte. Em Audience, escolha Internal para usuários do seu Google Workspace ou External para qualquer conta Google. Preencha os e-mails de contato, aceite a política e clique em Create. Em Branding, adicione o domínio da sua instalação do n8n como domínio autorizado e salve.
Atenção ao modo de teste: num app External em status Testing, só as contas cadastradas em Test users conseguem entrar, e o consentimento e os tokens expiram em sete dias. Quando isso acontece, é preciso reconectar a conta na credencial do n8n.
Passo 3: credencial OAuth2 no n8n
A ordem importa, porque o Google pede um endereço que só o n8n mostra. Primeiro, no n8n, adicione o nó Google Docs, crie nele a credencial de OAuth2 do Google Docs e copie a OAuth Redirect URL que aparece nela. Deixe essa janela aberta.
Volte ao Google Cloud, vá em Credentials > + Create credentials > OAuth client ID, escolha Web application e dê um nome. Em Authorized redirect URIs, cole a URL copiada do n8n e clique em Create. O Google mostra o Client ID e o Client Secret.
Cole os dois na credencial do n8n, clique em Sign in with Google, autorize com a conta que vai usar e salve. Recomendamos tratar o Client Secret como senha.
Erros comuns na credencial
redirect_uri_mismatch: a URL de retorno precisa ser idêntica, inclusive protocolo (http ou https) e porta. Copie de novo do n8n.invalid_client: o Client ID ou o Client Secret não batem. Copie de novo do Google, sem espaços sobrando.- App não verificado: adicione a conta Google em Test users, na tela de consentimento.
- Funcionava e parou depois de uma semana: app External em Testing; reconecte a conta na credencial.
Passo 4: criar um documento
Adicione o nó Google Docs, escolha a credencial e deixe Authentication em OAuth2, que aparece como recomendado. Escolha o recurso Document e a operação Create. Os três campos são obrigatórios:
- Drive Name or ID: My Drive, Shared with Me ou um dos drives da conta;
- Folder Name or ID: a pasta, ou / para a raiz;
- Title: o nome do documento.
Para preencher o conteúdo, o Update do passo seguinte pede o ID ou o endereço do documento; confira na saída do Create, no seu n8n, em que campo ele aparece.
Passo 5: ler e editar
Para ler, use Get com Doc ID or URL. Com Simplify ligado, o resultado traz o ID e o texto reunido. Para trabalhar com a estrutura do documento, como os índices das posições, recomendamos desligar o Simplify, que devolve a resposta completa da API.
Para editar, use Update com Doc ID or URL e adicione as ações que quiser. Algumas escolhas de cada ação:
- Text > Insert: escolha o Insert Segment (Header, Body ou Footer), o Insert Location (At End of Specific Position ou At Index) e o Text. At End of Specific Position pode evitar o cálculo do índice; confira no seu n8n.
- Text > Find and Replace Text: informe Old Text, New Text e se deve diferenciar maiúsculas em Match Case.
- Table > Insert: informe Rows e Columns.
Limites da API do Google
Segundo a documentação do Google, a API do Google Docs aceita 3.000 leituras e 600 escritas por minuto por projeto, e 300 leituras e 60 escritas por minuto por usuário em cada projeto. Ao passar disso, a resposta é o erro HTTP 429, e o Google recomenda tentar de novo com espera crescente entre as tentativas.
Recomendamos, em fluxos que geram muitos documentos de uma vez, trabalhar em lotes com uma pausa entre eles.
Combinações para começar
Um exemplo: proposta a partir de formulário. Um gatilho de formulário do n8n recebe nome, empresa e serviço; o Google Docs Create abre um documento com o nome da empresa no título; e o Update com Text > Insert preenche o corpo com os dados recebidos. Confira cada campo no seu n8n antes de ativar.
Um exemplo: documento a partir de planilha. Cada linha de uma planilha vira um relatório: o fluxo lê as linhas, cria um documento por linha e insere o texto. Se a planilha está no Microsoft 365, veja Excel no n8n: leia e grave planilhas do Microsoft 365.
Um exemplo: ata de reunião. O fluxo lê os eventos do dia e cria um documento de ata para cada um, com o título e o horário do evento no texto. Para a parte da agenda, veja Google Calendar no n8n: criar e ler eventos.
Resumo das etapas
A ordem das etapas é: projeto e APIs no Google Cloud, tela de consentimento, credencial OAuth2 (no n8n e no Google Cloud) e, por fim, o nó Google Docs.
Entre os serviços da Eleven Host estão os servidores VPS. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Abrir a loja
Perguntas frequentes
O nó Google Docs edita documentos existentes?
Sim. A operação Update insere e substitui texto, insere tabelas, linhas, colunas e quebras de página e cria ou apaga cabeçalhos, rodapés, marcadores de parágrafo e intervalos nomeados.
Existe gatilho para documento novo no Google Docs?
Para reagir a um documento novo, use o Google Drive Trigger observando uma pasta, com o evento File Created e o tipo de arquivo Google Docs.
Por que preciso ativar a API do Drive?
A documentação do n8n diz que o Google Docs exige a Google Drive API ativada além da própria API; o mesmo vale para o Sheets e o Slides.
Posso usar conta de serviço em vez de OAuth2?
Sim. O nó aceita Service Account, mas a documentação do n8n recomenda o OAuth2 por ser mais fácil de configurar.