البدء السريع لتطبيق 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، انتقِل إلى رمز القائمة menu > APIs & Services (واجهات برمجة التطبيقات والخدمات) > OAuth consent screen (شاشة موافقة OAuth).

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

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

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

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

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

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

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

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

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

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

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

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 من Google Cloud Console.

1. في وحدة تحكّم Google Cloud، ابحث عن 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. انقر على add محادثة جديدة.
3. في حقل إضافة مستخدم واحد أو أكثر، اكتب اسم تطبيق Chat.

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

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

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

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

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

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

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

تَنظيم

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

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

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

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

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

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