تقدّم هذه الصفحة نظرة عامة حول كيفية إنشاء واجهات مستخدم (UIs) لإضافات Google Workspace التي توسّع نطاق Google Chat.
لإنشاء واجهات لتطبيقات Chat، يمكنك استخدام مكوّنات الإضافة التالية:
- عوامل التشغيل: هي الطرق التي يمكن لمستخدمي Google Chat من خلالها استدعاء تطبيق Chat، مثل إضافته إلى مساحة أو إرسال رسالة إليه.
- عناصر الأحداث: البيانات التي تتلقّاها تطبيقات Chat من المشغّلات أو التفاعلات مع واجهة المستخدم
- الإجراءات: هي الطرق التي يمكن لتطبيقات Chat من خلالها الاستجابة للتفاعلات، مثل إرسال الرسائل أو عرض واجهة مستخدم مستندة إلى البطاقات.
يمكن لتطبيقات المحادثة إنشاء البطاقات وعرضها في الواجهات التالية:
- الرسائل التي يمكن أن تحتوي على نص وبطاقات ثابتة أو تفاعلية وأزرار
- مربّعات الحوار وهي بطاقات تفتح في نافذة جديدة وتطلب عادةً من المستخدمين إرسال معلومات.
- معاينات الروابط وهي بطاقات تعرض معلومات عن خدمة خارجية.
العوامل التي تؤدي إلى الظهور
يوضّح هذا القسم المشغّلات التي تستخدمها إضافات Google Workspace في Chat.
المشغّلات هي الطرق المحدّدة التي يستدعي بها المستخدمون تطبيق Chat باستخدام واجهة مستخدم Chat، مثل استخدام الإشارات @أو أوامر التطبيق.
يعرض الجدول التالي مشغّلات Chat ووصفًا لها وكيفية استجابة تطبيقات Chat عادةً:
| Trigger | الوصف | الردّ النموذجي |
|---|---|---|
| تمت الإضافة إلى المساحة |
يضيف المستخدم تطبيق Chat إلى مساحة، أو يثبّت مشرف Google Workspace تطبيق Chat في مساحات الرسائل المباشرة للمستخدمين في مؤسسته. لمزيد من المعلومات عن تطبيقات Chat التي يثبّتها المشرفون، يُرجى الاطّلاع على مقالة تثبيت تطبيقات Marketplace في نطاقك ضمن مستندات "مساعدة مشرف Google Workspace". |
يرسل تطبيق Chat رسالة تعريفية توضّح وظيفة التطبيق وكيفية تفاعل المستخدمين في المساحة معه. |
| رسالة |
يتفاعل المستخدم مع تطبيق Chat في رسالة بإحدى الطرق التالية:
|
يردّ تطبيق Chat استنادًا إلى محتوى الرسالة. على سبيل المثال، يردّ تطبيق Chat على الأمر /about الذي يبدأ بشرطة مائلة برسالة توضّح المهام التي يمكن أن ينفّذها تطبيق Chat.
|
| تمت الإزالة من المساحة |
يزيل المستخدم تطبيق Chat من مساحة، أو يلغي مشرف Google Workspace تثبيت تطبيق 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، لا تتوفّر سوى بطاقة التفويض الأساسية.
| ردّ تطبيق المحادثات | الإجراء المطلوب لإرجاع المنتج |
|---|---|
| إرسال رسالة أو تعديلها | DataActions |
| فتح مربع حوار أو تعديله أو إغلاقه | RenderActions |
| لجمع المعلومات من بطاقة أو مربّع حوار، اقترح عناصر اختيار استنادًا إلى ما يكتبه المستخدمون في قائمة اختيار متعدّد. | RenderActions |
| معاينة الروابط في الرسائل التي يرسلها مستخدمو Chat في مساحة | DataActions |
الردّ باستخدام Google Chat API
بدلاً من عرض إجراء إضافة، قد تحتاج تطبيقات Chat إلى استخدام Google Chat API للرد على تفاعل. على سبيل المثال، يجب أن تستخدم تطبيقات Chat واجهة برمجة تطبيقات Google Chat لتنفيذ أي مما يلي:
- الردّ على تفاعل بعد 30 ثانية
- تنفيذ مهام خارج المساحة التي حدث فيها التفاعل
- تنفيذ مهام في Chat غير متاحة كإجراءات إضافية على سبيل المثال، يمكنك إدراج المساحات التي يكون المستخدم أو تطبيق Chat عضوًا فيها، أو إضافة مستخدمين إلى مساحة.
- تنفيذ مهام نيابةً عن مستخدم Chat (يتطلّب ذلك مصادقة المستخدم)
لمعرفة كيفية المصادقة على Chat API واستدعائه، يُرجى الاطّلاع على نظرة عامة على Chat API.
مواضيع ذات صلة
- المشغّلات لإضافات Google Workspace
- ضبط تطبيق Google Chat
- عناصر الحدث
- إجراءات الإضافة
- إرسال رسائل Google Chat
- فتح مربّعات الحوار التفاعلية
- معاينة الروابط في رسائل Google Chat
- نظرة عامة على Chat API