إنشاء تطبيق Google Chat باستخدام "برمجة تطبيقات Google"

أنشئ تطبيقًا على Google Chat يمكنك مراسلته مباشرةً، وسيردّ عليك بتكرار رسائلك.

يوضّح المخطّط التالي بنية النظام ونمط المراسلة:

في المخطّط البياني السابق، يتضمّن تفاعل المستخدم مع تطبيق Chat على برمجة تطبيقات تدفّق المعلومات التالي:

1. يرسل مستخدم رسالة إلى تطبيق Chat، إما في رسالة مباشرة أو في مساحة Chat.
2. تتلقّى منطق تطبيق Chat الذي تم تنفيذه في برمجة تطبيقات والموجود في Google Cloud الرسالة وتعالجها.
3. يمكن دمج منطق تطبيق Chat اختياريًا مع خدمات Google Workspace، مثل "تقويم Google" أو "جداول بيانات Google"، أو خدمات Google الأخرى، مثل "خرائط Google" أو YouTube.
4. ترسل منطق تطبيق Chat ردًا إلى خدمة تطبيق Chat في Chat.
5. يتم تسليم الرد إلى المستخدم.

الأهداف

• إعداد البيئة
• إعداد النص البرمجي
• ضبط إعدادات تطبيق Chat
• اختبِر تطبيق Chat.

المتطلبات الأساسية

• حساب Google Workspace Business أو Enterprise مع إمكانية الوصول إلى Google Chat
• مشروع Google Cloud لإنشاء مشروع، اطّلِع على مقالة إنشاء مشروع على Google Cloud.

إعداد البيئة

افتح مشروعك على السحابة الإلكترونية في Google Cloud Console

افتح مشروع على السحابة الإلكترونية الذي تريد استخدامه لهذا النموذج إذا لم يكن مفتوحًا من قبل:

1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة اختيار مشروع.

   اختيار مشروع على السحابة الإلكترونية

2. اختَر مشروع Google Cloud الذي تريد استخدامه. أو انقر على إنشاء مشروع واتّبِع التعليمات الظاهرة على الشاشة. في حال إنشاء مشروع على Google Cloud، قد تحتاج إلى تفعيل الفوترة للمشروع.

تفعيل Chat API

قبل استخدام واجهات Google APIs، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيق واحدة أو أكثر في مشروع واحد على Google Cloud.

• في Google Cloud Console، فعِّل Google Chat API.

  تفعيل واجهة برمجة التطبيقات

إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

تتطلّب جميع التطبيقات التي تستخدم OAuth 2.0 إعداد شاشة طلب الموافقة. يؤدي ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth في تطبيقك إلى تحديد ما سيظهر للمستخدمين ومراجعي التطبيق، كما يؤدي إلى تسجيل تطبيقك لتتمكّن من نشره لاحقًا.

1. في Google API Console، انتقِل إلى "القائمة" menu > منصة Google Auth > العلامة التجارية.

   الانتقال إلى "هوية العلامة التجارية"

2. إذا سبق لك إعداد منصة Google Auth، يمكنك ضبط إعدادات "شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth" التالية في العلامة التجارية والجمهور والوصول إلى البيانات. إذا ظهرت لك الرسالة لم يتم إعداد منصة Google Auth بعد، انقر على البدء:
1. ضمن معلومات التطبيق، في اسم التطبيق، أدخِل اسمًا للتطبيق.
2. في حقل البريد الإلكتروني لدعم المستخدمين، اختَر عنوان بريد إلكتروني للدعم يمكن للمستخدمين التواصل معك من خلاله إذا كانت لديهم أسئلة حول موافقتهم.
3. انقر على التالي.
4. ضمن الجمهور، اختَر داخلي.
5. انقر على التالي.
6. ضمن معلومات الاتصال، أدخِل عنوان بريد إلكتروني يمكنك تلقّي إشعارات فيه بشأن أي تغييرات تطرأ على مشروعك.
7. انقر على التالي.
8. ضمن إنهاء، راجِع سياسة بيانات المستخدمين في خدمات Google API، وإذا كنت توافق عليها، ضَع علامة في المربّع أوافق على "سياسة بيانات المستخدمين في خدمات Google API".
9. انقر على متابعة.
10. انقر على إنشاء.
3. يمكنك حاليًا تخطّي إضافة النطاقات. في المستقبل، عند إنشاء تطبيق لاستخدامه خارج مؤسسة Google Workspace، عليك تغيير نوع المستخدم إلى خارجي. بعد ذلك، أضِف نطاقات التفويض التي يتطلّبها تطبيقك. لمزيد من المعلومات، يُرجى الاطّلاع على الدليل الكامل حول ضبط موافقة OAuth.

إعداد النص البرمجي

لإعداد النص البرمجي، عليك استخدام نموذج ثم ضبط مشروعك على السحابة الإلكترونية في "برمجة تطبيقات Google".

إنشاء النص البرمجي من النموذج

1. انتقِل إلى صفحة بدء استخدام Apps Script.
2. انقر على نموذج تطبيق المحادثة في أعلى الصفحة.
3. انقر على مشروع بلا عنوان، واكتب Quickstart app، ثم انقر على إعادة تسمية.

في المستقبل، إذا أردت استخدام Google APIs معيّنة أو نشر تطبيقك، عليك ربط مشروعك على السحابة الإلكترونية بمشروعك على "برمجة تطبيقات Google". ليس عليك إجراء ذلك في هذا الدليل. لمزيد من المعلومات، يمكنك الاطّلاع على دليل مشاريع Google Cloud.

إنشاء عملية نشر اختبارية

تحتاج إلى معرّف نشر لمشروع "برمجة تطبيقات Google" هذا، حتى تتمكّن من استخدامه في الخطوة التالية.

للحصول على رقم تعريف عملية نشر العنوان، اتّبِع الخطوات التالية:

1. في مشروع "برمجة التطبيقات" لتطبيق Chat، انقر على نشر > اختبار عمليات النشر.
2. انسخ معرّف نشر العنوان لاستخدامه في خطوة لاحقة، ثم انقر على تم.

ضبط إعدادات تطبيق Chat

ضبط تطبيق Chat من واجهة برمجة التطبيقات

1. في وحدة تحكّم API، ابحث عن Google Chat API وانقر على Google Chat API.
2. انقر على إدارة.

3. انقر على الإعداد وأعِدّ تطبيق Chat على النحو التالي:

   1. ألغِ تحديد إنشاء تطبيق Chat هذا كإضافة على Google Workspace. سيظهر مربّع حوار يطلب منك التأكيد. في مربّع الحوار، انقر على إيقاف.
   2. في حقل اسم التطبيق، أدخِل Quickstart app.
   3. في الحقل عنوان URL للصورة الرمزية، أدخِل https://developers.google.com/chat/images/quickstart-app-avatar.png.
   4. في حقل الوصف، أدخِل Quickstart app.
   5. ضمن الوظائف، اختَر الانضمام إلى المساحات والمحادثات الجماعية.
   6. ضمن "إعدادات الاتصال"، اختَر Apps Script.
   7. في حقل رقم تعريف عملية النشر، ألصِق رقم تعريف عملية النشر الرئيسي الذي نسخته سابقًا.
   8. ضمن "إذن الوصول"، اختَر مستخدمون ومجموعات محدّدة في نطاقك، ثم أدخِل عنوان بريدك الإلكتروني.

4. انقر على حفظ.

تطبيق Chat جاهز للردّ على الرسائل.

اختبار تطبيق Chat

لاختبار تطبيق Chat، افتح مساحة رسالة مباشرة باستخدام تطبيق Chat وأرسِل رسالة:

1. افتح Google Chat باستخدام حساب Google Workspace الذي قدّمته عند إضافة نفسك كمختبِر موثوق به.

   الانتقال إلى Google Chat

2. انقر على add محادثة جديدة.
3. في حقل إضافة مستخدم واحد أو أكثر، اكتب اسم تطبيق Chat.

4. اختَر تطبيق Chat من النتائج. سيتم فتح رسالة مباشرة.

5. في الرسالة المباشرة الجديدة مع التطبيق، اكتب Hello واضغط على enter.

   يشكرك تطبيق Chat على إضافته ويعرض رسالتك.

لإضافة مختبِرين موثوق بهم والتعرّف على مزيد من المعلومات حول اختبار الميزات التفاعلية، يُرجى الاطّلاع على مقالة اختبار الميزات التفاعلية لتطبيقات Google Chat.

تحديد المشاكل وحلّها

عندما يعرض تطبيق أو بطاقة في Google Chat خطأً، تعرض واجهة Chat رسالة تفيد بحدوث خطأ. أو "تعذّر علينا معالجة طلبك". في بعض الأحيان، لا تعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن ينتج تطبيق Chat أو البطاقة نتيجة غير متوقّعة، مثلاً، قد لا تظهر رسالة البطاقة.

على الرغم من أنّه قد لا تظهر رسالة خطأ في واجهة مستخدم Chat، تتوفّر رسائل خطأ وصفية وبيانات سجلّات لمساعدتك في إصلاح الأخطاء عند تفعيل تسجيل الأخطاء لتطبيقات Chat. للحصول على مساعدة في عرض الأخطاء وتصحيحها وتحديد المشاكل فيها، يُرجى الاطّلاع على تحديد مشاكل Google Chat وحلّها.

تَنظيم

لتجنُّب تحمّل رسوم في حسابك على Google Cloud مقابل الموارد المستخدَمة في هذا البرنامج التعليمي، ننصحك بحذف مشروع على السحابة الإلكترونية.

1. في Google API Console، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة menu > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.

   الانتقال إلى "إدارة الموارد"

2. في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف delete.
3. في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.

الخطوات التالية

• إنشاء بطاقات تفاعلية: تتيح رسائل البطاقات استخدام تنسيق محدّد وعناصر تفاعلية في واجهة المستخدم، مثل الأزرار والوسائط التفاعلية المتقدّمة، مثل الصور. استخدِم رسائل البطاقات لعرض معلومات مفصّلة، وجمع معلومات من المستخدمين، وتوجيههم لاتّخاذ الخطوة التالية.
• الردّ على الأوامر: تساعد الأوامر المستخدمين في استكشاف الميزات الرئيسية لتطبيق Chat واستخدامها.
• مربّعات الحوار عند التشغيل: مربّعات الحوار هي واجهات مستندة إلى بطاقات ومقسّمة إلى نوافذ يمكن لتطبيقك فتحها للتفاعل مع المستخدم. يمكن ربط بطاقات متعدّدة معًا بالتسلسل، ما يساعد المستخدمين في إكمال العمليات المتعدّدة الخطوات، مثل ملء بيانات النموذج.
• code درس تطبيقي حول الترميز: هل أنت مستعد لإنشاء تطبيق دردشة أكثر تقدّمًا؟ اطّلِع على تطبيق Chat الخاص بتقديم الملاحظات من درس تطبيقي حول الترميز إنشاء تطبيقات لـ Google Chat باستخدام Gemini.