نظرة عامة

إنشاء تطبيقات Google Chat التي توفّر خدماتك ومواردك مباشرةً إلى Google Chat، ما يسمح للمستخدمين بالحصول على المعلومات واتّخاذ إجراء بدون مغادرة المحادثة

يدعم Google Chat التعاون بين أعضاء الفريق من خلال توفير ما يلي:

  • الرسائل المباشرة بين المستخدمين.
  • المحادثات ضمن سلاسل المحادثات داخل المساحات
  • مساحات Chat التي تتيح لك تخصيص مساحة مناقشة على أساس كل مشروع أو لكل فريق أو أي أساس آخر.
  • تطبيقات Chat التي يمكنها المشاركة في المساحات أو الردّ على الرسائل المباشرة

الرسائل والمساحات

تحدث التفاعلات بين Google Chat وتطبيقات Chat باستخدام الرسائل في سياق مساحات معينة. على سبيل المثال، يمكن لتطبيق Chat إرسال نص (نوع من الرسائل) إلى مساحة Chat محدّدة.

تتضمن الرسائل التفاعلات مع تطبيقات Chat أو الرسائل النصية أو البطاقات، بينما تشتمل المساحات على غرف المحادثة والرسائل المباشرة.

يعرض المخطّط السابق الأنواع المختلفة من التفاعلات والسياقات المتاحة للرسائل والمساحات:

  • تتّبع الرسائل بين Google Chat وتطبيق Chat تنسيق رسالة محدّد، حيث تتألف كل رسالة من عنصر JSON تحدّد مكوّناته رقم تعريف المستخدم والنمط والمحتوى وجوانب أخرى من الرسالة. يمكن لتطبيقات الدردشة إرسال أنواع الرسائل التالية:

    • تحتوي الرسائل النصية على محتوى نص عادي بتنسيق نصي محدود.
    • وتحدِّد رسائل البطاقات تنسيق البطاقات ومحتواها وسلوكها التي سيتم عرضها في مساحة. على سبيل المثال، يمكن أن تتضمن رسالة البطاقة زرًا به رابط يفتح مربع حوار لجمع المعلومات من المستخدم.

  • في Google Chat، يمكن أن تحتوي المساحات على السياقات التالية:

    • تكون المساحة المُعنوَنة أو الجماعية مرئية لعدة مستخدمين.
    • تظهر الرسالة المباشرة للمستخدم في تلك المساحة فقط.

حالات الاستخدام

إنّ إضافة تطبيقات Chat إلى منصة محادثة، مثل Chat، تتيح للمستخدمين طرح الأسئلة وطرح الطلبات بدون تغيير السياق. في الخلفية، يمكن لتطبيق Chat الوصول إلى الأنظمة الأخرى، ويكون بمثابة وسيط لتلك الأنظمة.

وهذه القدرة على توفير الوصول إلى مجموعة واسعة من الموارد والأدوات مع الحفاظ على تجربة إدراكية موحّدة يمكن أن توفّر إطار عمل للعديد من أنواع التطبيقات، بما في ذلك ما يلي:

  • إدارة سير العمل
  • الإعداد والضبط
  • إنشاء الطلبات
  • بحث
  • جمع البيانات

تشمل بعض الأمثلة على الأشياء التي قد تطلب من أحد تطبيقات Chat تنفيذها من مساحة Chat ما يلي:

  • البحث عن المعلومات - يمكن لتطبيق Chat استرداد المعلومات استنادًا إلى طلبات البحث النصية المنظَّمة أو المجانية التي يُدخلها المستخدم.
  • تذاكر الملفات: يمكن لتطبيق Chat إنشاء تقارير الحوادث أو عناصر أخرى، باستخدام المعلومات التي يقدّمها المستخدم.
  • تنسيق الجهود: يمكن لتطبيق Chat تحسين طريقة تفاعل أعضاء الفريق مع بعضهم بعضًا، مثل توفير "ذاكرة الفريق" أو جدولة الموارد.

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

تتيح العديد من تطبيقات Chat للمستخدمين إرسال رسائل إلى تطبيق Chat والتفاعل معه مباشرةً. ويمكن لتطبيقات Chat التفاعلية تنفيذ أيّ مما يلي:

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

إنشاء تطبيقات Chat غير تفاعلية

يمكن أيضًا أن تكون تطبيقات Google Chat غير تفاعلية للمستخدمين حيث لا يمكن للمستخدمين التفاعل مباشرةً مع تطبيق Chat، ولكن تطبيق Chat يستدعي Google Chat API مباشرةً. على سبيل المثال، يمكنك إنشاء تطبيق Chat يرسل رسالة في مساحة، ولكن لا يمكن للمستخدمين الاستجابة لتطبيق Chat. ويكون هذا النوع من بنية تطبيق Chat مفيدًا في إجراءات مثل إعداد تقارير منبهات. لمزيد من المعلومات، راجِع نظرة عامة على Google Chat API.

إنشاء تطبيقات Chat مستندة إلى الأحداث

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

اختيار بنية تطبيق Chat

توفّر Chat API عددًا من الطرق التي يمكنك من خلالها دمج تطبيقاتك في مساحات Chat، ولكنها لا توفّر أو تشترط أي طريقة معيّنة لتنفيذ منطق تطبيق Chat. يمكنك إنشاء تطبيق Chat اعتمادًا على الأوامر أو استخدام أي نوع من خدمات معالجة اللغات والذكاء الاصطناعي (AI) أو الوحدات التي تريدها، ويمكنك إجراء ذلك على مجموعة متنوعة من الأنظمة الأساسية، بما في ذلك ما يلي:

  • AppSheet
  • برمجة تطبيقات Google
  • نشر/اشتراك
  • Google Cloud أو خادم HTTP داخل الشركة

لمزيد من المعلومات، راجِع مقالة اختيار بنية تطبيقات Chat.

وصول التطبيق إلى بيانات المستخدمين

عند استدعاء تطبيق Chat، يحتاج التطبيق إلى معرفة مَن يستدعي التطبيق وفي أي سياق وطريقة التعامل مع مقدّم الطلب. للوصول إلى البيانات بخلاف بيانات الهوية الأساسية هذه، يجب منح تطبيق Chat الوصول من خلال المصادقة.

  • بشكل تلقائي، يمكن لتطبيقات Chat قراءة الهوية الأساسية للمستخدمين الذين يستدعونهم أو المستخدمين الذين تتم الإشارة إليهم باستخدام @ في الرسالة نفسها التي تستدعي التطبيق. وتشمل هذه المعلومات الاسم المعروض للمستخدم ورقم تعريف المستخدم وعنوان البريد الإلكتروني والصورة الرمزية.

  • بالنسبة إلى تطبيقات Chat التي تعاين الروابط، يمكن لتطبيق Chat قراءة عناوين URL التي تمت إضافتها إلى الرسالة التي تتطابق مع أنماط عناوين URL التي تم ضبطها في تطبيق Chat.

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

هل تريد رؤية Google Chat API بشكل عملي؟
تقدّم قناة Google Workspace Developers فيديوهات حول النصائح وأحدث الميزات.