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