Drive Viewer Downloader

الغرض ونية المستخدم: يحل هذا الأداة الحاجة للوصول بالتنزيل المباشر من روابط مشاركة Google Drive بدون تصفح يدوي. المستخدمون الرئيسيون هم مديرو المحتوى والمطورون الذين يبنون خطوط توصيل الأصول والباحثون والفرق المنتجه التي تحتاج وصولًا قابلاً لإعادة الإنتاج إلى الملفات المستضافة عبر Drive. يُستخدم عندما يكون الملف مشارَكاً علنًا أو قابلاً للوصول عبر رابط وتُريد URL مباشر للإدراج، التخزين المؤقت، أو المعالجة دفعةً واحدة. أمثلة استخدام: أتمتة استرجاع الأصول في تدفقات العمل للمحتوى، التكامل مع خطوط أنابيب البيانات، أو التحميلات البرمجية للتحليلات دون اتصال.
المنطق الأساسي والميزات: يقوم الأداة بتحليل عنوان Google Drive، واستخراج معرف الملف، والتحقق من نمط URL وتحديد حالة الوصول (عام عبر الرابط أو مقيد). إذا كان الوصول متاحًا، بُنِي عنوان تنزيل مباشر وفق أنماط Drive، ويتم جلب بيانات الوصف مثل اسم الملف، الحجم، ونوع MIME. المتطلبات: تحليل URL، اكتشاف الأذونات، إنشاء الرابط المباشر، استخراج البيانات الوصفية. الميزات الاختيارية/المتقدمة: التصدير إلى PDF من صيغ Docs المتوافقة، المعالجة التراكمية لعدة عناوين، خيارات احتياطية قابلة للإعداد في حال bloqueo التنزيل المباشر، وتقرير أخطاء مفصل للمراجعة. التركيز على نتائج حتمية ومخرجات قابلة للتتبع مع رموز حالة صريحة بدلاً من رسائل واجهة المستخدم.
المدخلات والمخرجات: المدخلات تشمل drive_url (سلسلة، مطلوبة؛ مثال: "https://drive.google.com/file/d/FILE_ID/view?usp=sharing")، download_format (سلسلة، اختيارية؛ قيم: "auto","original","pdf")، auth_token (سلسلة، اختيارية؛ التوجيه: توكن OAuth2 صالح عند وجود وصول مقيد)، output_mode (سلسلة، اختيارية؛ قيم: "direct_link","metadata_only"). المخرجات تشمل direct_download_url (سلسلة)، file_name (سلسلة)، size_bytes (عدد صحيح)، size_human (سلسلة، مثل "12.3 MB")، mime_type (سلسلة)، status (سلسلة؛ قيم: "OK"|"ERROR")، error_message (سلسلة، اختياري).