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

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

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

يتيح لك تطبيق 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.

إعداد البيئة

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

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

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 الكامل .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ضبط تطبيق Chat

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

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

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

   1. في حقل اسم التطبيق ، أدخِل Add-on Chat app.
   2. في حقل عنوان URL للصورة الرمزية ، أدخِل https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png.
   3. في حقل الوصف ، أدخِل Add-on Chat 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 مقابل الموارد المستخدَمة في هذا البرنامج التعليمي، ننصحك بحذف مشروع Cloud.

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

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

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

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

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

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