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

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

الأهداف

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

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

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

إعداد البيئة

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

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

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

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

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

تفعيل Chat API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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