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

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

الأهداف

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

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

إعداد البيئة

فتح مشروعك على السحابة الإلكترونية في Google Cloud Console

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

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

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

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

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

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

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

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

    الانتقال إلى شاشة موافقة OAuth

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. في مشروع "برمجة تطبيقات Google" لتطبيق Chat، انقر على نشر > اختبار عمليات النشر.
  2. انسخ رقم تعريف النشر الرئيسي لاستخدامه في خطوة لاحقة وانقر على تم.

نشر تطبيق Chat

نشر تطبيق Google Chat من Google Cloud Console

  1. في Google Cloud Console، ابحث عن Google Chat API، وانقر على Google Chat API.
  2. انقر على إدارة.

  3. انقر على ضبط لإعداد تطبيق Chat:

    1. في الحقل اسم التطبيق، أدخِل Quickstart app.
    2. أدخِل https://developers.google.com/chat/images/quickstart-app-avatar.png في حقل عنوان URL للصورة الرمزية.
    3. في حقل الوصف، أدخل Quickstart app.
    4. ضمن الوظائف، اختَر استلام رسائل بين شخصين والانضمام إلى المساحات والمحادثات الجماعية.
    5. ضمن "إعدادات الاتصال"، اختَر مشروع برمجة التطبيقات والصق رقم تعريف النشر في الحقل.
    6. ضمن "الأذونات"، حدد أشخاص ومجموعات محددة في نطاقك، وأدخل بريدك الإلكتروني.

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

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

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

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

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

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

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

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

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