تقدّم هذه الصفحة نظرة عامة حول كيفية إنشاء إضافات Google Workspace التي توسّع نطاق Google Chat.
يمكن أن تساعد إضافات Google Workspace التي توسّع نطاق Chat المستخدمين في تنفيذ أي مما يلي:
- معاينة الروابط من رسائل Chat واتّخاذ إجراءات بدون مغادرة المحادثة
- تنفيذ المهام أو إدارتها تلقائيًا في جميع تطبيقات Google Workspace
- تلقّي تنبيهات أو إشعارات بشأن أدوات أو خدمات خارجية
طريقة عمل إضافات Google Workspace في Chat
في Chat، تظهر الإضافات للمستخدمين كتطبيقات Google Chat. للتفاعل مع المستخدمين، يمكن لتطبيقات Chat تنفيذ ما يلي:
- إرسال رسائل تحتوي على نصوص وبطاقات وعناصر تفاعلية في واجهة المستخدم
- الردّ على الطلبات السريعة
- الردّ على الأوامر التي تبدأ بشرطة مائلة
- افتح مربّعات الحوار لمساعدة المستخدمين في إكمال العمليات المتعدّدة الخطوات، مثل ملء بيانات النماذج.
- معاينة الروابط في الرسائل من خلال إرفاق بطاقات تتضمّن معلومات مفيدة تتيح للمستخدمين اتّخاذ إجراء مباشرةً من المحادثة
البدء
لبدء إنشاء إضافات Google Workspace تعمل في Chat، يُرجى الاطّلاع على المستندات التالية:
- جرِّب التشغيل السريع لإنشاء تطبيق Chat أساسي باستخدام برمجة تطبيقات Google أو خدمة HTTP.
- ضبط تطبيق Chat وميزاته التفاعلية باستخدام Chat API
- تعرَّف على الطرق التي يمكنك من خلالها إنشاء واجهات Chat باستخدام مشغّلات وإجراءات وكائنات أحداث الإضافات.
القيود والمشاكل المعروفة
لا تتوفّر ميزات الدردشة والإضافات التالية:
- لا تتوفّر بنيات تطبيقات Chat التالية: Dialogflow وPub/Sub وAppSheet. بدلاً من ذلك، عليك إنشاء تطبيق Chat باستخدام Apps Script أو خدمة HTTP.
- خدمة البطاقات في Apps Script لاستخدام إجراءات المحادثة وإنشاء بطاقات، عليك عرض عناصر JSON بدلاً من ذلك. للاطّلاع على أمثلة، راجِع فتح مربّعات حوار تفاعلية و معاينة الروابط.
- بطاقات التفويض المخصّصة للمصادقة على خدمتك ومنحها إذن الوصول من Chat، يجب أن يعرض تطبيق Chat بطاقة تفويض أساسية.
- الصفحات الرئيسية للإضافات في الشريط الجانبي في Chat إذا كنت قد أعددت مشغّل الصفحة الرئيسية للإضافة، لن تظهر الصفحة الرئيسية إلا في الشريط الجانبي لتطبيقات Google Workspace الأخرى التي توسّعها الإضافة.
- الصفحات الرئيسية لتطبيقات Chat، التي تظهر في علامة التبويب الصفحة الرئيسية ضمن الرسائل المباشرة مع تطبيق Chat
إذا كنت بصدد تعديل إضافة حالية في Google Workspace، يُرجى مراعاة متطلبات الإعداد التالية لتطبيقات Chat:
- يجب أن تسمح إعدادات التثبيت في Google Workspace Marketplace لكل من الأفراد ومشرفي Google Workspace بتثبيت الإضافة.
- يتم تجاهل أي إعدادات ضبط شائعة في بيان الإضافة
(
addons.common
) في Chat. لضبط الإضافة كي تعمل في Chat، عليك تفعيل واجهة برمجة التطبيقات Chat API وضبط إعداداتها. لمعرفة الخطوات، يُرجى الاطّلاع على المقالة ضبط تطبيق Google Chat. - لنشر إضافة واختبارها في Chat، عليك استخدام إعداد إمكانية الوصول في Chat API. يتم تجاهل أي إعدادات متعلقة بإمكانية الوصول أو الاختبار تم ضبطها في حزمة تطوير البرامج (SDK) في Google Workspace Marketplace. لنشر نسخة تجريبية من الإضافة في Chat، يمكنك الاطّلاع على اختبار الميزات التفاعلية لتطبيقات Google Chat في مستندات Chat API.
- إذا تم نشر الإضافات في Google Workspace Marketplace، لن تتمكّن من حفظ مسودة لأي تغييرات في إعدادات ضبط Google Chat API. عند تعديل إعدادات ضبط واجهة برمجة التطبيقات في Chat، يصبح تطبيق Chat المعدَّل متاحًا فورًا لجميع المستخدمين الحاليين. لتعديل بطاقة بياناتك على Marketplace، يمكنك إنشاء مسودة قبل إرسال أي تغييرات.