Drive Viewer Downloader

Propósito e intenção do usuário: esta ferramenta resolve a necessidade de obter acesso direto confiável a downloads a partir de links de compartilhamento do Google Drive, sem navegação manual. Usuários principais incluem gerentes de conteúdo, desenvolvedores que constroem pipelines de entrega de ativos, pesquisadores de dados e equipes de produto que exigem acesso reprodutível a arquivos hospedados no Drive. É utilizado quando um arquivo é compartilhado publicamente ou acessível via link e uma URL direta é necessária para incorporação, cache ou processamento em lote. Casos de uso: automatizar a recuperação de ativos em fluxos de trabalho de conteúdo, integração com pipelines de dados ou downloads automatizados para análises off-line.
Lógica central e recursos: a ferramenta analisa uma URL do Google Drive, extrai o ID do arquivo, valida o formato da URL e determina o estado de acesso (público via link ou restrito). Se houver acesso, constrói uma URL de download direto segundo os padrões do Drive e recupera metadados como nome do arquivo, tamanho e tipo MIME. Requisitos: análise de URL, detecção de permissões, construção de link direto, extração de metadados. Funcionalidades opcionais/avançadas: exportação de formatos Docs compatíveis para PDF, processamento em lote de várias URLs, fallbacks configuráveis se o download direto for bloqueado, e relatórios de erros detalhados para auditoria. Foco em resultados determinísticos e saídas auditáveis com códigos de status explícitos em vez de mensagens de UI.
Entradas e saídas: entradas incluem drive_url (string, obrigatório; exemplo: "https://drive.google.com/file/d/FILE_ID/view?usp=sharing"), download_format (string, opcional; valores: "auto","original","pdf"), auth_token (string, opcional; orientação: token OAuth2 válido se o acesso for restrito), output_mode (string, opcional; valores: "direct_link","metadata_only"). Saídas incluem direct_download_url (string), file_name (string), size_bytes (número inteiro), size_human (string, ex. "12,3 MB"), mime_type (string), status (string; valores: "OK"|"ERROR"), error_message (string, opcional).