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

توضّح هذه الصفحة كيفية إنشاء إضافة Google Workspace تعمل في Google Chat باستخدام Google Apps Script. في Google Chat، تظهر الإضافات للمستخدمين على أنّها تطبيقات Google Chat. لمزيد من المعلومات، راجِع نظرة عامة على توسيع نطاق Google Chat.

يتيح لك تطبيق 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. يتم تسليم الردّ إلى المستخدم.

الأهداف

• اضبط إعدادات البيئة.
• إعداد النص البرمجي
• ضبط إضافة Google Workspace لتطبيق 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. انقر على الزر التالي لفتح مشروع الإضافة في Google Chat Apps Script.
   فتح المشروع
2. انقر على نظرة عامة.
3. في صفحة النظرة العامة، انقر على إنشاء نسخة.

4. أدخِل اسمًا لنسختك من مشروع Apps Script:

   1. انقر على نسخة من تطبيق Chat الإضافي.

   2. في عنوان المشروع، اكتب Add-on Chat app.

   3. انقر على إعادة تسمية.

نسخ رقم مشروع 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. انسخ رقم تعريف عملية النشر الرئيسية لاستخدامه في خطوة لاحقة، ثم انقر على تم.

ضبط الإضافة

باستخدام عملية نشر Apps Script، اتّبِع الخطوات التالية لإنشاء ملف إضافي ونشر تطبيق Google Chat:

1. في وحدة التحكّم، ابحث عن Google Chat API، ثم انقر على Google Chat API.
2. انقر على إدارة.

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

   1. في حقل اسم التطبيق، أدخِل Add-on Chat app.
   2. في الحقل عنوان URL للصورة الرمزية، أدخِل https://developers.google.com/chat/images/quickstart-app-avatar.png.
   3. في حقل الوصف، أدخِل Add-on Chat app.
   4. ضمن الوظيفة، اختَر تلقّي رسائل بين شخصَين و الانضمام إلى المساحات والمحادثات الجماعية.
   5. ضمن إعدادات "الاتصال"، اختَر مشروع Apps Script.
   6. في حقل رقم تعريف عملية النشر، الصِق رقم تعريف عملية النشر الرئيسي الذي سبق أن copied.
   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. في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.