توضّح هذه الصفحة كيفية إنشاء تطبيق HTTP Chat. تتوفّر طرق مختلفة لتنفيذ هذه البنية. على Google Cloud، يمكنك استخدام Cloud Functions وCloud Run وApp Engine. في مرحلة البدء السريع هذه، يمكنك كتابة دالة Cloud ونشرها للرد على رسالة المستخدم.
باستخدام هذه البنية، يمكنك ضبط 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 Workspace تسمح باستدعاءات وظائف Google Cloud التي لم تتم مصادقتها.
- مشروع على Google Cloud:
- تأكَّد من تفعيل الفوترة لمشروعك على Google Cloud. تعرَّف على كيفية التحقّق من حالة الفوترة لمشاريعك.
إعداد البيئة
قبل استخدام Google APIs، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في Google Cloud Console، فعِّل واجهة برمجة التطبيقات Google Chat API وCloud Build API وCloud Functions API وCloud Pub/Sub API وCloud Logging API وArtifact Registry API وواجهة برمجة التطبيقات Cloud Run.
إنشاء دالة Cloud ونشرها
يمكنك إنشاء واستخدام دالة Cloud لإنشاء بطاقة Chat تضم الاسم المعروض للمُرسِل والصورة الرمزية. عندما يتلقّى تطبيق Chat رسالة، يشغّل الوظيفة ويتجاوب مع البطاقة.
لإنشاء الوظيفة في تطبيق Chat ونشرها، يُرجى إكمال الخطوات التالية:
Node.js
في Google Cloud Console، انتقِل إلى صفحة Cloud Functions:
تأكَّد من أنّه تم اختيار مشروع تطبيق Chat الخاص بك.
انقر على
إنشاء دالة.في صفحة "إنشاء دالة"، قم بإعداد الدالة:
- في البيئة، اختَر الجيل الثاني.
- في اسم الدالة، أدخِل
QuickStartChatApp
. - في المنطقة، اختَر منطقة.
- ضمن "المصادقة"، اختَر السماح بعمليات الاستدعاء التي لم تتم مصادقتها.
- انقر على التالي.
في وقت التشغيل، اختَر Node.js 20.
في رمز المصدر، اختَر المحرّر المضمّن.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
helloChat
.استبدِل محتوى
index.js
بالرمز التالي:انقر على نشر.
Python
في Google Cloud Console، انتقِل إلى صفحة Cloud Functions:
تأكَّد من أنّه تم اختيار مشروع تطبيق Chat الخاص بك.
انقر على
إنشاء دالة.في صفحة "إنشاء دالة"، قم بإعداد الدالة:
- في اسم الدالة، أدخِل
QuickStartChatApp
. - في نوع المشغِّل، اختَر HTTP.
- ضمن "المصادقة"، اختَر السماح بعمليات الاستدعاء التي لم تتم مصادقتها.
- انقر على حفظ.
- انقر على التالي.
- في اسم الدالة، أدخِل
في وقت التشغيل، اختر Python 3.10.
في رمز المصدر، اختَر المحرّر المضمّن.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
hello_chat
.استبدِل محتوى
main.py
بالرمز التالي:انقر على نشر.
Java
في Google Cloud Console، انتقِل إلى صفحة Cloud Functions:
تأكَّد من أنّه تم اختيار مشروع تطبيق Chat الخاص بك.
انقر على
إنشاء دالة.في صفحة "إنشاء دالة"، قم بإعداد الدالة:
- في اسم الدالة، أدخِل
QuickStartChatApp
. - في نوع المشغِّل، اختَر HTTP.
- ضمن "المصادقة"، اختَر السماح بعمليات الاستدعاء التي لم تتم مصادقتها.
- انقر على حفظ.
- انقر على التالي.
- في اسم الدالة، أدخِل
في وقت التشغيل، اختر Java 11.
في رمز المصدر، اختَر المحرّر المضمّن.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
HelloChat
.إعادة تسمية
src/main/java/com/example/Example.java
إلىsrc/main/java/HelloChat.java
.استبدِل محتوى
HelloChat.java
بالرمز التالي:استبدِل محتوى
pom.xml
بالرمز التالي:انقر على نشر.
ستفتح صفحة تفاصيل "دوال السحابة"، وستظهر دالّتك مع مؤشرَي تقدّم: أحدهما للإصدار والآخر للخدمة. عندما يختفي كل من مؤشري التقدم ويتم استبدالهما بعلامة اختيار، يتم نشر الدالة وتكون جاهزة.
نشر التطبيق على Google Chat
بعد نشر دالة السحابة الإلكترونية، اتّبِع الخطوات التالية لتحويلها إلى تطبيق Google Chat:
في Google Cloud Console، انقر على رمز القائمة > دوال Cloud.
احرص على اختيار المشروع الذي فعّلت دوال السحابة له.
في قائمة الدوال، انقر على 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 لمشغِّل دالة السحابة في المربّع.
- ضمن إذن الوصول، اختَر إتاحة تطبيق 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 Console، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
- في مربّع الحوار، اكتب معرّف المشروع، ثم انقر على إيقاف التشغيل لحذف المشروع.
مواضيع ذات صلة
لإضافة المزيد من الميزات إلى تطبيق Chat، يمكنك الاطّلاع على ما يلي: