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