مستوى الترميز: مبتدئ
المدة: 10 دقائق
نوع المشروع: تشغيل آلي باستخدام عامل تشغيل مستند إلى الحدث
الأهداف
- فهم ما يفعله الحلّ.
- فهم ما تفعله خدمات برمجة التطبيقات ضمن الحلّ.
- قم بإعداد النص البرمجي.
- شغِّل النص البرمجي.
لمحة عن هذا الحلّ
تحميل الملفات وتنظيمها في Google Drive في آنٍ واحد باستخدام "نماذج Google" يتضمن النموذج إدخالات للملفات المطلوب تحميلها وكيفية تنظيم الملفات.
آلية العمل
وتعمل وظيفة الإعداد على إنشاء مجلد لتخزين جميع الملفات المحمّلة ومشغِّل يتم تنشيطه في كل مرة يُرسل فيها أحد الأشخاص النموذج. عندما يملأ المستخدم النموذج، فإنه يختار الملفات التي سيتم تحميلها ومجلدًا فرعيًا لتخزين الملفات فيه. بمجرد أن يرسل المستخدم النموذج، يوجّه النص البرمجي الملفات إلى المجلد الفرعي المقابل. إذا لم يكن المجلد موجودًا بعد، فسينشئه البرنامج النصي.
خدمات "برمجة تطبيقات Google"
يستخدم هذا الحلّ الخدمات التالية:
- خدمة النص البرمجي: تُنشئ المشغِّل الذي يتم تنشيطه في كل مرة يُرسل فيها أحد الأشخاص النموذج.
- خدمة المواقع – تخزِّن معرّف المشغل الذي ينشئه النص البرمجي أثناء الإعداد لمنع المشغلات المكررة.
- خدمة Drive - أثناء الإعداد، تحصل على موقع النموذج في Drive وتنشئ مجلدًا في الموقع ذاته. عندما يرسل المستخدم النموذج، توجّه خدمة Drive الملفات إلى هذا المجلد، وإلى مجلد فرعي معيّن إذا تم اختياره. إذا لم يكن المجلد الفرعي موجودًا بعد، فإنه يقوم النص بإنشاءه.
- خدمة "نماذج Google" - تحصل على الملفات واسم المجلد الذي اختاره المستخدم بعد إرسال النموذج وإرساله إلى خدمة Drive.
المتطلبات الأساسية
لاستخدام هذا النموذج، يجب استيفاء المتطلبات الأساسية التالية:
- حساب على Google (قد تتطلب حسابات Google Workspace موافقة المشرف).
- متصفح ويب يمكنه الوصول إلى الإنترنت.
إعداد النص البرمجي
إنشاء النموذج
- انتقِل إلى forms.google.com وانقر على "فارغ" .
- انقر على نموذج بلا عنوان وأعِد تسمية النموذج إلى تحميل ملفات إلى Drive.
- انقر على سؤال بلا عنوان وأعِد تسمية السؤال إلى مجلد فرعي.
- في سؤال المجلد الفرعي، انقر على رمز المزيد > الوصف.
- في حقل الوصف، أدخِل اختيار المجلد الفرعي لتخزين ملفاتك فيه. في حال اختيار <None> (بدون)، سيتم تخزين الملفات في مجلد "الملفات التي تم تحميلها".
- أضِف الخيارات التالية إلى سؤال المجلد الفرعي:
- <بلا>
- المشروع "أ"
- المشروع "ب"
- المشروع "ج"
- لجعل السؤال مطلوبًا، انقر على مطلوب.
- انقر على رمز إضافة سؤال .
- انقر على خيارات متعدّدة واختَر تحميل ملف.
- انقر على متابعة.
- بالنسبة إلى السؤال، أدخِل الملفات المطلوب تحميلها. يمكنك اختيار أنواع الملفات والحد الأقصى لعدد الملفات التي تريد السماح للأشخاص بتحميلها.
- لجعل السؤال مطلوبًا، انقر على مطلوب.
إنشاء مشروع "برمجة تطبيقات Google"
- من النموذج، انقر على رمز المزيد > محرِّر النص البرمجي.
- انقر على مشروع بلا عنوان وأعِد تسمية المشروع إلى تحميل الملفات إلى Drive.
- لإنشاء ملف نص برمجي آخر، انقر على إضافة ملف
> نص برمجي. اختَر اسمًا للملف "
Setup
". استبدل محتوى كلا ملفي البرنامج النصي بالمحتوى التالي:
Code.gs
Setup.gs
تشغيل النص البرمجي
- في محرِّر "برمجة تطبيقات Google"، بدِّل إلى الملف
Setup.gs
. - في القائمة المنسدلة للدوال، اختَر
setUp
. - انقر على تشغيل.
امنح الإذن للنص البرمجي عندما يُطلب منك ذلك. إذا كانت شاشة طلب موافقة OAuth تعرض التحذير، لم يتم التحقّق من هذا التطبيق، يمكنك المتابعة من خلال اختيار إعدادات متقدّمة > الانتقال إلى {Project Name} (اسم المشروع) (غير آمن).
ارجِع إلى النموذج وانقر على معاينة .
في النموذج، اختَر مجلدًا فرعيًا وحمِّل ملفًا.
انقر على إرسال.
انتقِل إلى Drive وافتح مجلد تحميل الملفات إلى Drive (الردود على الملفات). تتوفَّر ملفاتك المحمّلة في المجلد الفرعي الذي اخترته في النموذج.
المساهمون
تحتفظ Google بهذا النموذج بمساعدة خبراء التطوير في Google.