Guia rápido

Como usar o DriveFlow

Passo a passo objetivo das três formas de baixar com o DriveFlow: link direto, arquivo do Drive e pasta pública do Drive.

Modo demonstração

Experimente sem baixar nada de verdade

Cole demo://teste no campo de link da Home e clique em Analisar. O DriveFlow mostra uma árvore fictícia de ensaio fotográfico — nenhum arquivo é gravado no disco. Útil para testar a interface antes de colar um link real.

Link direto

Para qualquer URL http/https de arquivo

Cole o link de um arquivo (ex.: https://exemplo.com/contrato.pdf), clique em Analisar, escolha a pasta de destino e clique em Criar fila. O nome final do arquivo vem do servidor (Content-Disposition) — não do que aparece na URL.

Arquivo público do Google Drive

URLs do tipo /file/d/<id>/view

O DriveFlow identifica o link como Google Drive público, lida automaticamente com a página de confirmação que aparece em arquivos grandes, e baixa sem pedir login. Se o arquivo estiver privado, você vê uma mensagem clara explicando.

Pasta pública do Google Drive

URLs do tipo /drive/folders/<id>

O DriveFlow lista o conteúdo da pasta, mostra os arquivos e subpastas, avisa o que será ignorado (Google Docs, por exemplo), e baixa preservando toda a hierarquia. Limite atual: 300 itens por pasta sem login. Acima disso, lista parcialmente.

Resumo final

Cinco estados possíveis ao terminar

  • Download concluído — tudo OK, zero ignorados, zero erros.
  • Download concluído com avisos — tudo OK em downloads, mas teve itens ignorados (Docs).
  • Concluído com falhas parciais — alguns caíram, outros falharam. Botão "Tentar novamente só os erros" aparece.
  • Download interrompido — você cancelou no meio.
  • Não foi possível baixar — falha total (link inválido, pasta privada, etc.).
Copiar resumo

Botão dentro do card de resumo da pasta

Copia para a área de transferência um texto formatado com cabeçalho, contadores e a lista dos primeiros erros e ignorados com motivo amigável. Útil para colar em e-mail ao cliente, num chat, ou em ticket de suporte.

Guia completo dentro do app: abra docs/USER_GUIDE.md no repositório do DriveFlow para a versão longa, com 15 seções cobrindo todos os fluxos.