- O Google Drive Trigger faz polling (checagem por intervalo), não é tempo real — o padrão é verificar a cada minuto
- Um fluxo de 4 nós resolve o caso mais comum: vigiar 'Inbox' → identificar tipo → mover para subpasta → registrar em planilha
- Renomear com prefixo de data (2026-07-27_nota.pdf) faz os arquivos ordenarem cronologicamente sozinhos
- Para automações de servidor e Shared Drives, use Service Account em vez de OAuth pessoal
- O n8n Cloud lançou o Managed OAuth2 em 2026 — conecta o Drive sem você criar projeto no Google Cloud
1. Conecte o Google Drive ao n8n
Vá em Credentials > New e escolha 'Google Drive OAuth2'. Se você usa n8n Cloud com o Managed OAuth2 (recurso de 2026), basta clicar em 'Connect my account', logar e autorizar — o n8n cuida do handshake com credenciais Google pré-verificadas. No self-hosted você precisa criar um projeto no Google Cloud Console, gerar Client ID e Client Secret e colar a Redirect URI do n8n (algo como https://seu-n8n.com/rest/oauth2-credential/callback). Para automações que rodam no servidor sem um usuário logado — backups, pastas compartilhadas — prefira uma Service Account: você compartilha a pasta com o e-mail dela (client_email do JSON baixado) e usa a private_key na credencial.
2. Crie a estrutura de pastas de destino
Antes de automatizar, monte no Drive a pasta que será vigiada (ex.: 'Inbox') e as subpastas de destino: Documentos, Imagens, Planilhas, PDFs, Vídeos, Apresentações. Anote o ID de cada pasta (fica no fim da URL quando você a abre no navegador). Você vai referenciar esses IDs no nó de mover — usar o ID é mais confiável do que buscar pela lista, porque nomes de pasta podem se repetir.
3. Adicione o Google Drive Trigger
Adicione o nó 'Google Drive Trigger' como início do fluxo. Em 'Trigger On', escolha 'Changes Involving a Specific Folder' e selecione a pasta Inbox. Em 'Watch For', marque 'File Created'. Defina o Poll Time — o padrão checa a cada minuto. Atenção à armadilha mais reportada pela comunidade: o trigger de 'pasta específica' costuma detectar arquivos criados diretamente na pasta, mas nem sempre pega arquivos que aparecem dentro de subpastas ou que foram apenas movidos para lá. Se seus arquivos chegam por movimentação, teste com upload real antes de colocar em produção.
4. Identifique o tipo de arquivo com um nó Switch
Ligue o trigger a um nó 'Switch' (ou 'IF' para poucos casos). Use o campo mimeType que o Drive retorna — por exemplo application/pdf, image/jpeg, image/png, application/vnd.google-apps.spreadsheet. Crie uma saída para cada categoria. Alternativamente, você pode olhar a extensão no fim do nome do arquivo. Cada saída do Switch vai apontar para um nó de mover diferente, com o ID da subpasta correspondente.
5. Mova o arquivo para a subpasta certa
Em cada saída do Switch, adicione um nó 'Google Drive' com a operação 'Move File' (File > Move). No campo do arquivo, use o ID que veio do trigger; no destino, informe o ID da subpasta 'By ID'. Se quiser ordenação cronológica automática, encaixe antes um nó 'Edit Fields'/'Set' para montar o novo nome com prefixo de data — algo como {{ $now.format('yyyy-MM-dd') }}_{{ $json.name }} — e use a operação 'Update File' para renomear. O resultado: 2026-07-27_contrato-cliente.pdf cai direto na pasta Documentos, já datado.
6. Registre tudo numa planilha de log
Feche o fluxo com um nó Google Sheets 'Append Row' apontando para uma aba FileLog, gravando fileId, nome original, subpasta de destino e novo nome. Esse log serve para auditoria e para você perceber rápido se o trigger deixou de disparar. Ative o workflow e faça um teste de ponta a ponta: suba um PDF e um JPG na Inbox e confirme que cada um foi para a pasta certa e apareceu no log.
O trigger do Google Drive é tempo real? (a parte que ninguém avisa)
Não. O Google Drive Trigger do n8n funciona por polling: ele checa o Drive em intervalos definidos — por padrão a cada minuto — e não recebe um webhook instantâneo do Google. Na prática, isso significa uma latência de até um minuto entre o arquivo chegar e o fluxo rodar, o que é aceitável para organização de arquivos, mas não para casos que exigem reação imediata.
Dois comportamentos aparecem com frequência nos fóruns da comunidade e vale conhecer antes de confiar no fluxo em produção:
- Se vários arquivos são criados dentro do mesmo intervalo de polling, o trigger pode agrupar tudo em um único disparo com múltiplos itens — ou, em alguns relatos, retornar só o mais recente. Teste com uploads em lote.
- O modo 'pasta específica' nem sempre enxerga mudanças em subpastas ou arquivos apenas movidos para a pasta; ele é mais confiável com arquivos criados/enviados diretamente ali.
- Ao ativar o workflow, uploads muito frequentes ou pastas gigantes já geraram erros 502/524 relatados — comece com uma pasta enxuta.
OAuth pessoal ou Service Account: qual usar?
A escolha da credencial muda a robustez da automação. Resumindo a decisão:
| Critério | OAuth2 pessoal | Service Account |
|---|---|---|
| Melhor para | Fluxos pessoais, seu próprio Drive | Automações de servidor, Shared Drives |
| Contexto de acesso | Age como você (o usuário) | Age como uma aplicação, com e-mail próprio |
| Configuração | Login e autorização (ou Managed OAuth2 no Cloud) | Criar conta no Google Cloud e compartilhar a pasta com o e-mail dela |
| Depende de token de usuário | Sim — pode expirar/revogar | Não — ideal para rodar 24/7 sem intervenção |
Por que a conta de serviço evita quebras no meio da noite
Para um fluxo que roda sozinho no servidor a madrugada inteira, a Service Account evita o risco de a automação quebrar quando um token pessoal expira ou é revogado. Só lembre de compartilhar explicitamente a pasta do Drive com o e-mail da conta de serviço, senão ela não enxerga nada.
Além de organizar: o que mais dá pra fazer com o Drive no n8n
O mesmo nó do Google Drive cobre criar, listar, copiar, baixar, atualizar e excluir arquivos e pastas. Com isso, alguns fluxos que empresas brasileiras montam a partir da mesma base:
- Backup agendado: exportar dados de um sistema e salvar como arquivo datado numa pasta de backup toda madrugada.
- Intake de documentos: cliente sobe um contrato → o fluxo move para a pasta daquele cliente e avisa o CRM que o documento chegou.
- Processamento: novo PDF na Inbox → extrair texto/dados → registrar numa planilha → arquivar o original.
Perguntas frequentes
O Google Drive Trigger do n8n é instantâneo?
Preciso criar um projeto no Google Cloud para conectar o Drive?
O n8n consegue mover arquivos para dentro de subpastas automaticamente?
Usar a API do Google Drive com n8n tem custo?
- Stop drowning in files: auto-organize your Google Drive with n8n — DEV Community
- Google Drive node — n8n Docs
- Google Drive Trigger node documentation — n8n Docs
- Google Drive Trigger node common issues — n8n Docs
- Google Service Account in n8n: Complete 2026 Guide — DEV Community
- Automate Google Drive with n8n: Complete 2026 Guide — n8nautomation.cloud
Leia também
Como automatizar Google Sheets com n8n (sem uma linha de código)
Aprenda a automatizar Google Sheets com n8n: adicionar linhas, gerar relatórios automáticos, enviar por e-mail e conectar com qualquer sistema. Passo a passo.
Ler →
O que é n8n? Guia completo para iniciantes em 2026
Entenda o que é n8n, como a ferramenta de automação funciona, quanto custa, se é difícil de aprender e como criar seu primeiro workflow sem saber programar.
Ler →
Como fazer backup do n8n self-hosted e restaurar sem perder workflows
Guia prático de backup e restauração do n8n self-hosted: exportar workflows e credenciais via CLI, dump do PostgreSQL, a chave de criptografia que não pode faltar e como automatizar tudo.
Ler →
Trigger (Gatilho)
Trigger ou gatilho é o evento que inicia uma automação. Entenda os tipos de trigger, como escolher o certo e exemplos reais em n8n, Make e Zapier.
Ler →
n8n self-hosted e LGPD: onde ficam seus dados e como ficar em conformidade
Rodar o n8n no seu próprio servidor não deixa você em conformidade com a LGPD sozinho. Veja onde os dados ficam, o que a ANPD exige e como configurar retenção, chave e transferência internacional.
Ler →
Como automatizar emails: guia prático para negócios em 2026
Aprenda a automatizar emails de boas-vindas, follow-up, nutrição e pós-venda usando ferramentas no-code. Guia prático com passos, ferramentas e exemplos reais.
Ler →