تُستخدَم المصطلحات التالية في جميع أنحاء هذه المستندات.
إضافة مكالمات الفيديو في "تقويم Google"
نوع خاص من الإضافات يُستخدَم للسماح لمقدّمي خدمات مكالمات الفيديو بعرض خيارات مكالمات الفيديو في أحداث "تقويم 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 بدلاً من خدمة البطاقات المضمّنة في Apps Script. إضافات المحرّر القديمة فقط تستند إلى HTML.
مشغّل معاينة الرابط
يتم تشغيل مشغّلات معاينة الروابط عندما يتفاعل المستخدمون مع عنوان URL تابع لجهة خارجية أو غير تابع لـ Google ضمن تطبيق مضيف من Google، مثل "مستندات Google". تتيح لك ميزة "تشغيل معاينة الرابط" تحديد أنماط عناوين URL للمعاينة من خدمتك أو واجهة برمجة التطبيقات، كما تتيح لك ضبط محتوى المعاينة، بما في ذلك الشريحة الذكية وبطاقة المعاينة. يتم ضبط مشغّلات معاينة الروابط في بيان مشروع نص الإضافة، وبالتالي فهي نوع من مشغّلات البيان.
يمكنك الاطّلاع على مقالة معاينة الروابط باستخدام الشرائح الذكية لمزيد من المعلومات.
البيان
ملف JSON مرفق بمشروع "برمجة تطبيقات Google" يُستخدَم البيان لتحديد معلومات المشروع التي يحتاجها النص البرمجي ليعمل بشكل صحيح. بالنسبة إلى إضافات Google Workspace، يتم استخدام ملف البيان لتحديد المضيفين الذين يمكن أن توسّعهم الإضافة وتوفّر إعدادات معيّنة للتحكّم في واجهة المستخدم.
مشغّل ملف البيان
عامل تشغيل محدّد في بيان المشروع، مثل عامل تشغيل الصفحة الرئيسية أو عامل التشغيل السياقي يتم استخدام مشغّلات ملف البيان حصريًا لإنشاء بطاقات جديدة وعرضها عند طلب الصفحة الرئيسية للإضافة أو عندما تدخل الإضافة في سياق يتطلّب تعديل العرض.
تختلف مشغّلات البيان عن المشغّلات الأخرى في "برمجة تطبيقات Google" لأنّها ليست مدمجة (مثل المشغّلات البسيطة) ولا يمكن إنشاؤها آليًا باستخدام خدمة النص البرمجي في برمجة تطبيقات Google (مثل المشغّلات القابلة للتثبيت).
البطاقات غير السياقية
البطاقات التي تعرض المحتوى عندما يكون المستخدم خارج سياق معيّن، مثلاً، عند عرض سلاسل الرسائل الإلكترونية في Gmail، ولكن بدون فتح أي رسالة الصفحات الرئيسية هي نوع من البطاقات غير السياقية.
شريط جانبي
القسم على يسار واجهة مستخدم التطبيق المضيف حيث تظهر واجهة مستخدم إحدى إضافات Google Workspace يمكن أيضًا لإضافات Gmail و"المحرّر" تحديد أشرطة جانبية.
شريحة ذكية
الشريحة الذكية هي إشارة إلى شخص أو ملف أو حدث في التقويم أو كيان آخر ضمن أحد تطبيقات Google Workspace. عندما يمرّر المستخدمون مؤشر الماوس فوق شريحة، يمكنهم أيضًا معاينة محتوى إضافي حول الملف أو الرابط. على سبيل المثال، عندما يمرّر المستخدمون مؤشر الماوس فوق شريحة لعرض تقديمي من "العروض التقديمية من Google"، تظهر لهم لقطة شاشة للشريحة ومالك العرض التقديمي وما إذا كانوا قد شاهدوا العرض التقديمي من قبل.
يمكنك ضبط الإضافة لاستخدام الشرائح الذكية لمعاينة الروابط الخاصة بخدمة تابعة لجهة خارجية أو غير تابعة لـ Google. يمكنك الاطّلاع على مقالة معاينة الروابط في "مستندات Google".
Trigger
شرط واستجابة تلقائية للحدث يحدّدهما مشروع أو إضافة في "برمجة تطبيقات Google" يتم تشغيل المشغّلات عند وقوع الحدث المرتبط بها (على سبيل المثال، عند فتح إضافة) وتؤدي إلى تنفيذ دالة برمجة تطبيقات محدّدة (دالة المشغّل) تلقائيًا. بالنسبة إلى إضافات Google Workspace، غالبًا ما تنشئ الدوال المشغِّلة بطاقات جديدة للتحكّم في الجزء الذي يتم عرضه من واجهة مستخدم الإضافة. يمكن أن تحتوي أنواع أحداث معيّنة فقط على عوامل تشغيل.
اطّلِع على عوامل تشغيل الإضافات لمزيد من المعلومات.
دالة التشغيل
دالة في "برمجة تطبيقات Google" ضمن مشروع يتم تنفيذه استجابةً لتفعيل مشغّل.
أداة
عنصر في واجهة المستخدم، مثل زر أو حقل نص أو مربّع اختيار يتم إنشاء البطاقات من تسلسل لعناصر واجهة المستخدم، ويتم تحديدها من خلال خدمة البطاقات المضمّنة في "برمجة تطبيقات Google".
لمزيد من المعلومات، اطّلِع على التطبيقات المصغّرة.
دالة معالجة التطبيق المصغّر
دالة تربط عنصر واجهة مستخدم معيّنًا بكائن إجراء معيّن. يحتوي كل نوع من أنواع الأدوات على مجموعة من دوال معالجة الأدوات المحدّدة التي يمكن استخدامها للربط بالإجراءات. تحدّد دوال معالجة الأدوات نوع تفاعل المستخدم الذي يؤدي إلى تشغيل الإجراء الناتج، وهي عنصر أساسي في تفاعلية الأدوات.
اطّلِع على دوال معالجة التطبيقات المصغّرة للحصول على مزيد من المعلومات.