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

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

الأهداف

• إعداد البيئة المحيطة بك.
• إعداد النص البرمجي.
• انشر التطبيق.
• شغِّل النص البرمجي.

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

• حساب على Google Workspace يملك إذن الوصول إلى Chat.
• مشروع على Google Cloud:

إعداد البيئة

فتح مشروع Google Cloud في Google Cloud Console

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

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

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

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

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

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

• في "وحدة تحكُّم Google Cloud"، فعِّل Google Chat API.

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

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

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

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

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

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

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

5. في حال اختيار خارجي لنوع المستخدم، أضِف مستخدمين تجريبيين:
   1. ضمن اختبار المستخدمين، انقر على إضافة مستخدمين.
   2. أدخِل عنوان بريدك الإلكتروني وأي مستخدمين آخرين مُعتمَدين للاختبار، ثم انقر على حفظ ومتابعة.
6. مراجعة ملخص تسجيل التطبيقات لإجراء تغييرات، انقر على تعديل. إذا كان تسجيل التطبيق يبدو "حسنًا"، انقر على الرجوع إلى لوحة البيانات.

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

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

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

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

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

1. انتقِل إلى مشروعك على السحابة الإلكترونية في Google Cloud Console.
2. انقر على رمز الإعدادات والأدوات المساعدة more_vert > إعدادات المشروع.
3. انسخ رقم المشروع.

إعداد مشروع Cloud في مشروع "برمجة تطبيقات Google"

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

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

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

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

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

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

1. في مشروع برمجة التطبيقات لتطبيق 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. ضمن Connection settings (إعدادات الاتصال)، اختَر Apps Script Project (مشروع التطبيق) والصق معرّف النشر في الحقل.
   6. ضمن "الأذونات"، اختَر أشخاص ومجموعات مُحدَّدة في نطاقك، وأدخِل بريدك الإلكتروني.

4. انقر على حفظ وأعِد تحميل الصفحة.

5. في صفحة الإعداد، ضمن حالة التطبيق، اضبط الحالة على مباشر - متاح للمستخدمين.

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

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

تشغيل النص البرمجي

1. افتح Chat.
2. إرسال رسالة مباشرة جديدة إلى التطبيق بالنقر على بدء محادثة add > البحث عن تطبيقات
3. في صفحة "البحث عن تطبيقات"، ابحث عن Quickstart App.
4. بجانب تطبيق البدء السريع، انقر على الدردشة.
5. في الرسالة المباشرة الجديدة مع التطبيق، اكتب Hello واضغط على enter.

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

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

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