يشرح هذا الدليل التوجيهي كيفية إنشاء تطبيق Google Chat يساعد في يدير مستخدمو Google Chat جهات الاتصال الشخصية وجهات الاتصال الخاصة بالنشاط التجاري. لجمع المعلومات، يطلب تطبيق Chat من المستخدمين إكمال نموذج تواصل في رسائل البطاقات وملفات الحوار.
إليك بعض الأمثلة على استخدام تطبيق Chat:
-
الشكل 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
أداة تقبل التواريخ فقط. - نوع جهة الاتصال: a
selectionInput
تطبيق مصغّر لأزرار اختيار تتيح للمستخدمين اختيار سلسلة واحدة وإرسالها القيمة (إماPersonal
أوWork
). - زر المراجعة والإرسال:
buttonList
مصفوفة بها تطبيق مصغّرbutton
ينقر عليه المستخدم لإرسال القيم البيانات التي يضيفونها.
- الاسم الأول واسم العائلة:
يعالج تطبيق Google Chat حدث تفاعل
CARD_CLICKED
لمعالجة القيم التي يُدخلها المستخدم، ويعرض القيم في بطاقة تأكيد.يراجع المستخدم بطاقة التأكيد وينقر على الزر إرسال لإنهاء معلومات الاتصال.
يرسل تطبيق Google Chat رسالة نصية خاصة لتأكيد الإرسال.
تحضير البيئة
يعرض هذا القسم كيفية إنشاء مشروع على Google Cloud وإعداده من أجل تطبيق Chat
إنشاء مشروع على Google Cloud
وحدة التحكّم في Google Cloud
- في وحدة التحكّم في Google Cloud، انتقِل إلى القائمة > إدارة الهوية وإمكانية الوصول و المشرف > إنشاء مشروع. .
-
في حقل اسم المشروع، أدخِل اسمًا وصفيًا لمشروعك.
اختياري: لتعديل رقم تعريف المشروع، انقر على تعديل. لا يمكن تغيير رقم تعريف المشروع. بعد إنشاء المشروع، لذا اختر رقم تعريف يلبي احتياجاتك طوال مشروعك.
- في حقل الموقع الجغرافي، انقر على تصفّح لعرض المواقع الجغرافية المحتمَلة. مشروعك. بعد ذلك، انقر على اختيار.
- انقر على إنشاء. تنتقل وحدة تحكّم Google Cloud إلى صفحة "لوحة البيانات" ويتم إنشاء مشروعك في غضون بضع دقائق.
gcloud CLI
في إحدى بيئات التطوير التالية، يمكنك الوصول إلى Google Cloud
واجهة سطر الأوامر (gcloud
):
-
Cloud Shell: لاستخدام وحدة طرفية على الإنترنت مع gcloud CLI
سبق أن تم إعداده، يُرجى تفعيل Cloud Shell.
تفعيل Cloud Shell -
Local Shell: لاستخدام بيئة تطوير محلية،
تثبيت
الإعداد
واجهة سطر الأوامر gcloud.
لإنشاء مشروع على السحابة الإلكترونية، استخدِم الأمر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.
ضمن معلومات الاتصال بالمطوِّر، أدخِل عنوان بريدك الإلكتروني.
انقر على حفظ ومتابعة.
في صفحة النطاقات، انقر على حفظ ومتابعة. ( لا يتطلّب تطبيق Chat أي نطاقات OAuth).
راجِع الملخّص، ثم انقر على الرجوع إلى لوحة البيانات.
إنشاء تطبيق Chat ونشره
في القسم التالي، ستنسخ وتُعدِّل مشروعًا كاملاً من "برمجة تطبيقات Google" يحتوي على كل رمز التطبيق المطلوب لتطبيق Chat، لذا لن يكون عليك نسخ كل ملف ولصقه.
يمكنك اختياريًا عرض المشروع بالكامل على GitHub.
في ما يلي نظرة عامة على كل ملف:
main.gs
معالجة جميع منطق التطبيق، بما في ذلك أحداث التفاعل حول وقت إرسال المستخدمين الرسائل إلى تطبيق Chat، انقر على الأزرار من رسالة تطبيق في Chat أو فتح مربّعات الحوار وإغلاقها
عرض رمز
main.gs
contactForm.gs
يحتوي على الأدوات التي تتلقى بيانات النموذج من المستخدمين. يتم عرض هذه التطبيقات المصغّرة لعناصر إدخال النموذج في البطاقات التي تظهر في الرسائل ومربّعات الحوار.
عرض رمز
contactForm.gs
appsscript.json
بيان Apps Script الذي يحدِّد مشروع Apps Script ويضبطه لتطبيق Chat
عرض رمز
appsscript.json
البحث عن رقم مشروعك على Google Cloud ورقم تعريفه
في وحدة التحكّم في Google Cloud، انتقِل إلى مشروعك على Google Cloud.
انقر على "الإعدادات والأدوات المساعدة" > إعدادات المشروع.
دوِّن القيم في حقلَي رقم المشروع ورقم تعريف المشروع. ويمكنك استخدامها في الأقسام التالية.
إنشاء مشروع "برمجة تطبيقات Google"
لإنشاء مشروع على Apps Script وربطه بمشروعك على Cloud:
- انقر على الزر التالي لفتح مشروع إدارة جهات الاتصال في Google Chat "برمجة تطبيقات Google".
فتح المشروع - انقر على رمز نظرة عامة.
- في صفحة النظرة العامة، انقر على إنشاء نسخة.
تسمية نسختك من مشروع برمجة التطبيقات:
انقر على نسخة من "إدارة جهات الاتصال" في Google Chat.
في عنوان المشروع، اكتب
Contact Manager - Google Chat app
انقر على إعادة تسمية.
ضبط مشروع Cloud لمشروع "برمجة التطبيقات"
- في مشروعك على Apps Script، انقر على إعدادات المشروع.
- ضمن مشروع Google Cloud Platform (GCP)، انقر على تغيير المشروع.
- في رقم مشروع Google Cloud Platform، الصِق رقم مشروع مشروعك على Google Cloud.
- انقر على ضبط المشروع. تم ربط مشروع Cloud بمشروع Apps Script .
إنشاء عملية نشر في Apps Script
الآن وبعد أن أصبحت جميع الرموز في مكانها الصحيح، انشر النص البرمجي لـ Apps مشروعك. يمكنك استخدام معرّف النشر عند ضبط تطبيق Chat في Google Cloud.
في "برمجة تطبيقات Google"، افتح Chat مشروعك.
انقر على نشر > نشر جديد.
إذا لم تكن الإضافة محدّدة مسبقًا، بجانب اختَر النوع، وانقر على أنواع النشر واختَر إضافة.
في الوصف، أدخِل وصفًا لهذا الإصدار، مثل
Test of Contact Manager
انقر على نشر. تم بنجاح إعداد تقارير "برمجة تطبيقات Google" النشر ويوفر معرّف النشر.
انقر على
نسخ لنسخ رقم تعريف عملية النشر، ثم انقر على تم.
ضبط تطبيق Chat في وحدة تحكّم Google Cloud
يعرض هذا القسم كيفية ضبط Google Chat API في وحدة تحكّم Google Cloud. بمعلومات عن تطبيق Chat، بما في ذلك رقم تعريف عملية النشر التي أنشأتها للتو من "برمجة تطبيقات Google" مشروعك.
في وحدة تحكُّم Google Cloud، انقر على القائمة > مزيد من المنتجات > 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.
في رقم تعريف النشر، الصِق رقم تعريف نشر برمجة التطبيقات الذي نسخته في القسم السابق عند إنشاء نشر برمجة التطبيقات.
ضمن أوامر الشرطة المائلة، يمكنك إعداد الأوامر التي تبدأ بشرطة مائلة
/about
/addContact
:- انقر على إضافة أمر يبدأ بشرطة مائلة لإعداد أول أمر يبدأ بشرطة مائلة.
- في حقل الاسم، اكتب
/about
. - في رقم تعريف الطلب، اكتب
1
. - في الوصف، اكتب
Learn how to use this Chat app to manage your contacts
- انقر على فتح مربّع حوار.
- انقر على تم.
- انقر على إضافة أمر شرطة مائلة لإعداد أمر شرطة مائلة آخر.
- في Name (الاسم)، اكتب
/addContact
- في رقم تعريف الطلب، اكتب
2
. - في الوصف، اكتب
Submit information about a contact
- انقر على فتح مربّع حوار.
- انقر على تم.
ضمن مستوى الوصول، ضَع علامة في مربّع الاختيار إتاحة تطبيق 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
الذي يتضمّن الشرطة المائلة. يردّ تطبيق Chat برسالة نصية وزرّ تطبيق مصغّر ملحق يظهر عليهAdd a contact
. يمكنك النقر على الزر لفتح مربع حوار نموذج الاتصال. - إرسال رسالة مباشرة إلى تطبيق Chat بدون
أمر الشرطة المائلة، مثل
Hello
. تطبيق Chat الردود مع نص وبطاقة تحتوي على نموذج الاتصال.
- استخدِم الأمر
تَنظيم
لتجنب تكبد أي رسوم إلى حسابك في Google Cloud مقابل الموارد المستخدمة في هذا البرنامج التعليمي، نوصيك بحذف المشروع على السحابة الإلكترونية.
- في وحدة تحكّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. (يُرجى النقر.) قائمة الطعام > إدارة الهوية وإمكانية الوصول و المشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع ثم انقر على إيقاف التشغيل لحذفه. للمشروع.
مواضيع ذات صلة
- الردّ على الأوامر التي تبدأ بشرطة مائلة
- جمع المعلومات من مستخدمي Google Chat ومعالجتها
- فتح مربّعات الحوار التفاعلية
- استكشاف نماذج تطبيقات Google Chat الأخرى