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