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

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

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

بنية تطبيق Chat تم تنفيذه باستخدام "برمجة تطبيقات Google"

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

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

الأهداف

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

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

إعداد البيئة

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

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

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

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

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

تفعيل Chat API

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

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

  1. في "وحدة تحكّم Google Cloud"، انتقِل إلى "القائمة" > > العلامة التجارية.

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

  2. إذا سبق لك ضبط ، يمكنك ضبط إعدادات "شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth" التالية في العلامة التجارية والجمهور والوصول إلى البيانات. إذا ظهرت لك الرسالة لم يتم الإعداد بعد، انقر على البدء:
    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، ثم انقر على إعادة تسمية.

نسخ رقم مشروع Cloud

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

    الانتقال إلى إعدادات "إدارة الهوية وإمكانية الوصول" والمشرف

  2. في حقل رقم المشروع، انسخ القيمة.

ضبط مشروع Cloud لمشروع "برمجة التطبيقات"

  1. في مشروع "برمجة تطبيقات Google" لتطبيق Chat، انقر على إعدادات المشروع رمز إعدادات المشروع.
  2. ضمن مشروع Google Cloud Platform (GCP)، انقر على تغيير المشروع.
  3. في رقم مشروع Google Cloud Platform، ألصِق رقم مشروع Google Cloud.
  4. انقر على تحديد المشروع.

أصبح لديك الآن رمز برمجي للتطبيق يمكنك تجربته (كما هو موضّح في الخطوات التالية) ثم تخصيصه لتلبية متطلباتك.

تأكَّد من تسجيل الدخول إلى حساب Google الصحيح عند فتح نموذج Apps Script. في بعض الأحيان، يمكن أن يتم التبديل إلى حسابك التلقائي بدون أن تلاحظ ذلك.

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

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

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

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

نشر تطبيق Chat

انشر تطبيق Chat من وحدة التحكّم.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تَنظيم

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

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

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

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

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

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