توضّح هذه الصفحة كيفية إنشاء تطبيق HTTP في Chat. هناك طرق مختلفة لتنفيذ هذه البنية. في Google Cloud، يمكنك استخدام دوال Cloud و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 APIs، يجب تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في وحدة التحكّم في Google Cloud، فعِّل واجهة برمجة التطبيقات Google Chat وCloud Build API وCloud Functions API واجهة برمجة تطبيقات Cloud Pub/Sub وCloud Logging API وواجهة برمجة تطبيقات Artifact Registry وCloud Run API
إنشاء دالة Cloud ونشرها
إنشاء ونشر دالة سحابية تنشئ بطاقة Chat مع الاسم المعروض للمُرسِل والصورة الرمزية. عندما يتلقّى تطبيق Chat رسالة ويشغِّل الوظيفة بالبطاقة.
لإنشاء الوظيفة ونشرها لتطبيق Chat، يُرجى اتّباع الخطوات التالية: أكمل الخطوات التالية:
Node.js
في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة "وظائف السحابة الإلكترونية":
الانتقال إلى وظائف السحابة الإلكترونية
تأكَّد من أنّ مشروع تطبيق Chat: المحددة.
انقر على
إنشاء دالة.في صفحة "إنشاء دالة"، قم بإعداد الدالة الخاصة بك:
- في البيئة، اختَر الجيل الثاني.
- في اسم الدالة، أدخِل
QuickStartChatApp
. - في المنطقة، اختَر منطقة.
- ضمن "المصادقة"، اختَر طلب المصادقة.
- انقر على التالي.
في وقت التشغيل، اختَر أحدث إصدار من Node.js.
في رمز المصدر، اختَر المحرِّر المضمّن.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
avatarApp
.استبدل محتوى
index.js
بالرمز التالي:انقر على نشر.
Python
في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة "وظائف السحابة الإلكترونية":
الانتقال إلى وظائف السحابة الإلكترونية
تأكَّد من أنّ مشروع تطبيق Chat: المحددة.
انقر على
إنشاء دالة.في صفحة "إنشاء دالة"، قم بإعداد الدالة الخاصة بك:
- في البيئة، اختَر الجيل الثاني.
- في اسم الدالة، أدخِل
QuickStartChatApp
. - في المنطقة، اختَر منطقة.
- ضمن "المصادقة"، اختَر طلب المصادقة.
- انقر على التالي.
في وقت التشغيل، اختَر أحدث إصدار من Python.
في رمز المصدر، اختَر المحرِّر المضمّن.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
avatar_app
.استبدل محتوى
main.py
بالرمز التالي:انقر على نشر.
Java
في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة "وظائف السحابة الإلكترونية":
الانتقال إلى وظائف السحابة الإلكترونية
تأكَّد من أنّ مشروع تطبيق Chat: المحددة.
انقر على
إنشاء دالة.في صفحة "إنشاء دالة"، قم بإعداد الدالة الخاصة بك:
- في البيئة، اختَر الجيل الثاني.
- في اسم الدالة، أدخِل
QuickStartChatApp
. - في المنطقة، اختَر منطقة.
- ضمن "المصادقة"، اختَر طلب المصادقة.
- انقر على التالي.
في وقت التشغيل، اختَر أحدث إصدار من Java.
في رمز المصدر، اختَر المحرِّر المضمّن.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
App
.إعادة تسمية "
src/main/java/com/example/Example.java
" إلىsrc/main/java/App.java
استبدل محتوى
App.java
بالرمز التالي:استبدل محتوى
pom.xml
بالرمز التالي:انقر على نشر.
تفتح صفحة تفاصيل دوال السحابة، وتظهر الدالة مع مؤشرات التقدم: واحد للإنشاء وآخر للخدمة. عندما يكون كلاهما تختفي مؤشرات التقدم ويتم استبدالها بعلامة اختيار، بنشرها وجاهزيتها.
تفويض Google Chat لاستدعاء الوظيفة
للسماح لـ Google Chat باستدعاء الوظيفة، أضِف تطبيق Google Chat حساب خدمة يكون له دور Cloud Run Invoker.
في Google Cloud Console، انتقِل إلى صفحة "تشغيل السحابة الإلكترونية":
في قائمة خدمات تشغيل السحابة الإلكترونية، حدد مربع الاختيار بجوار مربع الأخرى. (لا تنقر على الدالة نفسها.)
انقر على الأذونات. ستظهَر لوحة الأذونات.
انقر على إضافة مدير.
في العناصر الرئيسية الجديدة، أدخِل
chat@system.gserviceaccount.com
.في اختيار دور، اختَر تشغيل في السحابة الإلكترونية > Cloud Run Invoker
انقر على حفظ.
نشر التطبيق على 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 إلى المربع إلى جانب تشغيل دالة السحابة.
- في جمهور المصادقة، اختر عنوان URL للتطبيق.
- ضمن مستوى الرؤية، اختَر إتاحة تطبيق Google Chat هذا لمستخدمين محدَّدين مجموعات في نطاقك وأدخِل عنوان بريدك الإلكتروني.
- ضمن السجلات، اختَر تسجيل الأخطاء في التسجيل.
- في اسم التطبيق، أدخِل
انقر على حفظ.
تطبيق Chat جاهز للاستلام والردّ على الرسائل على Chat.
اختبار تطبيق Chat
لاختبار تطبيق Chat، افتح مساحة رسائل مباشرة تحتوي على تطبيق Chat وإرسال رسالة:
افتح Google Chat باستخدام حساب Google Workspace الذي المقدمة عندما أضفت نفسك كمختبِر موثوق به.
- انقر على رمز محادثة جديدة.
- في الحقل إضافة شخص واحد أو أكثر، اكتب اسم تطبيق Chat
اختَر تطبيقك في Chat من النتائج. عميل مباشر يتم فتح رسالة.
- في الرسالة المباشرة الجديدة مع التطبيق، اكتب
Hello
واضغط على.enter
يحتوي ردّ تطبيق Chat على رسالة بطاقة تعرض اسم المرسل والصورة الرمزية، كما هو موضح في الصورة التالية:
لإضافة مختبِرين موثوق بهم ومعرفة المزيد من المعلومات حول اختبار الميزات التفاعلية، يُرجى الاطّلاع على اختبار الميزات التفاعلية تطبيقات Google Chat
تحديد المشاكل وحلّها
عند تثبيت تطبيق Google Chat أو تعرض card خطأً، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذَّرت معالجة طلبك". في بعض الأحيان، لا يمكن واجهة مستخدم Chat لا يعرض أي رسالة خطأ، ولكن يظهر تطبيق Chat أو ينتج عن بطاقة نتيجة غير متوقعة؛ على سبيل المثال، قد لا تظهر رسالة البطاقة موضع الإعلان.
على الرغم من أنه قد لا تظهر رسالة الخطأ في واجهة مستخدم Chat، تتوفر رسائل خطأ وصفية وبيانات السجل لمساعدتك في إصلاح الأخطاء عند تفعيل ميزة تسجيل الأخطاء لتطبيقات Chat للحصول على مساعدة في العرض، وتصحيح الأخطاء وإصلاح الأخطاء، فراجع تحديد مشاكل Google Chat وحلّها.
تَنظيم
لتجنب تكبد أي رسوم إلى حسابك في Google Cloud مقابل الموارد المستخدمة في هذا البرنامج التعليمي، نوصيك بحذف المشروع على السحابة الإلكترونية.
- في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. (يُرجى النقر.) قائمة الطعام > إدارة الهوية وإمكانية الوصول و المشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع ثم انقر على إيقاف التشغيل لحذفه. للمشروع.
مواضيع ذات صلة
لإضافة المزيد من الميزات إلى تطبيق Chat، يمكنك الاطّلاع على التالي: