مسرد المصطلحات

يتم استخدام المصطلحات التالية في هذه المستندات.

إضافة مكالمات الفيديو في "تقويم Google"

نوع خاص من الإضافات المستخدَمة للسماح لمقدّمي خدمات مكالمات الفيديو بعرض options مكالمات الفيديو في أحداث "تقويم Google". تتطلّب هذه الإضافات استخدام حلّ مطوّر لإجراء مكالمات الفيديو حتى تتمكّن من الربط بها. وبسبب هذا الشرط، لم يحتاج معظم المطوّرين أبدًا إلى إنشاء إضافة لمكالمات الفيديو في "تقويم Google".

اطّلِع على إضافات مكالمات الفيديو في "تقويم Google" لمزيد من المعلومات. اطّلِع أيضًا على مقالة ترقية الإضافات المنشورة للحصول على معلومات عن كيفية تحويل إضافة مكالمات الفيديو في "تقويم Google" إلى إضافة Google Workspace.

بطاقة

"صفحة" واحدة لواجهة مستخدم الإضافة تتألّف البطاقات من عناصر تطبيقات مصغّرة مختلفة (الأزرار وحقول النصوص والعناوين وما إلى ذلك).

اطّلِع على البطاقات للحصول على مزيد من المعلومات.

مستندة إلى البطاقة

إضافة تظهر واجهة المستخدم فيها كعمود في الشريط الجانبي (أو على الأجهزة الجوّالة، كنافذة نشاط أخرى يتم الوصول إليها من خلال القائمة). تحتوي الإضافة على شريط أدوات في أعلى الشاشة يحدِّد الإضافة ويعرض بطاقة، وهي في الأساس "صفحة" من واجهة مستخدم الإضافة.

تعتمد إضافات Google Workspace على البطاقات.

بيانات المؤتمر

مجموعة المعلومات التي يحتاجها "تقويم Google" للسماح للمستخدمين بإنشاء مؤتمرات تابعة لجهات خارجية والانضمام إليها من خلال إحدى الإضافات في Google Workspace أو إضافة مكالمات الفيديو في "تقويم Google"

اطّلِع على بيانات المؤتمر لمزيد من المعلومات.

منصة لمكالمات الفيديو

تمثيل لمكالمة فيديو تابعة لجهة خارجية يمكن إنشاؤها من "تقويم Google" باستخدام إضافة Google Workspace أو إضافة مكالمات الفيديو في "تقويم Google"

يمكنك الاطّلاع على حلول المؤتمرات لمزيد من المعلومات.

السياق

الحالة الحالية للتطبيق المضيف على سبيل المثال، الرسالة التي يتم حاليًا فتحها في Gmail أو حدث "تقويم Google" الذي تعدّله أو ملفات Drive التي اختَرتها هي جزء من السياق الحالي للتطبيق المضيف. يتم جمع السياق، بالإضافة إلى معلومات أخرى، في عنصر حدث يتم تمريره إلى دالة التفعيل كمَعلمة.

التفعيل السياقي

ممارسة تحديد عوامل التفعيل التي يتم تنشيطها عندما يدخل المستخدم في سياق معيّن، مثل فتح سلسلة محادثات بريد إلكتروني في Gmail يتيح لك التفعيل السياقي تقديم واجهة مستخدم ذات صلة بهذا السياق. يتم ضبط عوامل التفعيل المتعلّقة بالسياق في بيان مشروع نص برمجي للإضافات، وبالتالي فهي نوع من عوامل التفعيل في البيان.

إضافات المحرّر

المجموعة الأصلية من أنواع الإضافات التي كانت تسمح فقط بإضافة تطبيقات "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google" أو "العروض التقديمية من Google" لا تستند إضافات المحرِّر إلى البطاقات، بل كانت تتطلب من المطوّر إنشاء واجهة مستخدم من HTML وCSS الأوّليَين. لا يمكن لكل إضافة محرِّر توسيع تطبيق مضيف واحد فقط.

اطّلِع على إضافات المحرِّر للحصول على المزيد من التفاصيل.

عنصر الحدث

عنصر JSON الذي يتم إنشاؤه تلقائيًا عند طلب الصفحات الرئيسية، عند دخول الإضافة إلى السياقات التي تحتاج إلى الاستجابة لها، أو نتيجةً لتفاعلات المستخدمين مع التطبيقات المصغّرة في واجهة الإضافة بعد إنشائها، يتم تمرير عناصر الأحداث إلى وظيفة تشغيل محدّدة أو وظيفة استدعاء. الغرض من عناصر الأحداث هو تمرير المعلومات من بيئة المستخدم على جهة العميل (مثل المعلومات التي أدخلها في تطبيقات مصغّرة لواجهة الإضافة) إلى الرمز البرمجي على جهة الخادم للإضافة، والذي يمكنه بعد ذلك التعامل مع هذه المعلومات وعرض الاستجابة المناسبة.

اطّلِع على عناصر الأحداث للحصول على المزيد من التفاصيل.

إضافات Gmail

إضافة توفّر ميزات إضافية في Gmail فقط تستند إضافات Gmail إلى البطاقات. إنّ الكثير من تفاصيل الوظائف والسلوك والتطوير المستخدَمة لإنشاء إضافات Gmail تتطابق مع التفاصيل نفسها المستخدَمة لإنشاء إضافات Google Workspace.

اطّلِع على ملحقات Gmail للحصول على مزيد من المعلومات. اطّلِع أيضًا على مقالة ترقية الإضافات المنشورة للحصول على معلومات عن كيفية تحويل إضافة Gmail إلى إضافة Google Workspace.

الصفحة الرئيسية

بطاقة واجهة المستخدم الأساسية لأحد الإضافات يتم عرض الصفحات الرئيسية عندما يفتح المستخدمون الإضافة ويسمحون لها بعرض محتوى خارج سياق معيّن (على سبيل المثال، عندما يعرض المستخدم سلاسل محادثات البريد الإلكتروني في Gmail، ولكنّه لم يفتح سلسلة محادثات). يمكنك تحديد مظهر الصفحة الرئيسية الإضافية وسلوكها مثل أي بطاقة أخرى.

يمكنك الاطّلاع على الصفحات الرئيسية للحصول على مزيد من المعلومات.

المضيف أو تطبيق المضيف

تطبيق Google Workspace الذي تُوسّع إضافة Google Workspace نطاقه، مثل Gmail أو "تقويم Google"

مستندة إلى HTML

إضافة تم تحديد واجهة المستخدم فيها باستخدام HTML وCSS بدلاً من خدمة البطاقات المضمّنة في "برمجة تطبيقات Google" إنّ الإضافات القديمة في المحرّر فقط هي المستندة إلى HTML.

يتم تفعيل ميزة "معاينة الرابط" عندما يتفاعل المستخدمون مع عنوان URL تابع لجهة خارجية أو غير تابع لشركة Google ضمن تطبيق مضيف من Google، مثل "مستندات Google". يتيح لك تفعيل ميزة "معاينة الرابط" تحديد أنماط عناوين URL لمعاينتها من خدمتك أو واجهة برمجة التطبيقات، وضبط محتوى المعاينة، بما في ذلك الشريحة الذكية وبطاقة المعاينة. يتم ضبط عوامل التفعيل لميزة "معاينة الرابط" في نص برمجي لإضافة بيان المشروع، وبالتالي فهي نوع من عوامل التفعيل في البيان.

اطّلِع على معاينة الروابط باستخدام الشرائح الذكية للحصول على مزيد من المعلومات.

البيان

ملف JSON مرفق بمشروع "برمجة تطبيقات Google" يُستخدَم البيان لتحديد معلومات المشروع التي يحتاج النص البرمجي إلى تشغيلها بشكل صحيح. بالنسبة إلى إضافات Google Workspace، يتم استخدامملف الادراج لتحديد المضيفين الذين يمكن للإضافة الوصول إليهم وتوفير إعدادات معيّنة لعناصر التحكّم في واجهة المستخدم.

مشغِّل البيان

عامل تشغيل يتم تحديده في بيان المشروع، مثل عامل تشغيل الصفحة الرئيسية أو عامل تشغيل سياقي تُستخدَم عوامل تشغيل البيان حصريًا ل إنشاء بطاقات جديدة وعرضها عند طلب صفحة رئيسية للإضافات أو عند دخول الإضافة إلى سياق يتطلّب تعديل العرض.

تختلف عوامل تشغيل البيان عن عوامل التشغيل الأخرى في Apps Script لأنّها ليست مدمجة (مثل عوامل التشغيل البسيطة) ولا يمكن إنشاؤها برمجيًا باستخدام خدمة النصوص البرمجية في Apps Script (مثل عوامل التشغيل القابلة للتثبيت).

البطاقات غير السياقية

البطاقات التي تعرض المحتوى عندما يكون المستخدم خارج سياق معيّن، مثلاً عند عرض سلاسل محادثات البريد الإلكتروني في Gmail، ولكنّه لم يفتح أي منها الصفحات الرئيسية هي نوع من البطاقات غير السياقية.

القسم على يسار واجهة مستخدم المضيف الذي تظهر فيه واجهة مستخدم إضافة Google Workspace يمكن أيضًا أن تحدِّد إضافات Gmail و"محرّر Google" الأشرطة الجانبية.

شريحة ذكية

الشريحة الذكية هي إشارة إلى شخص أو ملف أو حدث في التقويم أو عنصر آخر ضمن تطبيق Google Workspace. عندما يمرّر المستخدمون مؤشر الماوس فوق شريحة، يمكنهم أيضًا معاينة محتوى إضافي عن الملف أو الرابط. على سبيل المثال، عندما يمرّر المستخدمون مؤشر الماوس فوق شريحة في عرض تقديمي على "العروض التقديمية من Google"، تظهر لهم لقطة شاشة لإحدى الشرائح، وصاحب العرض التقديمي، وما إذا كان قد شاهد العرض التقديمي من قبل.

يمكنك ضبط الإضافة لاستخدام الشرائح الذكية لمعاينة الروابط التي تؤدي إلى خدمة تابعة لجهة خارجية أو غير تابعة لشركة Google. اطّلِع على مقالة معاينة الروابط في "مستندات Google".

المشغِّل

شرط وردّ تلقائي على الحدث يحدّده مشروع أو إضافة في "برمجة تطبيقات Google" يتم تشغيل عوامل التشغيل عند وقوع الحدث المرتبط بها (على سبيل المثال، عند فتح إحدى الإضافة) وتؤدي إلى تنفيذ دالة محدّدة في Apps Script (دالة البدء) تلقائيًا. بالنسبة إلى إضافات Google Workspace، تنشئ وظائف التفعيل في كثير من الأحيان بطاقات جديدة للتحكّم في الجزء الذي يتم عرضه من واجهة مستخدم الإضافة. يمكن أن تحتوي أنواع أحداث معيّنة فقط على عوامل تشغيل.

اطّلِع على عوامل التشغيل الإضافية للحصول على مزيد من المعلومات.

دالة التفعيل

دالة "برمجة تطبيقات Google" في مشروع يتم تنفيذها استجابةً لبدء بدء مثبّت.

أداة

عنصر واجهة مستخدِم، مثل زر أو حقل نصي أو مربّع اختيار يتم إنشاء البطاقات من تسلسل عناصر التطبيقات المصغّرة، والتي تحدّدها خدمة البطاقات المضمّنة في Apps Script.

اطّلِع على تطبيقات المصغّرة للحصول على مزيد من المعلومات.

دالة معالِج التطبيق المصغّر

دالة تربط أداة عرض معيّنة بعنصر إجراء معيّن يحتوي كل نوع من أنواع التطبيقات المصغّرة على مجموعة من دوالّ معالِج التطبيقات المصغّرة المحدّدة التي يمكن استخدامها للربط بأحد الإجراءات. تحدِّد وظائف معالجات التطبيقات المصغّرة نوع تفاعل المستخدِم الذي يؤدي إلى بدء الإجراء الناتج، وهي مكوّن مهم من تفاعل التطبيقات المصغّرة.

اطّلِع على وظائف معالِج التطبيقات المصغّرة لمزيد من المعلومات.