توضّح هذه الصفحة كيفية إنشاء تطبيق Chat باستخدام نشر/اشتراك: هذا النوع من بنية تطبيق Chat مفيدة إذا كانت مؤسستك تستخدم جدار حماية، ما قد يمنع Chat من إرسال الرسائل إلى تطبيق Chat، أو إذا يستخدم تطبيق Chat واجهة برمجة التطبيقات لفعاليات Google Workspace: ومع ذلك، هندسة معمارية لها القيود التالية بسبب حقيقة أن هذه يمكن لتطبيقات Chat إرسال الرسائل وتلقّيها فقط الرسائل غير المتزامنة:
- لا يمكن استخدام مربعات الحوار في الرسائل. بدلاً من ذلك، استخدم رسالة البطاقة.
- لا يمكن تعديل بطاقات فردية باستخدام رد متزامن. بدلاً من ذلك، حدِّث
الرسالة بأكملها من خلال استدعاء
patch
.
يوضح الرسم التخطيطي التالي بنية تطبيق Chat الذي تم إنشاؤه من خلال نشر/اشتراك:
في الرسم التخطيطي السابق، يتفاعل أحد المستخدمين مع نشر/اشتراك في ما يلي مصادر المعلومات في تطبيق Chat:
إرسال مستخدم رسالة في Chat إلى تطبيق Chat، سواءً في رسالة مباشرة أو في وقوع حدث في "مساحة Chat" أو حدث التي يشتمِل تطبيق Chat على نشاطها الاشتراك.
يرسل Chat الرسالة إلى موضوع النشر/الاشتراك.
هو خادم تطبيقات، سواء كان نظامًا سحابيًا أو نظامًا داخل الشركة يتضمن منطق تطبيق Chat، ويشترك في موضوع النشر/الاشتراك لتلقي الرسالة من خلال جدار الحماية.
اختياريًا، يمكن لتطبيق Chat استدعاء Chat API لنشر الرسائل بشكل غير متزامن أو تنفيذ إجراءات أخرى العمليات التجارية.
المتطلبات الأساسية
Java
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- مشروع على Google Cloud مع تفعيل الفوترة فيه للتحقّق من تفعيل الفوترة في مشروع حالي، راجع التحقق من حالة الفوترة لمشاريعك لإنشاء مشروع وإعداد الفوترة، يُرجى الاطّلاع على أنشِئ مشروعًا على Google Cloud.
- Java 11 أو إصدار أحدث
- أداة إدارة حزم Maven
Python
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- مشروع على Google Cloud مع تفعيل الفوترة فيه للتحقّق من تفعيل الفوترة في مشروع حالي، راجع التحقق من حالة الفوترة لمشاريعك لإنشاء مشروع وإعداد الفوترة، يُرجى الاطّلاع على أنشِئ مشروعًا على Google Cloud.
- Python 3.6 أو أعلى
- أداة إدارة حزم pip
Node.js
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- مشروع على Google Cloud مع تفعيل الفوترة فيه للتحقّق من تفعيل الفوترة في مشروع حالي، راجع التحقق من حالة الفوترة لمشاريعك لإنشاء مشروع وإعداد الفوترة، يُرجى الاطّلاع على أنشِئ مشروعًا على Google Cloud.
- الإصدار 14 من Node.js أو الإصدارات الأحدث
- npm أداة إدارة الحِزم
-
مشروع Node.js تم إعداده. لتهيئة مشروع جديد، قم بإنشاء
التبديل إلى مجلد جديد، ثم شغِّل الأمر التالي في واجهة سطر الأوامر:
npm init
إعداد البيئة
قبل استخدام Google APIs، يجب تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في Google Cloud Console، فعِّل Google Chat API وPub/Sub API.
إعداد نشر/اشتراك
إنشاء موضوع على خدمة Pub/Sub التي يمكن لـ Chat API إرسال الرسائل إليها ننصحك باستخدام موضوع واحد لكل تطبيق في Chat.
منح Chat الإذن للنشر على الموضوع من خلال تعيين دور النشر/الاشتراك في ما يلي: حساب الخدمة:
chat-api-push@system.gserviceaccount.com
إنشاء حساب خدمة في تطبيق Chat لمنح الأذونات من خلال نشر/اشتراك يمكنك إجراء محادثة وحفظ ملف المفتاح الخاص في دليل العمل.
إنشاء اشتراك Pull with Hint على الموضوع.
امنح دور المشترك في النشر/الاشتراك في الاشتراك. لحساب الخدمة الذي أنشأته سابقًا
كتابة النص
Java
في واجهة سطر الأوامر، قدِّم بيانات اعتماد حساب الخدمة:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
في سطر الأوامر، قدِّم رقم تعريف مشروع Google Cloud:
export PROJECT_ID=PROJECT_ID
في واجهة سطر الأوامر، أدخِل معرّف الاشتراك الخاص باشتراك النشر/الاشتراك الذي الذي قمتَ بإنشائه مسبقًا:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
في دليل العمل، أنشِئ ملفًا باسم "
pom.xml
".في ملف
pom.xml
، الصق الرمز التالي:في دليل العمل، أنشِئ بنية الدليل
src/main/java
.في دليل
src/main/java
، أنشِئ ملفًا باسمMain.java
.في
Main.java
، الصق الرمز التالي:
Python
في واجهة سطر الأوامر، قدِّم بيانات اعتماد حساب الخدمة:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
في سطر الأوامر، قدِّم رقم تعريف مشروع Google Cloud:
export PROJECT_ID=PROJECT_ID
في واجهة سطر الأوامر، أدخِل معرّف الاشتراك الخاص باشتراك النشر/الاشتراك الذي الذي قمتَ بإنشائه مسبقًا:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
في دليل العمل، أنشِئ ملفًا باسم "
requirements.txt
".في ملف
requirements.txt
، الصق الرمز التالي:في دليل العمل، أنشِئ ملفًا باسم "
app.py
".في
app.py
، الصق الرمز التالي:
Node.js
في واجهة سطر الأوامر، قدِّم بيانات اعتماد حساب الخدمة:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
في سطر الأوامر، قدِّم رقم تعريف مشروع Google Cloud:
export PROJECT_ID=PROJECT_ID
في واجهة سطر الأوامر، أدخِل معرّف الاشتراك الخاص باشتراك النشر/الاشتراك الذي الذي قمتَ بإنشائه مسبقًا:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
في دليل العمل، أنشِئ ملفًا باسم "
package.json
".في ملف
package.json
، الصق الرمز التالي:في دليل العمل، أنشِئ ملفًا باسم "
index.js
".في
index.js
، الصق الرمز التالي:
نشر التطبيق في Chat
في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > واجهات برمجة التطبيقات و خدمات > واجهات برمجة التطبيقات المفعّلة خدمات > Google Chat API > الإعداد.
اضبط تطبيق Chat للنشر على الإنترنت أو الاشتراك:
- في اسم التطبيق، أدخِل
Quickstart App
. - في عنوان URL للصورة الرمزية، أدخِل
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - في الوصف، أدخِل
Quickstart app
. - ضمن الوظائف، اختَر تلقّي الرسائل بين شخصين والانضمام إلى المساحات والمحادثات الجماعية.
- ضمن إعدادات الاتصال، اختَر Cloud Pub/Sub والصِق رمز باسم موضوع النشر/الاشتراك الذي أنشأته في السابق.
- ضمن مستوى الرؤية، اختَر إتاحة تطبيق Google Chat هذا لمستخدمين محدّدين ومجموعات محدّدة في نطاقك وأدخِل عنوان بريدك الإلكتروني.
- ضمن السجلات، اختَر تسجيل الأخطاء في التسجيل.
- في اسم التطبيق، أدخِل
انقر على حفظ.
أصبح التطبيق جاهزًا لتلقّي الرسائل والردّ عليها على Chat.
تشغيل النص البرمجي
في واجهة سطر الأوامر، انتقِل إلى دليل العمل وشغِّل النص البرمجي:
Java
mvn compile exec:java -Dexec.mainClass=Main
Python
python -m venv env
source env/bin/activate
pip install -r requirements.txt -U
python app.py
Node.js
npm install
npm start
عند تشغيل الرمز، يبدأ التطبيق في الاستماع إلى الرسائل المنشورة. في موضوع النشر/الاشتراك
اختبار تطبيق Chat
لاختبار تطبيق Chat، افتح مساحة رسائل مباشرة تحتوي على تطبيق Chat وإرسال رسالة:
افتح Google Chat باستخدام حساب Google Workspace الذي المقدّمة عندما أضفت نفسك كمختبِر موثوق به.
- انقر على رمز محادثة جديدة.
- في الحقل إضافة شخص واحد أو أكثر، اكتب اسم تطبيق Chat
اختَر تطبيقك في Chat من النتائج. عميل مباشر يتم فتح رسالة.
- في الرسالة المباشرة الجديدة مع التطبيق، اكتب
Hello
واضغط على.enter
لإضافة مختبِرين موثوق بهم ومعرفة المزيد من المعلومات حول اختبار الميزات التفاعلية، يُرجى الاطّلاع على اختبار الميزات التفاعلية تطبيقات Google Chat
تحديد المشاكل وحلّها
عند تثبيت تطبيق Google Chat أو تعرض card خطأً، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذَّرت معالجة طلبك". في بعض الأحيان، لا يمكن واجهة مستخدم Chat لا يعرض أي رسالة خطأ، ولكن يظهر تطبيق Chat أو ينتج عن بطاقة نتيجة غير متوقعة؛ على سبيل المثال، قد لا تظهر رسالة البطاقة موضع الإعلان.
على الرغم من أنه قد لا تظهر رسالة الخطأ في واجهة مستخدم Chat، تتوفر رسائل خطأ وصفية وبيانات السجل لمساعدتك في إصلاح الأخطاء عند تفعيل ميزة تسجيل الأخطاء لتطبيقات Chat للحصول على مساعدة في العرض، وتصحيح الأخطاء وإصلاح الأخطاء، فراجع تحديد مشاكل Google Chat وحلّها.
تَنظيم
لتجنب تكبد أي رسوم إلى حسابك في Google Cloud مقابل الموارد المستخدمة في هذا البرنامج التعليمي، نوصيك بحذف المشروع على السحابة الإلكترونية.
- في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. (يُرجى النقر.) قائمة الطعام > إدارة الهوية وإمكانية الوصول و المشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع ثم انقر على إيقاف التشغيل لحذفه. للمشروع.
مواضيع ذات صلة
لإضافة المزيد من الميزات إلى تطبيق Chat، يمكنك الاطّلاع على التالي: