توسيع نطاق Google Chat

تقدّم هذه الصفحة نظرة عامة حول كيفية إنشاء إضافات Google Workspace التي توفّر ميزات إضافية في Google Chat.

يمكن أن تساعد إضافات Google Workspace التي توفّر ميزات إضافية في Chat المستخدمين في تنفيذ أيّ مما يلي:

• معاينة الروابط من رسائل Chat واتّخاذ إجراء بدون مغادرة المحادثة
• تنفيذ المهام أو إجراؤها تلقائيًا في تطبيقات Google Workspace
• تلقّي تنبيهات أو إشعارات بشأن أدوات أو خدمات خارجية

آلية عمل إضافات Google Workspace في Chat

في Chat، تظهر الإضافات للمستخدمين على أنّها تطبيقات Google Chat. للتفاعل مع المستخدمين، يمكن لتطبيقات Chat تنفيذ ما يلي:

• إرسال رسائل تحتوي على نص و بطاقات وعناصر واجهة مستخدم تفاعلية
• الردّ على الأوامر التي تبدأ بشرطة مائلة
• افتح مربّعات حوار ل help users complete multi-step processes, like filling in form data.
• معاينة الروابط في الرسائل من خلال إرفاق بطاقات تتضمّن معلومات مفيدة تتيح للمستخدمين اتّخاذ إجراء مباشرةً من المحادثة

البدء

لبدء إنشاء إضافات Google Workspace التي تعمل في Chat، يُرجى الاطّلاع على المراجع التالية:

• جرِّب بدء سريع لإنشاء تطبيق Chat أساسي باستخدام Google Apps Script أو خدمة HTTP.
• ضبط تطبيق Chat وميزاته التفاعلية باستخدام Chat API
• تعرَّف على الطرق التي يمكنك بها إنشاء واجهات Chat باستخدام عوامل التشغيل والإجراءات وعناصر الأحداث الإضافية.

القيود والمشاكل المعروفة

ميزات Chat الإضافية التالية غير متاحة:

• ‫خدمة البطاقات في Apps Script لاستخدام إجراءات المحادثة وإنشاء بطاقات، أعِد كائنات JSON بدلاً من ذلك. للحصول على أمثلة، اطّلِع على فتح مربّعات حوار تفاعلية ومعاينة الروابط.
• بطاقات التفويض المخصّصة للمصادقة على خدمتك ومنحها تفويضًا من Chat، يجب أن يعرض تطبيق Chat بطاقة تفويض أساسية.
• صفحات الإضافات الرئيسية في الشريط الجانبي في Chat إذا أعددت عامل تشغيل للصفحة الرئيسية لإضافة ، لن تظهر الصفحة الرئيسية إلا في الشريط الجانبي لتطبيقات Google Workspace الأخرى التي توفّرها إضافة.
• الصفحات الرئيسية لتطبيق Chat، التي تظهر في علامة التبويب الصفحة الرئيسية للرسائل المباشرة باستخدام تطبيق Chat

إذا كنت بصدد تعديل إضافة حالية في Google Workspace، ننصحك بالاطّلاع على متطلبات الضبط التالية لتطبيقات Chat:

• يجب أن تسمح إعدادات التثبيت في Google Workspace Marketplace للمستخدمين ومشرفي Google Workspace بالتثبيت للإضافة.
• يتم تجاهل أي إعدادات ضبط شائعة في manifest (addons.common) الملحق في Chat. لضبط الإضافة للعمل في Chat، عليك تفعيل واجهة برمجة التطبيقات Chat API وضبطها. لمعرفة الخطوات، يُرجى الاطّلاع على مقالة ضبط تطبيق Google Chat.
• إذا كنت بصدد إنشاء تطبيق باستخدام خدمة HTTP، يجب تفعيل Google Workspace Add-ons API. لا تنطبق موارد REST deployment وproject إلا على عمليات نشر الإضافات في تطبيقات Google Workspace الأخرى.
• لنشر إضافة واختبارها في Chat، يجب استخدام إعداد مستوى العرض في Chat API. يتم تجاهل أي إعدادات للرؤية أو الاختبار ضبطتها في حزمة تطوير البرامج (SDK) في Google Workspace Marketplace. لنشر إصدار تجريبي من الإضافة في Chat، اطّلِع على اختبار الميزات التفاعلية لتطبيقات Google Chat في مستندات Chat API.
• إذا تم نشر إضافاتك على Google Workspace Marketplace، لا يمكنك حفظ مسودة لأي تغييرات على إعدادات ضبط Google Chat API. عند تعديل إعدادات ضبط Chat API، يصبح تطبيق Chat المعدَّل متاحًا فورًا لجميع المستخدمين الحاليين. لتعديل بطاقة بياناتك على Marketplace، يمكنك إنشاء مسودة قبل إرسال أي تغييرات.

مواضيع ذات صلة

• نظرة عامة على مستندات Google Chat API