تؤدي عوامل التشغيل في Apps Script إلى تنفيذ دالة نصية برمجية محدّدة (دالة التشغيل) عند وقوع حدث محدّد. يمكن أن تؤدي أحداث معيّنة فقط إلى تنشيط عوامل التفعيل، ويتوافق كل تطبيق في Google Workspace مع مجموعة مختلفة من الأحداث.
عند بدء عامل التشغيل، يتم إنشاء كائن حدث. تحتوي بنية JSON هذه على تفاصيل عن الحدث الذي وقع. يتم تنظيم المعلومات في بنية حدث العنصر بشكل مختلف استنادًا إلى نوع العامل المشغِّل.
بعد إنشاء عنصر الحدث، تمرّره "برمجة تطبيقات Google" كمَعلمة إلى دالة التشغيل. دالة التفعيل هي دالة ردّ اتصال يجب تنفيذها بنفسك لاتّخاذ أي إجراءات مناسبة للردّ على الحدث. على سبيل المثال، في إحدى تطبيقات Chrome المتوافقة مع Google Workspace التي توفّر ميزات إضافية في Gmail، يمكنك تحديد عامل تشغيل ينشئ واجهة بطاقة جديدة عندما يفتح المستخدم سلسلة محادثات في الرسائل. في هذه الحالة، يمكنك تنفيذ دالة استدعاء سياقي لإنشاء البطاقات التي تشكّل واجهة المستخدم الجديدة باستخدام البيانات التي تم تمريرها في عنصر الحدث.
تقدّم هذه الصفحة إرشادات حول استخدام عوامل التفعيل في مشاريع الإضافات في Google Workspace.
عوامل تشغيل البيان
على عكس إضافات "المحرِّر"، لا يمكن حاليًا لإضافات Google Workspace استخدام العوامل المشغِّلة البسيطة في Apps Script، وبدلاً من ذلك، تستخدم عوامل تشغيل مصمّمة خصيصًا لإضافات Google Workspace: عوامل تشغيل البيان.
يتم تحديد عوامل تشغيل البيان بالكامل في بيانإضافة Google Workspace. تشمل أمثلة عوامل تشغيل البيان ما يلي:
- عوامل تشغيل الصفحة الرئيسية التي تنشئ الصفحة الرئيسية للإضافة وتعرضها
- عوامل تشغيل فتح حدث في التقويم التي تعرِض بطاقة جديدة أو تتّخذ إجراءات أخرى عند فتح حدث في التقويم
- عوامل تشغيل تعديل أحداث التقويم التي تعرِض بطاقة جديدة أو تتّخذ إجراءات أخرى عندما يعدّل المستخدم حدثًا في "تقويم Google" ويحفظه
- عوامل تشغيل onItemsSelected في Drive التي تعرِض بطاقة جديدة أو تتّخذ إجراءات أخرى عندما يختار المستخدِم ملفًا أو مجلدًا واحدًا أو أكثر في Drive
- عوامل تشغيل إنشاء الرسائل في Gmail التي تعرِض بطاقة إضافة عندما يفتح المستخدم الإضافة في نافذة إنشاء الرسائل في Gmail
- العوامل المشغِّلة السياقية في Gmail التي تعرِض بطاقة جديدة أو تتّخذ إجراءات أخرى عندما يفتح المستخدم رسالة Gmail
- عوامل تشغيل onFileScopeGranted في المحرّر التي تعرِض بطاقة جديدة عندما يمنح المستخدِمون تفويضًا لنطاق OAuth
drive.fileفي مستند المحرّر الحالي
في القائمة أعلاه، تكون عوامل تشغيل الصفحة الرئيسية فقط غير مستندة إلى السياق، في حين أنّ البقية هي عوامل تشغيل مستندة إلى السياق. اطّلِع على البيان لمزيد من المعلومات عن تعريفات مشغّلات البيان.
بالإضافة إلى مشغِّلات البيان، يمكن لإضافات Google Workspace استخدام مشغِّلات قابلة للتثبيت في Apps Script.
القيود
تفرض عوامل تشغيل البيان قيودًا معيّنة على استخدامها.
- لا تُستخدَم هذه المشغّلات إلا في مشاريع الإضافات في Google Workspace، وليس لها أي غرض في أي تطبيق آخر.
- وبما أنّها محدّدة في بيان الإضافة وليس في رمزها، لا يمكنك
استخدام خدمة Apps Script
Scriptلإنشاء هذه المشغّلات أو تعديلها. - لا يمكن حاليًا أن تتضمّن مشغِّلات السياق في Gmail سوى معايير
unconditional. وهذا يعني أنّ عوامل التفعيل السياقية يتم تفعيلها لكل رسالة إلكترونية، بغض النظر عن المحتوى. - يمكن أن تحتوي كل إضافة على عامل تشغيل واحد فقط من كل نوع لكل مستخدم ولكل مستند.