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