تشرح هذه الصفحة كيفية إنشاء تطبيق HTTP في Chat. وهناك طرق مختلفة لتنفيذ هذه البنية. في Google Cloud، يمكنك استخدام Cloud Functions وCloud Run وApp Engine. في مرحلة البدء السريع هذه، ستكتب وتنشر وظيفة في السحابة الإلكترونية يستخدمها تطبيق Chat للردّ على رسالة المستخدم.
من خلال هذه البنية، يمكنك ضبط Chat ليتم دمجه مع Google Cloud أو خادم محلي باستخدام HTTP على النحو الموضّح في المخطّط البياني التالي:
في المخطّط السابق، تظهر المعلومات التالية لدى المستخدم الذي يتفاعل مع تطبيق HTTP Chat:
- يرسل المستخدم رسالة في Chat إلى تطبيق Chat، إما في رسالة مباشرة أو في مساحة Chat.
- يتم إرسال طلب HTTP إلى خادم ويب يكون إما على السحابة الإلكترونية أو نظام داخل الشركة يحتوي على منطق تطبيق Chat.
- يمكن أن يتكامل منطق التطبيق مع Chat اختياريًا مع خدمات Google Workspace (مثل "تقويم Google" و"جداول بيانات Google") أو خدمات Google الأخرى (مثل "خرائط Google" وYouTube وVertex AI) أو خدمات الويب الأخرى (مثل نظام إدارة المشاريع أو أداة إصدار التذاكر).
- يرسل خادم الويب استجابة HTTP مرة أخرى إلى خدمة تطبيق Chat في Chat.
- يتم تسليم الرد إلى المستخدم.
- اختياريًا، يمكن لتطبيق Chat استدعاء Chat API لنشر الرسائل بشكل غير متزامن أو تنفيذ عمليات أخرى.
وتمنحك هذه البنية المرونة لاستخدام المكتبات والمكوّنات الحالية المتوفّرة في نظامك لأنّه يمكن تصميم تطبيقات Chat هذه باستخدام لغات برمجة مختلفة.
الأهداف
- إعداد البيئة.
- إنشاء دالة Cloud ونشرها
- انشر التطبيق في Chat.
- اختبِر التطبيق.
المتطلّبات الأساسية
- حساب على Google Workspace يمكنه الوصول إلى Google Chat ووظائف Google Cloud.
- مشروع على Google Cloud:
- تأكَّد من تفعيل الفوترة لمشروعك على Google Cloud. تعرّف على كيفية التحقّق من حالة الفوترة لمشاريعك.
إعداد البيئة
قبل استخدام Google APIs، يجب تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في Google Cloud Console، فعِّل واجهة برمجة التطبيقات Google Chat وCloud Build API وCloud Functions API وCloud Pub/Sub API وCloud Logging API وواجهة برمجة التطبيقات Artifact Registry API وCloud Run API.
إنشاء دالة Cloud ونشرها
يمكنك إنشاء وظيفة السحابة الإلكترونية ونشرها التي تُنشئ بطاقة Chat تتضمّن الاسم المعروض والصورة الرمزية للمُرسِل. عندما يتلقى تطبيق Chat رسالة، يُشغِّل الوظيفة ويتجاوب مع البطاقة.
لإنشاء الوظيفة وتفعيلها في تطبيق Chat، يُرجى إكمال الخطوات التالية:
Node.js
في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة "وظائف السحابة الإلكترونية":
الانتقال إلى وظائف السحابة الإلكترونية
تأكَّد من اختيار مشروع تطبيق Chat.
انقر على
إنشاء دالة.في صفحة "إنشاء دالة"، قم بإعداد الدالة الخاصة بك:
- في البيئة، اختَر الجيل الثاني.
- في اسم الدالة، أدخِل
QuickStartChatApp
. - في المنطقة، اختَر منطقة.
- ضمن "المصادقة"، اختَر طلب المصادقة.
- انقر على التالي.
في وقت التشغيل، اختَر أحدث إصدار من Node.js.
في رمز المصدر، اختَر المحرِّر المضمّن.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
helloChat
.استبدل محتوى
index.js
بالرمز التالي:انقر على نشر.
Python
في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة "وظائف السحابة الإلكترونية":
الانتقال إلى وظائف السحابة الإلكترونية
تأكَّد من اختيار مشروع تطبيق Chat.
انقر على
إنشاء دالة.في صفحة "إنشاء دالة"، قم بإعداد الدالة الخاصة بك:
- في البيئة، اختَر الجيل الثاني.
- في اسم الدالة، أدخِل
QuickStartChatApp
. - في المنطقة، اختَر منطقة.
- ضمن "المصادقة"، اختَر طلب المصادقة.
- انقر على التالي.
في وقت التشغيل، اختَر أحدث إصدار من Python.
في رمز المصدر، اختَر المحرِّر المضمّن.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
hello_chat
.استبدل محتوى
main.py
بالرمز التالي:انقر على نشر.
Java
في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة "وظائف السحابة الإلكترونية":
الانتقال إلى وظائف السحابة الإلكترونية
تأكَّد من اختيار مشروع تطبيق Chat.
انقر على
إنشاء دالة.في صفحة "إنشاء دالة"، قم بإعداد الدالة الخاصة بك:
- في البيئة، اختَر الجيل الثاني.
- في اسم الدالة، أدخِل
QuickStartChatApp
. - في المنطقة، اختَر منطقة.
- ضمن "المصادقة"، اختَر طلب المصادقة.
- انقر على التالي.
في وقت التشغيل، اختَر أحدث إصدار من Java.
في رمز المصدر، اختَر المحرِّر المضمّن.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
HelloChat
.إعادة تسمية "
src/main/java/com/example/Example.java
" إلىsrc/main/java/HelloChat.java
استبدل محتوى
HelloChat.java
بالرمز التالي:استبدل محتوى
pom.xml
بالرمز التالي:انقر على نشر.
ستفتح صفحة تفاصيل "وظائف السحابة الإلكترونية"، وتظهر وظيفتك مع مؤشرَين للتقدّم: أحدهما للإصدار والآخر للخدمة. عندما يختفي كلا مؤشري التقدم ويتم استبدالهما بعلامة اختيار، تكون الدالة منشورة وجاهزة.
تفويض Google Chat لاستدعاء الوظيفة
من أجل تفويض Google Chat لاستدعاء الوظيفة، أضِف حساب خدمة Google Chat الذي لديه دور Cloud Run Invoker.
في Google Cloud Console، انتقِل إلى صفحة "تشغيل السحابة الإلكترونية":
في قائمة خدمات تشغيل السحابة الإلكترونية، ضَع علامة في مربّع الاختيار بجانب دالة الاستلام. (لا تنقر على الدالة نفسها.)
انقر على الأذونات. ستظهَر لوحة الأذونات.
انقر على إضافة مدير.
في العناصر الرئيسية الجديدة، أدخِل
chat@system.gserviceaccount.com
.في اختيار دور، اختَر تشغيل السحابة الإلكترونية > مُستدعي Cloud Run.
انقر على حفظ.
نشر التطبيق على Google Chat
بعد تفعيل ميزة Cloud Function، اتّبِع الخطوات التالية لتحويلها إلى تطبيق في Google Chat:
في وحدة تحكُّم Google Cloud، انقر على رمز القائمة > دوال السحابة الإلكترونية.
الانتقال إلى وظائف السحابة الإلكترونية
تأكَّد من اختيار المشروع الذي فعَّلت Cloud Functions فيه.
في قائمة الدوال، انقر على QuickStartChatApp.
انقر على علامة التبويب العوامل المشغِّلة.
ضمن HTTPS، انسخ عنوان URL.
ابحث عن Google Chat API وانقر على Google Chat API، ثم انقر على إدارة.
انقر على ضبط واضبط تطبيق Google Chat:
- في اسم التطبيق، أدخِل
Quickstart App
. - في عنوان URL للصورة الرمزية، أدخِل
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - في الوصف، أدخِل
Quickstart app
. - ضمن الوظائف، اختَر تلقّي الرسائل بين شخصين والانضمام إلى المساحات والمحادثات الجماعية.
- ضمن إعدادات الاتصال، اختَر عنوان URL للتطبيق والصِق عنوان URL لمشغّل دالة Cloud في المربّع.
- في جمهور المصادقة، اختر عنوان URL للتطبيق.
- ضمن مستوى الرؤية، اختَر إتاحة تطبيق Google Chat هذا لمستخدمين محدّدين ومجموعات محدّدة في نطاقك وأدخِل عنوان بريدك الإلكتروني.
- ضمن السجلات، اختَر تسجيل الأخطاء في التسجيل.
- في اسم التطبيق، أدخِل
انقر على حفظ.
تطبيق Chat جاهز لتلقي الرسائل في Chat والرد عليها
اختبار تطبيق Chat
لاختبار تطبيق Chat، افتح مساحة رسائل مباشرة باستخدام تطبيق Chat وأرسِل رسالة:
افتح Google Chat باستخدام حساب Google Workspace الذي قدّمته عند إضافة نفسك كمختبِر موثوق به.
- انقر على رمز محادثة جديدة.
- في الحقل إضافة مستخدم واحد أو أكثر، اكتب اسم تطبيق Chat.
اختَر تطبيقك في Chat من النتائج. ستظهر رسالة مباشرة.
- في الرسالة المباشرة الجديدة مع التطبيق، اكتب
Hello
واضغط علىenter
.
يتضمّن ردّ تطبيق Chat رسالة بطاقة تعرض اسم المُرسِل وصورته الرمزية، كما هو موضّح في الصورة التالية:
لإضافة مختبِرين موثوق بهم ومعرفة المزيد من المعلومات حول اختبار الميزات التفاعلية، يمكنك الاطّلاع على اختبار الميزات التفاعلية لتطبيقات Google Chat.
تحديد المشاكل وحلّها
عندما يعرض تطبيق أو بطاقة Google Chat رسالة خطأ، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذَّرت معالجة طلبك". في بعض الأحيان، لا تعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن يعرض تطبيق Chat أو بطاقة بياناته نتيجة غير متوقعة، على سبيل المثال، قد لا تظهر رسالة بطاقة.
على الرغم من أنّ رسالة الخطأ قد لا تظهر في واجهة مستخدم Chat، تتوفّر رسائل الخطأ الوصفية وبيانات السجلّ لمساعدتك في إصلاح الأخطاء عند تفعيل ميزة تسجيل الأخطاء في تطبيقات Chat. للحصول على مساعدة بشأن الاطّلاع على الأخطاء وتصحيحها وتصحيحها، راجِع تحديد المشاكل في Google Chat وحلّها.
تَنظيم
لتجنُّب تحمُّل أي رسوم من حسابك على Google Cloud مقابل الموارد المستخدَمة في هذا الدليل التوجيهي، ننصحك بحذف المشروع على Google Cloud.
- في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف التشغيل لحذف المشروع.
مواضيع ذات صلة
لإضافة المزيد من الميزات إلى تطبيق Chat، يمكنك الاطّلاع على ما يلي: