تقدّم هذه الصفحة نظرة عامة حول كيفية إنشاء واجهات مستخدم (UI) لإضافات Google Workspace التي توفّر ميزات إضافية في Google Chat.
في Google Chat، تظهر الإضافات للمستخدمين على أنّها تطبيقات Google Chat. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على توسيع نطاق Google Chat.
لإنشاء واجهات لتطبيقات Chat، يمكنك استخدام المكونات الإضافية التالية:
- عوامل التشغيل: الطرق التي يمكن لمستخدمي Google Chat من خلالها تشغيل أحد تطبيقات Chat، مثل إضافته إلى مساحة أو إرسال رسالة إليه
- عناصر الأحداث: البيانات التي تتلقّاها تطبيقات Chat من عوامل التفعيل أو تفاعلات واجهة المستخدم
- الإجراءات: الطرق التي يمكن لتطبيقات Chat من خلالها الردّ على التفاعلات، مثل إرسال الرسائل أو عرض واجهة مستخدم مستندة إلى بطاقات
يمكن لتطبيقات Chat إنشاء البطاقات وعرضها في الواجهتَين التاليتَين:
- الرسائل التي يمكن أن تحتوي على نص، وبطاقات ثابتة أو تفاعلية، وأزرار
- مربّعات الحوار، وهي بطاقات تفتح في ملف شخصي جديد وتطلب عادةً من المستخدمين إرسال معلومات.
- معاينات الروابط، وهي بطاقات تعرض معاينة للمعلومات حول خدمة خارجية
العوامل التي تؤدي إلى الظهور
يوضّح هذا القسم عوامل التفعيل التي تستخدمها إضافات Google Workspace في Chat.
العوامل المشغِّلة هي الطرق المحدّدة التي يستخدمها المستخدمون لتشغيل تطبيق Chat باستخدام واجهة مستخدم Chat، مثل استخدام الإشارات @أو أوامر التطبيق.
يعرض الجدول التالي عوامل تشغيل Chat ووصفًا وكيفية استجابة تطبيقات Chat عادةً:
| المشغِّل | الوصف | الردّ المعتاد |
|---|---|---|
| تمّت الإضافة إلى المساحة |
يضيف مستخدم تطبيق Chat إلى مساحة، أو يُثبِّت مشرف Google Workspace تطبيق Chat في مساحات الرسائل المباشرة للمستخدمين في مؤسسته. للتعرّف على تطبيقات Chat التي ثبَّتها المشرفون، يُرجى الاطّلاع على مقالة تثبيت تطبيقات Marketplace في نطاقك في مستندات مركز مساعدة مشرفي Google Workspace. |
يرسل تطبيق Chat رسالة ترحيب توضّح وظائفه وكيفية تفاعل المستخدمين في المساحة معه. |
| رسالة |
يتفاعل أحد المستخدمين مع تطبيق Chat في رسالة بإحدى الطريقتَين التاليتَين:
|
يردّ تطبيق
Chat استنادًا إلى محتوى
الرسالة. على سبيل المثال، يردّ تطبيق Chat على
الأمر الذي يبدأ بشرطة مائلة /about برسالة توضّح
المهام التي يمكن لتطبيق Chat تنفيذها.
|
| تمت الإزالة من المساحة |
يزيل مستخدم تطبيق Chat من مساحة، أو يزيل مشرف Google Workspace تطبيق Chat لمستخدم في مؤسسته. لا يمكن للمستخدمين إزالة تطبيقات Chat التي ثبَّتها المشرف. إذا سبق للمستخدم تثبيت تطبيق Chat، سيظل تطبيق Chat مثبّتًا بغض النظر عمّا إذا حاول أحد مشرفي Google Workspace إلغاء تثبيته. |
يزيل تطبيق Chat أي إشعارات واردة تم ضبطها للمساحة (مثل حذف رابط ويب للطلبات) ويُخلي أي مساحة تخزين داخلية. لا يمكن لتطبيقات Chat الردّ على هذا المشغِّل برسائل لأنّها لم تعُد عضوًا في المساحة. |
| أمر التطبيق |
يستخدم أحد المستخدمين أحد أوامر تطبيق Chat. |
يستجيب تطبيق Chat للأمر. على سبيل المثال، الردّ برسالة أو فتح مربّع حوار |
على عكس إضافات Google Workspace الأخرى، عليك ضبط أي وظائف طلب معاودة اتصال ل هذه المشغّلات باستخدام Google Chat API. للحصول على إرشادات، يُرجى الاطّلاع على مقالة ضبط تطبيق Google Chat.
للردّ على عامل تشغيل، اطّلِع على الأدلة التالية:
عناصر الحدث
تتلقّى تطبيقات Chat عناصر الأحداث عند بدء أحد عوامل التفعيل في Chat، أو عندما يتفاعل مستخدمو Chat مع واجهة مستخدم من تطبيق Chat (مثل النقر على زر). يحتوي عنصر الحدث على بيانات عن التفاعل الذي يمكن لتطبيق Chat استخدامه للردّ على واجهة مستخدم أو تعديلها.
للتعرّف على كيفية التعامل مع عناصر الأحداث، اطّلِع على الأدلة التالية:
للتعرّف على عناصر الأحداث الإضافية ضمن Chat وتطبيقات Google Workspace الأخرى، يُرجى الاطّلاع على عناصر الأحداث.
إجراءات تتعلّق بالمحادثة
يوضّح هذا القسم كيفية استخدام تطبيقات Chat الإجراءات الإضافية للردّ على تفاعلات المستخدمين.
للردّ بإجراء إضافي، يجب أن يستجيب تطبيق Chat في غضون 30 ثانية، ويجب أن يتم نشر الردّ في المساحة التي حدث فيها التفاعل. بخلاف ذلك، يجب أن يُعدّ تطبيق Chat مصادقة ويطلب بيانات من Google Chat API للردّ.
يمكن لتطبيقات المحادثة التعامل مع التفاعلات والردّ عليها بعدة طرق. في كثير من الحالات، تردّ تطبيقات Chat برسالة. يمكن لتطبيقات المحادثة أيضًا البحث عن بعض المعلومات من مصدر بيانات، أو تسجيل معلومات عنصر الحدث، أو أي شيء آخر. يُعدّ سلوك المعالجة هذا هو ما يحدِّد بشكل أساسي تطبيق Google Chat.
للردّ على تفاعلات المستخدمين، يجب أن تعالج تطبيقات Chat عنصر الحدث المقابل وأن تعرض أحد عناصر JSON التالية:
-
DataActions: إنشاء أو تعديل بيانات Google Workspace لإرسال رسائل Chat أو تعديلها، يجب أن يحتوي العنصر على الترميز الذي يحدّد التغييرات في بياناتMessage، والتي يتم تمثيلها على النحو التالي:chatDataActionMarkup. RenderActions: يمكنك إنشاء ملف شخصي أو تعديله في مربّع حوار أو تقديم اقتراحات إدخال في ملف شخصي في قائمة اختيار متعدّد.-
AuthorizationError: يطلب من المستخدمين الذين لديهم بطاقة تفويض تسجيل الدخول أو المصادقة على خدمة خارجية غير تابعة لشركة Google. في Chat، لا تتوفّر سوى بطاقة التفويض الأساسية.
| استجابة تطبيق Chat | الإجراء المطلوب للإرجاع |
|---|---|
| إرسال رسالة أو تعديلها | DataActions |
| فتح مربّع حوار أو تعديله أو إغلاقه | RenderActions |
| لـ جمع المعلومات من بطاقة أو مربّع حوار، يمكنك اقتراح عناصر اختيار استنادًا إلى ما يطلبه المستخدمون في قائمة اختيار متعدّد. | RenderActions |
| معاينة الروابط في الرسائل التي يرسلها مستخدمو Chat في مساحة | DataActions |
الردّ باستخدام Google Chat API
بدلاً من عرض إجراء إضافي، قد تحتاج تطبيقات Chat إلى استخدام Google Chat API للردّ على أحد التفاعلات. على سبيل المثال، يجب أن تستدعي تطبيقات Chat واجهة برمجة التطبيقات Google Chat API للقيام بأي مما يلي:
- الردّ على تفاعل بعد 30 ثانية
- تنفيذ المهام خارج المساحة التي حدث فيها التفاعل
- تنفيذ مهام في Chat غير متاحة كأحد الإجراءات الإضافية على سبيل المثال، يمكنك إدراج المساحات التي يكون فيها مستخدم أو تطبيق Chat عضوًا، أو إضافة مستخدمين إلى المساحة.
- تنفيذ المهام نيابةً عن مستخدم Chat (يتطلب ذلك مصادقة المستخدم)
للتعرّف على كيفية المصادقة على Chat API والاتّصال بها، يُرجى الاطّلاع على نظرة عامة على Chat API.
مواضيع ذات صلة
- عوامل التفعيل لإضافات Google Workspace
- ضبط تطبيق Google Chat
- عناصر الأحداث
- الإجراءات الإضافية
- إرسال رسائل Google Chat
- فتح مربّعات حوار تفاعلية
- معاينة الروابط في رسائل Google Chat
- نظرة عامة على Chat API