Base de Conhecimento

Google Drive no n8n: como enviar e baixar arquivos

  • n8n, google drive, oauth2, arquivo binário, automação, google drive trigger
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Google Drive no n8n: como enviar e baixar arquivos

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

  1. No Google Cloud Console, crie um projeto ("New project") e deixe-o selecionado.
  2. Vá em APIs & Services > Library e ative a Google Drive API.
  3. 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.
  4. Em Branding, preencha a seção "Authorized domains" (n8n.cloud no n8n Cloud; o domínio da instância, se você hospeda).
  5. Clique em "+ Create credentials", escolha "OAuth client ID" e, como tipo, "Web application".
  6. No n8n, abra a credencial e copie a "OAuth Redirect URL". Cole essa URL em "Authorized redirect URIs" no Google Cloud.
  7. Copie o "Client ID" e o "Client Secret" do Google Cloud para a credencial do n8n.
  8. 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:

  1. Um nó anterior que traz o arquivo, como um formulário feito com o Form Trigger n8n, que receba uma nota fiscal;
  2. 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";
  3. 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.

Esta resposta lhe foi útil?

Artigos Relacionados