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

توضّح هذه الصفحة كيفية إنشاء تطبيق Google Chat باستخدام "برمجة تطبيقات Google". يتيح لك تطبيق Chat إرسال رسائل مباشرة والردّ من خلال تكرار رسائلك.

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

In the preceding diagram, a user interacting with an Apps Script Chat app has the following flow of information:

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

الأهداف

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

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

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

إعداد البيئة

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

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

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

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

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

تفعيل Chat API

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

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

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

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

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

1. في Google API Console، انتقِل إلى "القائمة" > منصة Google Auth > العلامة التجارية.

   الانتقال إلى "هوية العلامة التجارية"

2. إذا سبق لك ضبط منصة Google Auth، يمكنك ضبط إعدادات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth التالية في الهوية البصرية والجمهور والوصول إلى البيانات. إذا ظهرت لك رسالة تفيد بأنّه لم يتم إعداد منصة Google Auth بعد، انقر على البدء:
1. ضمن معلومات التطبيق، أدخِل اسمًا للتطبيق في حقل اسم التطبيق.
2. في حقل البريد الإلكتروني لدعم المستخدمين، اختَر عنوان بريد إلكتروني للدعم يمكن للمستخدمين التواصل معك من خلاله إذا كانت لديهم أسئلة حول موافقتهم.
3. انقر على التالي.
4. ضمن الجمهور، اختَر داخلي.
5. انقر على التالي.
6. ضمن معلومات الاتصال، أدخِل عنوان بريد إلكتروني يمكن إرسال إشعارات إليك من خلاله بشأن أي تغييرات تطرأ على مشروعك.
7. انقر على التالي.
8. ضمن إنهاء، راجِع سياسة بيانات المستخدمين في خدمات Google API، وإذا وافقت عليها، اختَر أوافق على "سياسة بيانات المستخدمين في خدمات Google API".
9. انقر على متابعة.
10. انقر على إنشاء.
3. في الوقت الحالي، يمكنك تخطّي إضافة النطاقات. في المستقبل، عند إنشاء تطبيق لاستخدامه خارج مؤسستك على Google Workspace، عليك تغيير نوع المستخدم إلى خارجي. بعد ذلك، أضِف نطاقات التفويض التي يتطلّبها تطبيقك. لمزيد من المعلومات، يُرجى الاطّلاع على دليل ضبط موافقة OAuth الكامل.

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

لإعداد النص البرمجي، يمكنك استخدام نموذج تطبيق Chat من صفحة البدء في "برمجة تطبيقات Google".

إنشاء مشروع "برمجة تطبيقات Google"

1. من صفحة البدء في "برمجة تطبيقات Google"، انتقِل إلى مبتدئي إضافات Google Workspace وانقر على نموذج تطبيق Chat:

   فتح نموذج تطبيق Chat

2. في مشروع "برمجة تطبيقات Google" الجديد الذي يفتح، أدخِل اسمًا للمشروع:

   1. انقر على مشروع بلا عنوان.

   2. في حقل عنوان المشروع، اكتب Quickstart app.

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

في المستقبل، إذا أردت استخدام بعض واجهات Google APIs أو نشر تطبيقك، عليك ربط مشروعك على السحابة الإلكترونية بمشروعك على "برمجة تطبيقات Google". ولكن ليس عليك إجراء ذلك في هذا الدليل. لمزيد من المعلومات، يُرجى الاطّلاع على دليل مشاريع Google Cloud.

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

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

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

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

ضبط إعدادات تطبيق Chat

اتّبِع الخطوات التالية لضبط تطبيق Google Chat:

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

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

   1. في حقل اسم التطبيق، أدخِل Quickstart app.
   2. في حقل عنوان URL للأفاتار، أدخِل https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
   3. في حقل الوصف، أدخِل Quickstart app.
   4. ضمن الوظيفة، اختَر الانضمام إلى المساحات والمحادثات الجماعية.
   5. ضِمن إعدادات الربط، اختَر مشروع "برمجة تطبيقات Google".
   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 API Console.

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

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

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

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

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

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

تَنظيم

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

تنبيه: يؤدي حذف مشروع إلى ما يلي:

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

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

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

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

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

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

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

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

لإنشاء تطبيق Chat ليس إضافة في Google Workspace باستخدام "برمجة تطبيقات Google"، اتّبِع الخطوات التالية لإنشاء النص البرمجي من النموذج وضبط تطبيق Chat الذي ليس إضافة.

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

1. فتح نموذج تطبيق Chat

2. انقر على مشروع بلا عنوان، واكتب Quickstart app، ثم انقر على إعادة تسمية.

   في المستقبل، إذا أردت استخدام بعض Google APIs أو نشر تطبيقك، يجب ربط مشروعك على السحابة الإلكترونية بمشروعك على "برمجة تطبيقات Google". بالنسبة إلى هذا الدليل، لست بحاجة إلى إجراء ذلك. لمزيد من المعلومات، يُرجى الاطّلاع على دليل مشاريع Google Cloud.

3. في مشروع "برمجة تطبيقات" لتطبيق Chat، انقر على نشر > اختبار عمليات النشر.

4. انسخ معرّف النشر الرئيسي لاستخدامه في الخطوة التالية، ثم انقر على تم.

ضبط تطبيق Chat الذي ليس إضافة

اضبط تطبيق Chat الذي لا يُعدّ إضافة من "وحدة تحكّم واجهة برمجة التطبيقات":

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

3. انقر على الإعداد وأعِدّ تطبيق Chat الذي ليس إضافة:

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

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