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