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

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

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

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

في المخطّط البياني السابق، يتضمّن المستخدم الذي يتفاعل مع تطبيق 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 Cloud في Google Cloud Console

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

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

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

  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. إذا اخترت خارجي لنوع المستخدم، أضِف مستخدمي المختبِرين:
    1. ضمن المستخدمون التجريبيون، انقر على إضافة مستخدمين.
    2. أدخِل عنوان بريدك الإلكتروني وأي مستخدمين مختبِرين معتمَدين آخرين، ثم انقر على حفظ ومتابعة.
  6. مراجعة ملخص تسجيل التطبيق لإجراء تغييرات، انقر على تعديل. إذا كان تسجيل التطبيق يبدو جيدًا، انقر على الرجوع إلى لوحة البيانات.

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

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

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

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

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

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

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

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

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

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

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

اختبار تطبيق Chat

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

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

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

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

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