إنشاء تطبيق Google Chat باستخدام "برمجة تطبيقات Google"

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

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

في المخطّط البياني السابق، يتلقّى المستخدم الذي يتفاعل مع تطبيق Chat في Apps Script تدفق المعلومات التالي:

1. يرسل أحد المستخدمين رسالة إلى تطبيق Chat، إمّا في رسالة مباشرة أو في مساحة Chat.
2. يتلقّى منطق تطبيق Chat الذي يتم تنفيذه في Apps Script، والذي يقيم في Google Cloud، الرسالة ويعالجها.
3. يمكن دمج منطق تطبيق Chat اختياريًا مع خدمات Google Workspace، مثل "تقويم Google" أو "جداول بيانات Google"، أو خدمات Google الأخرى، مثل "خرائط Google" أو YouTube.
4. يُرسِل منطق تطبيق Chat استجابةً إلى خدمة تطبيق Chat في Chat.
5. يتم تسليم الردّ إلى المستخدم.

الأهداف

• اضبط إعدادات البيئة.
• إعداد النص البرمجي
• انشر تطبيق Chat.
• اختبِر تطبيق Chat.

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

• حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
• مشروع على Google Cloud لإنشاء مشروع، اطّلِع على مقالة إنشاء مشروع على Google Cloud.

إعداد البيئة

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

افتح مشروع Cloud الذي تريد استخدامه لهذه العيّنة إذا لم يكن مفتوحًا من قبل:

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

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

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

تفعيل Chat API

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

• في Google Cloud Console، فعِّل Google Chat API.

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

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

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

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

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

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

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

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

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

لإعداد النص البرمجي، يمكنك استخدام نموذج ثم ضبط مشروعك على Cloud في Apps Script.

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

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

نسخ رقم مشروع Cloud

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

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

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

ضبط مشروع Cloud لمشروع "برمجة التطبيقات"

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

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

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

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

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

للحصول على رقم تعريف عملية النشر الرئيسية، اتّبِع الخطوات التالية:

1. في مشروع Chat على Apps Script، انقر على نشر > اختبار عمليات النشر.
2. انسخ رقم تعريف نشر الإصدار الرئيسي لاستخدامه في خطوة لاحقة، ثم انقر على تم.

نشر تطبيق Chat

انشر تطبيق Chat من وحدة التحكّم.

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

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

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

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

لاختبار تطبيق Chat، افتح مساحة رسالة مباشرة باستخدام تطبيق Chat وأرسِل رسالة:

1. افتح Google Chat باستخدام حساب Google Workspace الذي قدّمته عند إضافة نفسك كمختبِر موثوق.

   الانتقال إلى Google Chat

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

4. اختَر تطبيق Chat من النتائج. ستظهر رسالة مباشرة.

   ملاحظة: إذا لم يظهر لك تطبيق Chat في قائمة النتائج، تأكَّد من تضمين حسابك على Google Workspace في إعدادات مستوى العرض في صفحة إعدادات Chat API في Google Cloud Console.

5. في الرسالة المباشرة الجديدة مع التطبيق، اكتب Hello واضغط على enter.

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

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

تحديد المشاكل وحلّها

عندما يعرض تطبيق Google Chat أو البطاقة خطأ، تظهر في واجهة Chat رسالة تفيد بأنّ "حدث خطأ". أو "تعذّرت معالجة طلبك". في بعض الأحيان، لا يعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن ينتج عن تطبيق Chat أو البطاقة نتيجة غير متوقّعة. على سبيل المثال، قد لا تظهر رسالة البطاقة .

على الرغم من أنّه قد لا تظهر رسالة خطأ في واجهة مستخدم Chat، تتوفّر رسائل خطأ وصفية وبيانات السجلّ لمساعدتك في حلّ الأخطاء عند تفعيل تسجيل الأخطاء في تطبيقات Chat. للحصول على مساعدة في عرض الأخطاء وتصحيحها وتصحيح الأخطاء، يُرجى الاطّلاع على مقالة تحديد مشاكل Google Chat وحلّها.

تَنظيم

لتجنُّب تحمُّل رسوم على حسابك على Google Cloud مقابل موارد المستخدَمة في هذا الدليل التعليمي، ننصحك بحذف مشروع Cloud.

تحذير: يؤدي حذف مشروع إلى النتائج التالية:

• يتم حذف كل المحتوى في المشروع. إذا استخدمت مشروعًا حاليًا في هذا الدليل التعليمي، سيؤدي حذفه إلى حذف أي عمل آخر أجريته في المشروع.
• فقدان أرقام تعريف المشاريع المخصّصة عند إنشاء هذا المشروع، ربما أنشأت معرّف مشروع مخصّصًا تريد استخدامه في المستقبل. للحفاظ على عناوين URL التي تستخدِم رقم تعريف المشروع، مثل عنوان URL على appspot.com، يمكنك حذف الموارد المحدّدة داخل المشروع بدلاً من حذف المشروع بأكمله.

إذا كنت تخطّط لاستكشاف عدة برامج تعليمية وبرامج سريعة البدء، يمكن أن يساعدك إعادة استخدام المشاريع في تجنُّب تجاوز حدود الحصة المخصّصة للمشاريع.

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

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

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

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

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