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