Google Drive no n8n: como enviar e baixar arquivos
Aprenda a usar o Google Drive no n8n: monte a credencial OAuth2, envie e baixe arquivos com o campo binário, compartilhe pastas e corrija os erros mais comuns.
Por Redação Eleven Host · @robson.direitodigital · 3 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o tutorial: Google Drive no n8n: como enviar e baixar arquivos Arte: Eleven Host
O Google Drive no n8n funciona por meio do nó Google Drive, que envia, baixa, busca, move e compartilha arquivos e pastas dentro do seu fluxo. Para usá-lo, você cria uma credencial de acesso à sua conta Google e escolhe a operação.
Veja abaixo o que o nó faz, como montar a credencial OAuth2 passo a passo, como enviar e baixar arquivos com o campo binário, um exemplo de fluxo e os problemas comuns. As informações seguem a documentação atual do n8n.
O que o nó Google Drive faz
O nó trabalha com quatro grupos de operações:
- Arquivo: copiar, criar a partir de texto, apagar, baixar, mover, compartilhar, atualizar e enviar;
- Arquivo e pasta: buscar arquivos e pastas;
- Pasta: criar, apagar e compartilhar;
- Drive compartilhado: criar, apagar, obter um, obter vários e atualizar.
Não existe uma operação "listar arquivos": para listar, use a busca de arquivos e pastas. Para renomear, use a atualização do arquivo, no campo do novo nome. Se o nó não tiver a operação que você quer, a documentação sugere usar o nó HTTP Request para chamar a API do serviço.
Antes de usar o nó, ele precisa de uma credencial: é ela que autoriza o n8n a mexer no seu Drive.
Escolha o tipo de credencial
O n8n aceita dois métodos para o Google Drive e para o Google Drive Trigger: OAuth2 e conta de serviço (Service Account). A documentação recomenda o OAuth2 por estar mais amplamente disponível e ser mais fácil de configurar, e é o que o passo a passo abaixo usa.
O OAuth2 gerenciado existe no n8n Cloud e inclui o Google Drive e o trigger, mas não está disponível para quem hospeda o n8n por conta própria. Quem hospeda cria o próprio acesso no Google Cloud, como nos passos a seguir.
Passo a passo: credencial OAuth2 no Google Cloud
- No Google Cloud Console, crie um projeto ("New project") e deixe-o selecionado.
- Vá em APIs & Services > Library e ative a Google Drive API.
- Configure a tela de consentimento: na aba Overview, clique em "Get started". No público, escolha Internal para uso dentro da organização no Google Workspace, ou External para contas Google em geral.
- Em Branding, preencha a seção "Authorized domains" (
n8n.cloudno n8n Cloud; o domínio da instância, se você hospeda). - Clique em "+ Create credentials", escolha "OAuth client ID" e, como tipo, "Web application".
- No n8n, abra a credencial e copie a "OAuth Redirect URL". Cole essa URL em "Authorized redirect URIs" no Google Cloud.
- Copie o "Client ID" e o "Client Secret" do Google Cloud para a credencial do n8n.
- Clique em "Sign in with Google", autorize o acesso e salve a credencial.
Dois avisos sobre o consentimento
Se você escolher External, o aplicativo fica em modo de teste (Testing). Segundo a documentação, nesse modo o consentimento e os tokens expiram em sete dias, e é preciso reconectar a credencial no n8n. O acesso também pode ser negado para uma conta que não esteja cadastrada como usuário de teste.
Para a URL de redirecionamento, cole o endereço exatamente como o n8n mostra, com protocolo e porta.
Credencial por conta de serviço (Service Account)
No Google Cloud, a conta de serviço é criada em "+ Create credentials > Service account". A chave sai de "Add key > Create new key", no formato JSON. No n8n, o client_email do arquivo vai em "Service Account Email", e a private_key é copiada sem as aspas ao redor.
No Drive, essa conta tem regras próprias. A documentação avisa que ela não acessa arquivos e pastas que não foram compartilhados com o e-mail dela. Para compartilhar, clique com o botão direito no arquivo ou na pasta, escolha Share, cole o e-mail da conta de serviço e dê o papel Editor (leitura e escrita) ou Viewer (só leitura).
Outro aviso: contas de serviço criadas depois de 15 de abril de 2025 não acessam o "my drive", só drives compartilhados.
Enviar um arquivo para o Drive
A operação de enviar ("Upload a file") usa dados binários, isto é, o conteúdo de um arquivo como imagem ou documento, vindo de um nó anterior. Os campos principais são:
- Input Data Field Name: o nome do campo de entrada que contém o arquivo binário a usar;
- File Name: o nome do novo arquivo;
- Parent Drive e Parent Folder: onde salvar. Dá para escolher na lista ("From list") o drive e a pasta.
O nome do campo de entrada precisa ser o mesmo que o nó anterior usou para o arquivo. Abra a aba de saída desse nó, veja o nome do campo binário e copie-o para o Google Drive. Para ler o conteúdo de um arquivo baixado, veja o guia Extract from File n8n: como ler PDF, CSV e planilhas.
Para trocar o conteúdo de um arquivo que já existe, use "Update a file" com a opção "Change File Content" e o mesmo campo de entrada.
Onde o seu n8n está hospedado hoje? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Baixar um arquivo do Drive
Na operação "Download a file", você escolhe o arquivo e define dois campos principais: "Put Output File in Field", o nome do campo onde o conteúdo binário será colocado para os nós seguintes, e "File Name", o nome do arquivo baixado.
Arquivos do próprio Google (Docs, Planilhas, Apresentações e Desenhos) podem ser exportados em outro formato no download, no campo "Google File Conversion". Estas são as opções da documentação:
- Google Docs: HTML, MS Word, Open Office, PDF, Rich Text (rtf) e Text (txt);
- Google Drawings: JPEG, PDF, PNG e SVG;
- Google Slides: MS PowerPoint e PDF, entre outros;
- Google Sheets: CSV, MS Excel, Open Office Sheet e PDF.
Buscar, mover, copiar e apagar
A busca ("Search files and folders") tem dois métodos: pelo nome do arquivo ou da pasta, ou a busca avançada ("Advanced Search"), em que você escreve a consulta na sintaxe de busca do Google no campo "Query String". Você pode marcar "Return All" ou limitar a quantidade no campo "Limit". Em "Filter", dá para escolher o drive (por padrão, o seu "My Drive"), a pasta e o que buscar.
Outras operações úteis:
- Move a file: move o arquivo de pasta;
- Copy a file: copia o arquivo com um novo nome;
- Create a folder: cria uma pasta com nome, drive e pasta pai;
- Delete: sem a opção "Delete Permanently", o item vai para a lixeira. Com ela, é apagado de vez.
Para achar o arquivo mais recente, a documentação sugere buscar com "Return All", ordenar pelo campo modifiedTime em ordem decrescente, limitar a 1 item e passar o ID do resultado para o próximo nó do Google Drive.
Compartilhar arquivos e pastas
As operações de compartilhar usam um papel (Role) e um tipo (Type). Os papéis disponíveis são Commenter, File Organizer, Organizer, Owner, Reader e Writer. Os tipos são:
- User: dá permissão a uma pessoa, pelo e-mail dela;
- Group e Domain: dão permissão a um grupo ou a um domínio;
- Anyone: dá permissão a pessoas em geral. Pense bem antes de escolher este tipo.
Entre as opções estão "Email Message" e "Send Notification Email".
Exemplo de fluxo: guardar um arquivo e compartilhar com o contador
Um exemplo de fluxo para ilustrar, com três etapas:
- Um nó anterior que traz o arquivo, como um formulário feito com o Form Trigger n8n, que receba uma nota fiscal;
- Google Drive, "Upload a file", com o "Input Data Field Name" igual ao nome do campo binário que o nó anterior mostrou, e "Parent Folder" apontando para uma pasta chamada "Notas fiscais";
- Google Drive, "Share a file", com Role Reader e Type User, informando o e-mail do contador.
Rode uma vez com um arquivo de teste e confira no Drive.
Google Drive Trigger: reagir a mudanças
O Google Drive Trigger inicia o fluxo quando algo muda no Drive. Ele funciona por consulta periódica (polling): segundo a documentação, verifica mudanças em intervalos definidos, a cada minuto por padrão. Depois que você salva e publica o fluxo, o nó passa a checar os eventos que combinam com o seu critério.
Em execução manual, o nó devolve o último evento que combina com a busca. Se nenhum evento combina, ele dá erro, por exemplo ao vigiar a criação de arquivos quando nenhum arquivo foi criado ainda. Quando várias mudanças acontecem de uma vez, chega um único evento com elas como itens; use If ou Switch para tratar um item ou vários.
Problemas comuns
- "Google hasn't verified this app" ou "Access denied": o aplicativo ainda não foi verificado ou a conta não está na lista de usuários de teste. Adicione a conta como usuário de teste.
- redirect_uri_mismatch: a URL de redirecionamento do Google Cloud não bate com a do n8n. Cole-a de novo, exatamente como aparece, com protocolo e porta.
- invalid_client: o Client ID ou o Client Secret não confere. Copie de novo e cuide para não levar espaços junto.
- Erro 401 "unauthorized_client" no trigger: há um problema com a credencial, seus escopos ou permissões. No OAuth2, confira se a Drive API está ativa na biblioteca do Google Cloud. Na conta de serviço, habilite a delegação em todo o domínio e inclua a Drive API.
Erro de OAuth no n8n hospedado por você
A documentação explica que o erro de OAuth ("you can't sign in because the app doesn't meet Google's expectations for keeping apps secure") acontece quando as URLs não coincidem entre a configuração do Google e a do n8n. Quem hospeda o n8n deve conferir se as variáveis N8N_EDITOR_BASE_URL e WEBHOOK_URL usam domínios completos (fully qualified). Para ver como definir variáveis no Docker, consulte o guia Variáveis de ambiente n8n: como configurar no Docker.
Resumo
Crie a credencial no Google Cloud, entre com "Sign in with Google" e escolha a operação: enviar e baixar usam o campo binário, e a busca é o jeito de listar.
Quanto custa uma VPS na Eleven Host? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Escolher a VPS
Perguntas frequentes
Como conectar o Google Drive ao n8n?
Crie uma credencial OAuth2: projeto no Google Cloud, Google Drive API ativa, tela de consentimento, OAuth client ID do tipo aplicativo web e a URL de redirecionamento do n8n. Depois cole o Client ID e o Client Secret e clique em "Sign in with Google".
Qual é o nome do campo binário no envio?
É o nome que o nó anterior deu ao arquivo. Veja a saída desse nó e copie o nome para "Input Data Field Name".
Como listar os arquivos de uma pasta?
Use "Search files and folders" e, em Filter, escolha a pasta. Marque "Return All" para trazer os resultados completos.
Por que a credencial para de funcionar depois de uma semana?
Se o aplicativo é External e está em modo de teste, o consentimento e os tokens expiram em sete dias. Reconecte a credencial.
A conta de serviço enxerga meus arquivos?
Só os compartilhados com o e-mail dela.