Drive Viewer Downloader

Purpose & User Intent: This tool solves the problem of obtaining reliable, direct download access from Google Drive share links without manual navigation. Primary users include content managers, developers building asset delivery pipelines, data researchers, and product teams that need reproducible access to Drive-hosted files. It is used when a file is publicly shared or accessible via link and a direct URL is required for embedding, caching, or batch processing. Core use cases include automating asset retrieval in content workflows, integrating with data pipelines, or enabling scripted downloads for offline analysis.
Core Logic & Features: The tool parses a Google Drive URL, extracts the file ID, validates the URL format, and determines the access state (public via link or restricted). If accessible through the link, it constructs a direct download URL using Drive patterns, and retrieves metadata such as file name, size, and mime type. Required: URL parsing, permission detection, direct-link construction, metadata extraction. Optional/advanced: support for exporting compatible Docs formats to PDF, batch processing of multiple URLs, configurable fallbacks if direct download is blocked, and granular error reporting for auditing. It emphasizes deterministic results and traceable outputs, returning explicit status codes rather than UI messages.
Inputs & Outputs: Inputs include drive_url (string, required; sample: "https://drive.google.com/file/d/FILE_ID/view?usp=sharing"; validation: must contain /file/d/ or ?id=), download_format (string, optional; values: "auto","original","pdf"), auth_token (string, optional; guidance: valid OAuth2 token if access is restricted), output_mode (string, optional; values: "direct_link","metadata_only"). Outputs include direct_download_url (string), file_name (string), size_bytes (integer), size_human (string, e.g., "12.3 MB"), mime_type (string), status (string; values: "OK"|"ERROR"), error_message (string, optional).