البدء السريع لتطبيق 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 لديه إمكانية الوصول إلى 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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. انقر على رمز add محادثة جديدة.
3. في الحقل إضافة مستخدم واحد أو أكثر، اكتب اسم تطبيق Chat.

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

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

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

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

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

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

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

تَنظيم

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

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

   الانتقال إلى Resource Manager

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

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

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