n8n com Google Sheets: como conectar e automatizar planilhas
Veja como conectar o n8n ao Google Sheets: credencial OAuth2 no Google Cloud, APIs ativadas, primeiro fluxo com webhook e erros que podem aparecer.
Por Redação Eleven Host · @robson.direitodigital · 28 de outubro de 2026 · 6 min de leitura
Capa da Redação Eleven Host para o guia: n8n com Google Sheets: como conectar e automatizar planilhas Arte: Eleven Host
Para usar o n8n com Google Sheets, use o nó Google Sheets com uma credencial OAuth2 do Google. No n8n instalado no seu servidor, crie o app no Google Cloud Console e ative as APIs do Sheets e do Drive.
Este guia mostra o que o nó faz, como funciona o gatilho de planilha, por que a credencial muda conforme o tipo de n8n e o passo a passo para criar o OAuth2. No fim, um primeiro fluxo e os erros que podem aparecer. Ele parte do n8n já funcionando, como o do guia Instalar n8n na VPS: passo a passo com Docker.
O que o nó Google Sheets faz
Segundo a documentação do n8n, o nó Google Sheets trabalha em dois níveis. No documento (a planilha inteira), ele cria e exclui planilhas. Na aba (sheet), as operações são:
- Append Row: adiciona uma linha.
- Append or Update Row: adiciona uma linha ou atualiza, se ela já existir.
- Clear: limpa os dados.
- Create: cria uma aba.
- Delete: exclui uma aba.
- Delete Rows or Columns: exclui linhas ou colunas.
- Get Row(s): lê linhas.
- Update Row: atualiza uma linha.
Se faltar uma operação, a documentação indica o nó HTTP Request com a credencial do serviço, escolhendo Authentication > Predefined Credential Type.
O gatilho de planilha
Além do nó comum, existe o Google Sheets Trigger, que inicia o fluxo quando a planilha muda. Ele tem três eventos:
- Row added: uma linha foi adicionada.
- Row updated: uma linha foi atualizada.
- Row added or updated: os dois casos.
Isso permite, por exemplo, enviar os dados a outro nó quando uma linha nova entrar na planilha.
Credencial: n8n Cloud ou instalado no servidor
A documentação do n8n recomenda o OAuth2 para conectar o Google. Existem dois caminhos, e a diferença importa:
- Managed OAuth2: o botão "Entrar com o Google" sem configurar nada. Segundo a documentação, ele existe só no n8n Cloud.
- Custom OAuth2: você cria um app OAuth2 próprio no Google Cloud Console. É o caminho do n8n instalado no seu próprio servidor (self-hosted), como numa VPS.
O resto deste guia segue o caminho Custom OAuth2, o do n8n instalado no seu servidor.
Quer um n8n para os seus fluxos? Planos a partir de R$ 19,90/mês no n8n Essencial; confira na loja o que cada plano inclui. Ver planos de n8n
Passo a passo do OAuth2 no Google Cloud
Os nomes das telas abaixo ficam em inglês, como aparecem no Google. Dica de ordem: deixe o n8n aberto em outra aba, na tela de criar a credencial do Google Sheets, porque o passo 4 pede a OAuth Redirect URL que aparece lá.
1. Criar o projeto
No Google Cloud Console, crie um projeto: New project, escolha um nome e clique em Create.
2. Ativar as duas APIs
Vá em APIs & Services > Library e ative a API do Google Sheets e também a Google Drive API. O nó do Sheets exige as duas.
3. Configurar a tela de consentimento
Vá em APIs & Services > OAuth consent screen (Google Auth Platform) e clique em Get started. Preencha o nome do app e o e-mail de suporte. Em Audience, escolha Internal (só para quem é da sua organização Google Workspace) ou External (contas Google em geral). Informe os contatos, aceite a política e clique em Create. Depois, em Branding > Authorized domains, adicione o domínio do seu n8n.
4. Criar o OAuth client ID
Vá em APIs & Services > Credentials > Create credentials > OAuth client ID. Em Application type, escolha Web application. Em Authorized redirect URIs, cole a OAuth Redirect URL que aparece na credencial do n8n.
5. Voltar ao n8n
Copie o Client ID e o Client Secret para a credencial no n8n, clique em Sign in with Google e salve.
O app do tipo External começa em modo de teste (Testing). Nesse modo, só as contas cadastradas como test users (na tela Audience do Google Auth Platform) conseguem autorizar, e o consentimento e os tokens expiram em sete dias. Se o fluxo parar depois de uma semana, reconecte a credencial.
Primeiro fluxo: webhook para Append Row
Um fluxo simples para testar a credencial: um formulário ou webhook recebe os dados e o nó Google Sheets grava cada envio como uma linha.
- Crie o gatilho Webhook, como no guia Webhook no n8n: como criar, testar e colocar no ar.
- Acrescente o nó Google Sheets e escolha a credencial que você criou.
- Em Operation, escolha Append Row, selecione o documento e a aba e mapeie as colunas.
- Execute o fluxo com um envio de teste e confira se a linha apareceu na planilha.
A variação com o Google Sheets Trigger segue a mesma ideia ao contrário: o evento Row added dispara o fluxo, que entrega a linha a outro nó.
Erros comuns
A documentação do n8n e do Google descreve os erros abaixo.
- redirect_uri_mismatch: a redirect URI do Google é diferente da do n8n. Ela precisa ser idêntica, inclusive http ou https e a porta.
- invalid_client: Client ID ou Client Secret errado. Confira se não ficou espaço sobrando ao colar.
- access denied: a conta que tentou autorizar não está entre os test users do app em modo Testing.
- Google hasn't verified this app: aviso comum em app não verificado.
- Lista (array) que não grava: o Sheets precisa de pares chave-valor. Transforme a lista antes, com os nós Split Out, AI Transform ou Code.
- Coluna renomeada: se você mudou o nome de uma coluna depois de configurar o nó, escolha de novo o Mapping Column Mode, para o nó buscar as colunas, e ajuste os parâmetros.
Cuidados com dados e segredos
Uma planilha pode guardar dado pessoal de cliente, e isso entra na LGPD. Dê acesso só a quem precisa.
O Client Secret é um segredo: não cole em grupo, print ou planilha. Se você usa o n8n no Docker, o guia n8n com PostgreSQL: como configurar no Docker Compose mostra como o banco do n8n é configurado, e o guia Atualizar n8n no Docker: passo a passo com backup explica como atualizar com backup.
Checklist da credencial
- Criei o projeto no Google Cloud Console.
- Ativei a API do Google Sheets e a Google Drive API.
- Configurei a tela de consentimento e escolhi Internal ou External.
- Adicionei o domínio do meu n8n em Authorized domains.
- Colei a OAuth Redirect URL do n8n, idêntica, em Authorized redirect URIs.
- Copiei Client ID e Client Secret sem espaço sobrando.
- Cadastrei as contas como test users, se o app está em Testing.
- Dei acesso à planilha só a quem precisa.
- Guardei o Client Secret como segredo.
Quer ver os planos de n8n? Conheça o n8n Essencial, a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Conhecer o n8n
Perguntas frequentes
Preciso criar um app no Google Cloud para usar o n8n com Google Sheets?
No n8n instalado no seu servidor, sim: é preciso criar um app OAuth2 próprio no Google Cloud Console. O Managed OAuth2, sem configurar nada, existe só no n8n Cloud, segundo a documentação.
Quais APIs preciso ativar?
A API do Google Sheets e a Google Drive API. A documentação do n8n diz que o Sheets exige as duas.
Por que a conexão parou depois de sete dias?
Um app External em modo Testing tem consentimento e tokens que expiram em sete dias. Reconecte a credencial no n8n.
O que significa o erro redirect_uri_mismatch?
A redirect URI cadastrada no Google é diferente da usada pelo n8n. Ela precisa ser idêntica, inclusive http ou https e a porta.
