مستوى الترميز: للمبتدئين
المدة: 20 دقيقة
نوع المشروع: تشغيل آلي من خلال
مشغّل مستند إلى الحدث
الأهداف
- فهم ما يفعله الحل.
- تعرّف على ما تفعله خدمات "برمجة التطبيقات" ضمن الحل.
- أعِدّ النص البرمجي.
- شغِّل النص البرمجي.
لمحة عن هذا الحلّ
إذا كان لديك أنواع مختلفة من المحتوى الذي ترغب في تقديمه لجمهورك، يمكنك السماح للمستخدمين باختيار المحتوى الذي يتلقّونه منك باستخدام "نماذج Google". يتيح هذا الحل للمستخدمين تحديد الموضوعات التي يهتمون بها، ثم مراسلتهم عبر البريد الإلكتروني تلقائيًا بالمحتوى المختار.
آلية العمل
يثبّت النص البرمجي مشغِّلاً مستندًا إلى الحدث يتم تشغيله في كل مرة يُرسل فيها المستخدم نموذجًا. مع كل عملية إرسال للنموذج، ينشئ النص البرمجي رسالة إلكترونية ويرسلها من نموذج "مستندات Google". تتضمن رسالة البريد الإلكتروني اسم المستخدم والمحتوى الذي اختاره. يمكن أن يكون المحتوى الذي تقدّمه من أي نوع ما دام عنوان URL يُشير إليه.
خدمات "برمجة التطبيقات"
يستخدم هذا الحل الخدمات التالية:
- خدمة النص البرمجي - تثبِّت المشغّل المستند إلى الحدث الذي يتم تنشيطه عندما يُرسل أحد الأشخاص النموذج.
- خدمة المستندات - لفتح نموذج "مستندات Google" الذي يستخدمه النص البرمجي لإنشاء الرسالة الإلكترونية.
- خدمة البريد - تنشئ الرسالة الإلكترونية وترسلها مع تحديد اسم المستخدم والمحتوى المحدد.
- خدمة جدول البيانات: تضيف تأكيدًا إلى ورقة الردود على النموذج بعد أن يرسل النص البرمجي الرسالة الإلكترونية.
المتطلبات الأساسية
لاستخدام هذا النموذج، ستحتاج إلى المتطلّبات الأساسية التالية:
- حساب Google (قد تتطلب حسابات Google Workspace موافقة المشرف).
- متصفح ويب يمكنه الوصول إلى الإنترنت.
إعداد النص البرمجي
انقر على الزر التالي لإنشاء نسخة من جدول البيانات إرسال محتوى منظَّم. يتم إرفاق مشروع "برمجة تطبيقات Google" لهذا الحل بجدول البيانات.
إنشاء نسخةفي جدول البيانات المنسوخ، انقر على الإضافات > برمجة التطبيقات.
في القائمة المنسدلة للدوال، اختَر installTrigger.
انقر على تشغيل.
امنح الإذن للنصّ البرمجي عند مطالبتك بذلك. إذا عرضت شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth التحذير، لم يتم التحقّق من هذا التطبيق، يمكنك المتابعة من خلال اختيار إعدادات متقدّمة > الانتقال إلى {Project Name} (غير آمن).
ملاحظة مهمّة: في حال تشغيل installTrigger أكثر من مرة، ينشئ النص البرمجي مشغِّلات متعددة يرسل كل منها رسالة إلكترونية عندما يُرسل أحد المستخدمين النموذج. لحذف المشغِّلات الإضافية وتجنُّب الرسائل الإلكترونية المكرّرة، انقر على العوامل المشغِّلة
. انقر بزر الماوس الأيمن على كل مشغّل إضافي وانقر على حذف مشغّل.تشغيل النص البرمجي
- ارجع إلى جدول البيانات وانقر على أدوات > إدارة النموذج > الانتقال إلى النموذج المباشر.
- املأ النموذج وانقر على إرسال.
- ابحث في بريدك الإلكتروني عن رسالة إلكترونية تتضمّن روابط إلى المحتوى الذي اخترته.
مراجعة الرمز
لمراجعة رمز برمجة التطبيقات لهذا الحل، انقر على عرض رمز المصدر أدناه:
عرض رمز المصدر
Code.gs
المساهمون
تحتفظ Google بهذا النموذج بمساعدة خبراء التطوير في Google.