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

إنشاء تطبيق Google Chat يمكنك مراسلته مباشرةً يستجيب من خلال صدى رسائلك.

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

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

في المخطط السابق، يتفاعل أحد المستخدمين مع برمجة تطبيقات في ما يلي مصادر المعلومات في تطبيق 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 Cloud في "وحدة تحكُّم Google Cloud"

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

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

    اختيار مشروع على Google Cloud

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

تفعيل Chat API

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

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

  1. في وحدة التحكّم في Google Cloud، انتقِل إلى القائمة . > واجهات برمجة التطبيقات الخدمات > شاشة موافقة OAuth.

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

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

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

  5. مراجعة ملخّص تسجيل التطبيق لإجراء تغييرات، انقر على تعديل. إذا كان التطبيق التسجيل يبدو على ما يرام، انقر على الرجوع إلى لوحة التحكم.

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

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

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

  1. الانتقال إلى قسم صفحة البدء لبرمجة التطبيقات.
  2. انقر على نموذج تطبيق Chat. قد تضطر إلى الانتقال للأسفل. لرؤية هذا القالب.
  3. انقر على مشروع بلا عنوان، واكتب Quickstart app. انقر على إعادة تسمية.

نسخ رقم المشروع على Google Cloud

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

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

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

إعداد مشروع "برمجة تطبيقات Google" على السحابة الإلكترونية

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

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

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

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

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

للحصول على رقم تعريف النشر الرئيسي، يمكنك إجراء ما يلي:

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

نشر تطبيق Chat

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

  1. في جلسة المعمل، Google Cloud Console ابحث عن 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. ضمن "إعدادات الربط"، اختَر مشروع برمجة التطبيقات.
    6. في حقل معرّف النشر، الصِق رقم تعريف النشر الرئيسي الذي الذي تم نسخه مسبقًا.
    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 أو تعرض card خطأً، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذَّرت معالجة طلبك". في بعض الأحيان، لا يمكن واجهة مستخدم Chat لا يعرض أي رسالة خطأ، ولكن يظهر تطبيق Chat أو ينتج عن بطاقة نتيجة غير متوقعة؛ على سبيل المثال، قد لا تظهر رسالة البطاقة موضع الإعلان.

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

تَنظيم

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

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

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

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

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

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