يوضّح هذا البرنامج التعليمي كيفية إنشاء تطبيق Google Chat يساعد مستخدمي Google Chat في إدارة جهات الاتصال الشخصية وجهات الاتصال الخاصة بالعمل. لجمع المعلومات، يطلب تطبيق Chat من المستخدمين ملء نموذج اتصال في رسائل البطاقات ومربّعات الحوار.
إليك طريقة عمل تطبيق Chat:
-
الشكل 1. يستجيب تطبيق Chat للأمر الذي يبدأ بشرطة مائلة /about
برسالة نصية وزر يفتح نموذج جهة الاتصال. -
الشكل 2. يفتح تطبيق Chat مربّع حوار يمكن للمستخدمين إدخال معلومات حول جهة اتصال فيه. -
الشكل 3. يعرض تطبيق Chat مربّع حوار تأكيد ليتمكّن المستخدمون من مراجعة المعلومات والتأكيد عليها قبل إرسالها. -
الشكل 4. بعد أن يرسل المستخدم النموذج، يرسل تطبيق Chat رسالة نصية خاصة لتأكيد عملية الإرسال. -
الشكل 5. يطلب تطبيق Chat أيضًا من المستخدمين إضافة جهة اتصال من بطاقة في رسالة.
المتطلبات الأساسية
- حساب Google Workspace من إصدار Business أو Enterprise مع إذن الوصول إلى Google Chat
الأهداف
- تصميم وإنشاء واجهات المستخدم
كعناصر
card
وعرض واجهات المستخدم في الرسائل ومربّعات الحوار - تلقّي ومعالجة المعلومات التي يرسلها المستخدمون باستخدام أدوات إدخال النماذج
- الرد على الطلبات برسائل تتضمّن نصوصًا وبطاقات وأدوات ملحقة
الهندسة المعمارية
تم إنشاء تطبيق Chat باستخدام برمجة تطبيقات Google ويستخدم أحداث التفاعل لمعالجة طلبات مستخدمي Chat والردّ عليها.
يوضّح ما يلي كيف يمكن للمستخدم التفاعل عادةً مع تطبيق Chat:
يفتح مستخدم رسالة مباشرة باستخدام تطبيق Chat، أو يضيف تطبيق Chat إلى مساحة حالية.
يطلب تطبيق Chat من المستخدم إضافة جهة اتصال من خلال إنشاء نموذج جهة اتصال وعرضه ككائن
card
. لعرض نموذج التواصل، يستجيب تطبيق Chat للمستخدمين بالطرق التالية:- يردّ على الإشارات والرسائل المباشرة برسالة بطاقة تحتوي على نموذج جهة الاتصال.
- يستجيب للأمر
/addContact
الذي يبدأ بشرطة مائلة من خلال فتح مربّع حوار يتضمّن نموذج جهة الاتصال. - يستجيب للأمر الشرطي
/about
برسالة نصية تتضمّن زر إضافة جهة اتصال يمكن للمستخدمين النقر عليه لفتح مربّع حوار يتضمّن نموذج جهة الاتصال.
عندما يظهر نموذج التواصل، يُدخل المستخدم معلومات الاتصال في الحقول وعناصر واجهة المستخدم التالية:
- الاسم الأول واسم العائلة: أداة
textInput
تقبل السلاسل. - تاريخ الميلاد: أداة
dateTimePicker
تقبل التواريخ فقط. - نوع جهة الاتصال: عنصر واجهة مستخدم
selectionInput
لأزرار الاختيار يتيح للمستخدمين اختيار قيمة سلسلة واحدة وإرسالها (إماPersonal
أوWork
). - زر المراجعة والإرسال: هو
buttonList
مصفوفة تتضمّن عنصر واجهة المستخدمbutton
الذي ينقر عليه المستخدم لإرسال القيم التي أدخلها.
- الاسم الأول واسم العائلة: أداة
يتعامل تطبيق Google Chat مع حدث تفاعل
CARD_CLICKED
لمعالجة القيم التي يدخلها المستخدم، ويعرض القيم في بطاقة تأكيد.يراجع المستخدم بطاقة التأكيد وينقر على الزر إرسال لإكمال معلومات الاتصال.
يرسل تطبيق Google Chat رسالة نصية خاصة تؤكّد عملية الإرسال.
إعداد البيئة
يوضّح هذا القسم كيفية إنشاء مشروع في Google Cloud وإعداده لتطبيق Chat.
إنشاء مشروع على Google Cloud
Google Cloud Console
- في Google Cloud Console، انتقِل إلى "القائمة" > المشرف وإدارة الهوية وإمكانية الوصول > إنشاء مشروع.
-
في حقل اسم المشروع، أدخِل اسمًا وصفيًا لمشروعك.
اختياري: لتعديل رقم تعريف المشروع، انقر على تعديل. لا يمكن تغيير رقم تعريف المشروع بعد إنشائه، لذا اختَر رقم تعريف يلبي احتياجاتك طوال مدة المشروع.
- في حقل الموقع الجغرافي، انقر على تصفّح لعرض المواقع الجغرافية المحتملة لمشروعك. بعد ذلك، انقر على اختيار.
- انقر على إنشاء. تنتقل وحدة تحكّم Google Cloud إلى صفحة "لوحة البيانات" ويتم إنشاء مشروعك في غضون بضع دقائق.
gcloud CLI
في إحدى بيئات التطوير التالية، يمكنك الوصول إلى واجهة سطر الأوامر (CLI) في Google Cloud (gcloud
):
-
Cloud Shell: لتفعيل Cloud Shell واستخدام وحدة طرفية على الإنترنت مع إعداد gcloud CLI مسبقًا
تفعيل Cloud Shell -
Local Shell: لاستخدام بيئة تطوير محلية، عليك تثبيت وإعداد gcloud CLI.
لإنشاء مشروع على Google Cloud، استخدِم الأمرgcloud projects create
: استبدِل PROJECT_ID بضبط رقم تعريف المشروع الذي تريد إنشاءه.gcloud projects create PROJECT_ID
إعداد المصادقة والتفويض
تتطلّب تطبيقات Google Chat إعداد شاشة موافقة OAuth ليتمكّن المستخدمون من منح تطبيقك الإذن في تطبيقات Google Workspace، بما في ذلك Google Chat.
في هذا البرنامج التعليمي، ستنشئ تطبيق Chat مخصّصًا للاختبار والاستخدام الداخلي فقط، لذا لا بأس من استخدام معلومات العنصر النائب لشاشة الموافقة. قبل نشر تطبيق Chat، عليك استبدال أي معلومات نائبة بمعلومات حقيقية.
في وحدة تحكّم Google Cloud، انتقِل إلى "القائمة" > > العلامة التجارية.
إذا سبق لك إعداد ، يمكنك إعداد إعدادات "شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth" التالية في العلامة التجارية والجمهور والوصول إلى البيانات. إذا ظهرت لك الرسالة لم يتم الإعداد بعد، انقر على البدء:
- ضمن معلومات التطبيق، في اسم التطبيق، اكتب
Contact Manager
. - في البريد الإلكتروني المخصّص لدعم المستخدمين، اختَر عنوان بريدك الإلكتروني أو مجموعة Google المناسبة.
- انقر على التالي.
- ضمن الجمهور، اختَر داخلي. إذا لم تتمكّن من اختيار داخلي، اختَر خارجي.
- انقر على التالي.
- ضمن معلومات الاتصال، أدخِل عنوان بريد إلكتروني يمكنك تلقّي إشعارات فيه بشأن أي تغييرات تطرأ على مشروعك.
- انقر على التالي.
- ضمن إنهاء، راجِع سياسة بيانات المستخدمين في خدمات Google API، ثم انقر على أوافق على سياسة بيانات المستخدمين في خدمات Google API إذا كنت موافقًا عليها.
- انقر على متابعة.
- انقر على إنشاء.
- إذا اخترت خارجي لنوع المستخدم، أضِف مستخدمين تجريبيين:
- انقر على الجمهور.
- ضمن المستخدمون التجريبيون، انقر على إضافة مستخدمين.
- أدخِل عنوان بريدك الإلكتروني وأي مستخدمين آخرين معتمَدين للاختبار، ثم انقر على حفظ.
- ضمن معلومات التطبيق، في اسم التطبيق، اكتب
إنشاء تطبيق Chat ونشره
في القسم التالي، ستنسخ مشروعًا كاملاً من مشاريع Apps Script وتعدّله، وهو يحتوي على جميع رموز التطبيق المطلوبة لتطبيق Chat، لذا لن تحتاج إلى نسخ كل ملف ولصقه.
يمكنك اختياريًا الاطّلاع على المشروع بأكمله على GitHub.
في ما يلي نظرة عامة على كل ملف:
main.gs
يتعامل مع جميع منطق التطبيق، بما في ذلك أحداث التفاعل المتعلقة بموعد إرسال المستخدمين رسائل إلى تطبيق Chat أو النقر على أزرار من رسالة في تطبيق Chat أو فتح مربعات الحوار وإغلاقها.
عرض رمز
main.gs
contactForm.gs
يحتوي على التطبيقات المصغّرة التي تتلقّى بيانات النموذج من المستخدمين. يتم عرض عناصر واجهة المستخدم الخاصة بإدخال النماذج هذه في بطاقات تظهر في الرسائل ومربّعات الحوار.
عرض رمز
contactForm.gs
appsscript.json
بيان Apps Script الذي يحدّد مشروع Apps Script ويضبطه لتطبيق Chat
عرض رمز
appsscript.json
العثور على رقم تعريف مشروعك على السحابة الإلكترونية
في Google Cloud Console، انتقِل إلى مشروعك على السحابة الإلكترونية.
انقر على "الإعدادات والأدوات" > إعدادات المشروع.
دوِّن القيم في حقلَي رقم المشروع ورقم تعريف المشروع. يمكنك استخدامها في الأقسام التالية.
إنشاء مشروع "برمجة تطبيقات Google"
لإنشاء مشروع في "برمجة تطبيقات Google" وربطه بمشروعك على Cloud، اتّبِع الخطوات التالية:
- انقر على الزر التالي لفتح مشروع إدارة جهات الاتصال في Google Chat على Apps Script.
فتح المشروع - انقر على نظرة عامة.
- في صفحة النظرة العامة، انقر على
إنشاء نسخة.
أدخِل اسمًا لنسخة مشروع "برمجة التطبيقات Google":
انقر على نسخة من إدارة جهات الاتصال في Google Chat.
في عنوان المشروع، اكتب
Contact Manager - Google Chat app
انقر على إعادة تسمية.
ضبط مشروع Cloud لمشروع "برمجة التطبيقات"
- في مشروع "برمجة تطبيقات Google"، انقر على
إعدادات المشروع.
- ضمن مشروع Google Cloud Platform (GCP)، انقر على تغيير المشروع.
- في رقم مشروع Google Cloud Platform، الصِق رقم مشروع Cloud.
- انقر على تحديد المشروع. تم الآن ربط مشروع Cloud بمشروع "برمجة التطبيقات".
إنشاء عملية نشر في "برمجة تطبيقات Google"
بعد إعداد جميع الرموز البرمجية، يمكنك نشر مشروع Apps Script. يمكنك استخدام معرّف النشر عند إعداد تطبيق Chat في Google Cloud.
في Apps Script، افتح مشروع تطبيق Chat.
انقر على نشر > عملية نشر جديدة.
إذا لم يكن خيار إضافة محدّدًا من قبل، انقر على أنواع النشر
بجانب اختيار النوع، ثم اختَر إضافة.
في الوصف، أدخِل وصفًا لهذا الإصدار، مثل
Test of Contact Manager
.انقر على نشر. تُبلغ "برمجة التطبيقات" عن عملية النشر الناجحة وتوفّر رقم تعريف عملية النشر.
انقر على
نسخ لنسخ رقم تعريف عملية النشر، ثم انقر على تم.
ضبط تطبيق Chat في Google Cloud Console
يوضّح هذا القسم كيفية ضبط Google Chat API في وحدة تحكّم Google Cloud باستخدام معلومات عن تطبيق Chat، بما في ذلك معرّف عملية النشر التي أنشأتها للتو من مشروع Apps Script.
في Google Cloud Console، انقر على القائمة > المزيد من المنتجات > Google Workspace > مكتبة المنتجات > Google Chat API > إدارة > الإعدادات.
في حقل اسم التطبيق، اكتب
Contact Manager
.في عنوان URL للأفاتار، اكتب
https://developers.google.com/chat/images/contact-icon.png
.في حقل الوصف، اكتب
Manage your personal and business contacts
.انقر على مفتاح التبديل تفعيل الميزات التفاعلية لتفعيل هذا الإعداد.
ضمن الوظائف، اختَر الانضمام إلى المساحات والمحادثات الجماعية.
ضمن إعدادات الاتصال، اختَر Apps Script.
في معرّف النشر، الصِق معرّف نشر "برمجة تطبيقات Google" الذي نسخته في القسم السابق عند إنشاء عملية نشر "برمجة تطبيقات Google".
ضمن الأوامر، اضبط الأوامر التي تبدأ بشرطة مائلة
/about
و/addContact
:- انقر على إضافة أمر يبدأ بشرطة مائلة لإعداد الأمر الأول.
- في حقل الاسم، اكتب
About
. - في معرّف الأمر، اكتب
1
. - في حقل الوصف، اكتب
Learn how to use this Chat app to manage your contacts
. - ضمن نوع الأمر، اختَر
Slash command
. - في اسم الأمر الذي يبدأ بشرطة مائلة، اكتب
/about
. - انقر على يفتح مربّع حوار.
- انقر على تم.
- انقر على إضافة أمر لإعداد أمر آخر يبدأ بشرطة مائلة.
- في حقل الاسم، اكتب
Add a contact
. - في معرّف الأمر، اكتب
2
. - في حقل الوصف، اكتب
Submit information about a contact
. - ضمن نوع الأمر، اختَر
Slash command
. - في اسم الأمر الذي يبدأ بشرطة مائلة، اكتب
/addContact
. - انقر على يفتح مربّع حوار.
- انقر على تم.
ضمن إذن الوصول، ضَع علامة في مربّع الاختيار إتاحة تطبيق Chat هذا لمستخدمين ومجموعات محدّدين في YOUR DOMAIN وأدخِل عنوان بريدك الإلكتروني.
ضمن السجلات، اختَر تسجيل الأخطاء في خدمة تسجيل البيانات.
انقر على حفظ. ستظهر رسالة "تم حفظ الإعدادات".
تطبيق Chat جاهز للتثبيت والاختبار في Chat.
اختبار تطبيق Chat
لاختبار تطبيق Chat، افتح مساحة رسالة مباشرة باستخدام تطبيق Chat وأرسِل رسالة:
افتح Google Chat باستخدام حساب Google Workspace الذي قدّمته عند إضافة نفسك كمختبِر موثوق به.
- انقر على محادثة جديدة.
- في حقل إضافة مستخدم واحد أو أكثر، اكتب اسم تطبيق Chat.
اختَر تطبيق Chat من النتائج. سيتم فتح رسالة مباشرة.
في الرسالة المباشرة الجديدة مع تطبيق Chat، اكتب
/addContact
واضغط على Enter.في مربّع الحوار الذي يظهر، أدخِل معلومات الاتصال:
- في حقل النص الاسم الأول واسم العائلة، أدخِل اسمًا.
- في أداة اختيار التاريخ ضمن تاريخ الميلاد، اختَر تاريخًا.
- ضمن نوع جهة الاتصال، انقر على زر الاختيار العمل أو شخصي.
انقر على المراجعة والإرسال.
في مربّع حوار التأكيد، راجِع المعلومات التي أرسلتها وانقر على إرسال. سيرد تطبيق Chat برسالة نصية تقول
✅ CONTACT NAME has been added to your contacts.
.يمكنك أيضًا اختياريًا اختبار نموذج الاتصال وإرساله بالطرق التالية:
- استخدِم الأمر
/about
الذي يبدأ بشرطة مائلة. يرد تطبيق المحادثة برسالة نصية وزر في أداة ملحقة مكتوب عليهAdd a contact
. يمكنك النقر على الزر لفتح مربّع حوار يتضمّن نموذج معلومات الاتصال. - أرسِل رسالة مباشرة إلى تطبيق Chat بدون استخدام أمر يبدأ بشرطة مائلة، مثل
Hello
. سيردّ تطبيق Chat بنص وبطاقة تحتوي على نموذج الاتصال.
- استخدِم الأمر
تَنظيم
لتجنُّب تحمّل رسوم في حسابك على Google Cloud مقابل الموارد المستخدَمة في هذا البرنامج التعليمي، ننصحك بحذف مشروع Cloud.
- في Google Cloud Console، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.
مواضيع ذات صلة
- الردّ على الأوامر
- جمع معلومات من مستخدمي Google Chat ومعالجتها
- فتح مربّعات الحوار التفاعلية
- استكشاف نماذج أخرى من تطبيقات Google Chat