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