Drive Viewer Downloader

Propósito e intención del usuario: esta herramienta resuelve la necesidad de obtener acceso de descarga directa fiable desde enlaces de compartir de Google Drive sin navegación manual. Usuarios principales: gerentes de contenido, desarrolladores que construyen pipelines de entrega de assets, investigadores y equipos de producto que requieren acceso reproducible a archivos alojados en Drive. Se usa cuando un archivo está compartido públicamente o es accesible mediante enlace y se necesita una URL directa para incrustar, almacenar en caché o procesar por lotes. Casos de uso: automatización de recuperación de assets en flujos de trabajo de contenido, integración con pipelines de datos o descargas automatizadas para análisis fuera de línea.
Lógica central y características: la herramienta analiza una URL de Google Drive, extrae el ID de archivo, valida el formato de la URL y determina el estado de acceso (público vía enlace o restringido). Si es accesible, construye una URL de descarga directa usando patrones de Drive y recupera metadatos como nombre de archivo, tamaño y tipo MIME. Requisitos: análisis de URL, detección de permisos, construcción de enlace directo, extracción de metadatos. Funciones opcionales/avanzadas: exportar formatos Docs compatibles a PDF, procesamiento por lotes de varias URLs, fallback configurable si la descarga directa está bloqueada y elaboración de informes de errores para auditoría. Enfoque en resultados deterministas y salidas auditable con códigos de estado explícitos.
Entradas y salidas: entradas incluyen drive_url (cadena, obligatoria; ejemplo: "https://drive.google.com/file/d/FILE_ID/view?usp=sharing"), download_format (cadena, opcional; valores: "auto","original","pdf"), auth_token (cadena, opcional; orientación: token OAuth2 válido si el acceso es restringido), output_mode (cadena, opcional; valores: "direct_link","metadata_only"). Salidas incluyen direct_download_url (cadena), file_name (cadena), size_bytes (entero), size_human (cadena, por ejemplo, "12,3 MB"), mime_type (cadena), status (cadena; valores: "OK"|"ERROR"), error_message (cadena, opcional).