إنشاء تطبيق تفاعلي على Google Chat

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

تتيح تطبيقات Chat التفاعلية للمستخدمين إجراء أيّ مما يلي:

كيفية عثور المستخدمين على تطبيقات Chat التفاعلية واستخدامها

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

  • البحث عن تطبيقات Chat وتثبيتها من Google Chat أو Marketplace
  • التفاعل مع تطبيق Chat تمت إضافته إلى مساحة في Chat
  • استكشاف تطبيق Chat في لوحة الرسائل المباشرة بعد أن يثبّت مشرف Google Workspace تطبيق Chat نيابةً عنهم

لبدء استخدام تطبيق في Chat، يمكن لمستخدمي Google Chat بدء رسالة مباشرة مع تطبيق Chat أو إضافته إلى مساحة. يمكن للمستخدمين أيضًا إضافة تطبيق Chat من خلال الإشارة إليه باستخدام @. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة استخدام تطبيقات Chat.

يوضّح المثال التالي كيف يشير مستخدم إلى تطبيق Chat من خلال @لإضافته إلى مساحة:

إضافة تطبيق Chat إلى مساحة من خلال كتابة @ في رسالة

البدء

لبدء إنشاء تطبيق تفاعلي على Chat، اطّلِع على المستندات التالية:

إعداد تطبيق Chat أساسي وإنشاؤه

يسرد الجدول التالي مستندات ضبط Chat API وإنشاء تطبيق Chat تفاعلي أساسي لكل بنية تطبيق Google Chat:

البنية أو المهمة الدليل
ضبط إعدادات Chat API ضبط إعدادات Google Chat API
البدء السريع
برمجة التطبيقات إنشاء تطبيق Chat باستخدام "برمجة تطبيقات Google"
خدمة HTTP (دوال Cloud Run) إنشاء تطبيق Chat يستند إلى HTTP
Pub/Sub إنشاء تطبيق Chat باستخدام Pub/Sub
Dialogflow CX إنشاء تطبيق Chat في Dialogflow CX
Dialogflow ES إنشاء تطبيق Chat باستخدام Dialogflow ES
وكيل الذكاء الاصطناعي في "حزمة تطوير الوكلاء" (ADK) إنشاء تطبيق Chat لوكيل الذكاء الاصطناعي في "حزمة تطوير التطبيقات على Android"
وكيل الذكاء الاصطناعي Agent2Agent (A2A) إنشاء تطبيق Chat لوكيل الذكاء الاصطناعي من تطبيق إلى تطبيق
وكيل الذكاء الاصطناعي A2UI إنشاء تطبيق Chat لوكيل الذكاء الاصطناعي في A2UI
وكيل الذكاء الاصطناعي من Gemini Enterprise إنشاء تطبيق Chat لوكيل الذكاء الاصطناعي من Gemini Enterprise

إنشاء ميزات تفاعلية

يعرض الجدول التالي مستندات إنشاء ميزات تفاعلية لتطبيق Chat:

الميزة الدليل
تلقّي تفاعلات المستخدمين والردّ عليها تلقّي تفاعلات المستخدمين والردّ عليها
إرسال الرسائل (الردّ على التفاعلات أو إرسال الرسائل بشكل استباقي) الرد برسالة أو إرسال رسالة باستخدام Chat API
الردّ على الأوامر التي تبدأ بشرطة مائلة والأوامر السريعة وإجراءات الرسائل الردّ على الأوامر
إنشاء مربّعات حوار تفاعلية فتح مربّعات الحوار التفاعلية
جمع المعلومات ومعالجتها من البطاقات ومربّعات الحوار قراءة بيانات النماذج التي أدخلها المستخدمون على البطاقات
معاينة الروابط في رسائل Chat روابط المعاينة
إنشاء صفحة رئيسية (صفحة التطبيق الرئيسية) في الرسائل المباشرة بين شخصَين إنشاء صفحة رئيسية لتطبيق Chat
الربط بأنظمة وأدوات خارجية ربط تطبيق Chat بخدمات وأدوات أخرى

القيود والاعتبارات المتعلقة بإضافات Google Workspace

بما أنّ تطبيقات Chat مصمَّمة كإضافات في Google Workspace توسّع نطاق Chat، يُرجى مراعاة القيود التالية على الميزات:

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

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

تطبيقات Chat التي ليست إضافات: إنشاء تطبيق تفاعلي في Google Chat

يتم إنشاء تطبيقات المحادثة التي ليست إضافات Google Workspace كتطبيقات مخصّصة للمحادثة فقط تتلقّى أحداث التفاعل مع Chat API (Event) بدلاً من عناصر أحداث إضافات Google Workspace (EventObject) والإجراءات.

إذا كنت تحتفظ بتطبيق Chat ليس إضافة، يمكنك إجراء ما يلي:

  • يمكنك تحويل تطبيق Chat الذي ليس إضافة إلى إضافة Google Workspace توسّع نطاق Google Chat. يُرجى الاطّلاع على تحويل تطبيق Google Chat إلى إضافة Google Workspace.
  • راجِع أقسام تطبيقات المحادثة التي ليست إضافات القابلة للتوسيع في أسفل كل دليل خاص بميزة تفاعلية ضمن مجموعة المستندات هذه لمعرفة تنسيقات الطلبات والردود.