InícioGuias › automacoes-google-workspace
Guia

Como organizar arquivos no Google Drive automaticamente com n8n

Atualizado em 2026-07-27 · por Redação Automação Hoje
Profissional brasileira organizando arquivos no Google Drive automaticamente com n8n no notebook
Resposta rápida: O n8n tem um Google Drive Trigger que vigia uma pasta a cada minuto e dispara quando um arquivo novo chega. A partir daí, um nó de decisão lê o tipo do arquivo (PDF, imagem, planilha) e o nó Google Drive move para a subpasta correta, opcionalmente renomeando com prefixo de data. Tudo visual, sem uma linha de código — mas o trigger tem limitações de pasta que você precisa conhecer antes de confiar nele.
· espaço publicitário ·
Em resumo
  • 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. 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. 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. 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. 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. 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. 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érioOAuth2 pessoalService Account
Melhor paraFluxos pessoais, seu próprio DriveAutomações de servidor, Shared Drives
Contexto de acessoAge como você (o usuário)Age como uma aplicação, com e-mail próprio
ConfiguraçãoLogin 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árioSim — pode expirar/revogarNã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?
Não. Ele faz polling em intervalos (padrão de um minuto), então existe uma pequena latência entre o arquivo chegar e o fluxo disparar. Para organização de arquivos isso não é problema; para reações que precisam ser imediatas, considere outro gatilho, como um webhook do próprio sistema de origem.
Preciso criar um projeto no Google Cloud para conectar o Drive?
No n8n self-hosted, geralmente sim: você cria um projeto no Google Cloud Console, gera Client ID e Secret e configura a Redirect URI. No n8n Cloud, o recurso Managed OAuth2 lançado em 2026 dispensa isso — o n8n faz o handshake com credenciais Google pré-verificadas e você só autoriza a conta.
O n8n consegue mover arquivos para dentro de subpastas automaticamente?
Sim, a operação 'Move File' aceita o ID da pasta de destino, incluindo subpastas. O ponto de atenção é o gatilho: o trigger de pasta específica nem sempre detecta bem mudanças ocorridas dentro de subpastas. Vigie a pasta raiz e faça a movimentação para as subpastas dentro do fluxo.
Usar a API do Google Drive com n8n tem custo?
A API do Google Drive é gratuita dentro de cotas generosas para uso normal. O custo relevante costuma ser o do próprio n8n (cloud ou VPS para self-hosted) e, no caso do Google Workspace, o plano da sua conta. Para a maioria dos fluxos de organização de arquivos, você não encosta nos limites da API.

Leia também