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

ملاحظة: يشرح هذا الدليل كيفية إنشاء تطبيق Chat تفاعلي باستخدام أحداث التفاعل في Chat API. يمكنك أيضًا إنشاء تطبيق Chat كإضافة على Google Workspace. للتعرّف على إطار العمل الذي يجب استخدامه، يُرجى الاطّلاع على مقالة إنشاء تطبيق تفاعلي على Google Chat.

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

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

في المخطط السابق، يتفاعل المستخدم مع تطبيق Chat في "برمجة تطبيقات Google" وفقًا لتدفق المعلومات التالي:

1. يرسل المستخدم رسالة إلى تطبيق Chat، إما في رسالة مباشرة أو في مساحة على Chat.
2. تتلقّى منطق تطبيق Chat الذي تم تنفيذه في "برمجة تطبيقات Google" الرسالة وتعالجها. ويقع هذا المنطق في 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.

إعداد البيئة

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

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

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

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

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 API Console، انتقِل إلى "القائمة" > منصة Google للمصادقة > العلامة التجارية.

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

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

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

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

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

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

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

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

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

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

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

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

يمكنك ضبط إعدادات تطبيق Chat من API Console.

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

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

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

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، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > المشرف وإدارة الهوية وإمكانية الوصول > إدارة الموارد.

   الانتقال إلى Resource Manager

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

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

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