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