البدء السريع لتطبيق Chat في "برمجة تطبيقات Google"

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

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

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

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 Console

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

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

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

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، انتقِل إلى القائمة menu > واجهات برمجة التطبيقات والخدمات > شاشة موافقة OAuth.

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

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

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

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

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

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

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

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

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

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

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

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

ضبط مشروع السحابة الإلكترونية لمشروع برمجة التطبيقات

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. ضمن "إعدادات الربط"، اختَر مشروع "برمجة تطبيقات Google".
   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 Console، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة menu > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.

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

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

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

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