ضبط تطبيق Google Chat

توضّح هذه الصفحة كيفية ضبط تطبيق Google Chat ونشره كإضافة في Google Workspace.

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

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

HTTP

برمجة تطبيقات

اختيار اسم معروض وصورة رمزية ووصف لتطبيق Chat

يتم عرض اسم تطبيق Chat وصورته الرمزية ووصف التطبيق للمستخدمين في واجهة مستخدم Chat. للتفاعل مع تطبيقات Chat، يرى المستخدمون هذه المعلومات أو يستخدمونها بالطُرق التالية:

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

قبل ضبط إعدادات تطبيق Chat، عليك تجهيز المعلومات التالية:

الحقل الوصف التنسيق
اسم التطبيق الاسم المعروض لتطبيق Chat ما يصل إلى 25 حرفًا أبجديًا رقميًا
عنوان URL للأفاتار الصورة التي تظهر كأفاتار تطبيق Chat عنوان URL يستخدم بروتوكول HTTPS ويشير إلى صورة رسومات مربّعة (بتنسيق PNG أو JPEG). الحجم المُقترَح هو 256 × 256 بكسل أو أكثر.
الوصف وصف موجز لهدف تطبيق Chat ما يصل إلى 40 حرفًا أبجديًا رقميًا

في القسم التالي، يمكنك تحديد هذه المعلومات في الإعدادات في Chat API.

ضبط تطبيق Chat في Google Cloud Console

بعد الحصول على تفاصيل تطبيق Chat، افتح مشروعك على Cloud وضبط Chat API:

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

    الانتقال إلى صفحة إعدادات Chat API

  2. ضمن معلومات التطبيق، املأ حقلَي اسم التطبيق وعنوان URL للصورة الرمزية والوصف.

  3. ضمن الميزات التفاعلية، انقر على تفعيل الميزات التفاعلية لضبط الإعداد على "تفعيل" وأكمِل ما يلي:

    1. ضمن الوظيفة، ضَع علامة في مربّع اختيار واحد أو أكثر لتوفير تطبيق Chat لتثبيته واستخدامه:

      • تلقّي رسائل بين شخصين: يمكن للمستخدمين تثبيت تطبيق Chat ومراسلة العميل من خلاله في مساحة مخصّصة بين العميل وتطبيق Chat.

      • الانضمام إلى المساحات والمحادثات الجماعية: يمكن للمستخدمين إضافة تطبيق Chat والتفاعل معه في مساحات تضم عدة أشخاص.

    2. ضمن إعدادات الاتصال، اختَر البنية التي تريد استخدامها لتلقّي عناصر الأحداث من Chat:

      • لاستخدام خدمة HTTP، اختَر عنوان URL لنقطة نهاية HTTP وقدِّم عنوانًا لعنوان URL.
      • لاستخدام مشروع "برمجة تطبيقات Google"، اختَر برمجة تطبيقات Google وقدِّم رقم تعريف النشر للمشروع.

    3. اختياري: لتلقّي عناصر الأحداث في أكثر من نقطة نهاية أو وظيفة واحدة، انتقِل إلى الإعدادات المتقدّمة > العوامل المشغّلة وقدِّم أو عدِّل وظائف الاستدعاء التالية لعوامل تشغيل Chat:

      • ‫ADDED_TO_SPACE: يضيف مستخدم تطبيق Chat إلى محادثة جماعية أو مساحة، أو يُثبِّت تطبيق Chat للرسائل بين شخصَين.
      • الرسالة: يُرسِل مستخدم رسالة إلى تطبيق Chat. على سبيل المثال، يُرسِل رسالة مباشرة إلى تطبيق Chat أو يُشير باستخدام @إلى تطبيق Chat في مساحة تضمّ عدة مستخدمين.
      • ‫REMOVED_FROM_SPACE: يزيل مستخدم تطبيق Chat من مساحة أو يلغى تثبيته.

    4. اختياري: أضِف ميزات تفاعلية أخرى، مثل أوامر الشرطة المائلة أو معاينات الروابط.

    5. ضمن مستوى الوصول، حدِّد بريدك الإلكتروني حتى تتمكّن من تثبيت تطبيق Chat واختباره قبل نشره على Google Workspace Marketplace. يمكنك تحديد ما يصل إلى خمسة أفراد أو مجموعة واحدة أو أكثر من "مجموعات Google" من مؤسستك في Google Workspace.

  4. اختياري: ضمن السجلّات، ضَع علامة في مربّع الاختيار تسجيل الأخطاء في "سجلّات Google" ل استخدام "سجلّات Google Cloud". لمزيد من المعلومات، يُرجى الاطّلاع على سجلّات أخطاء طلب البحث عن تطبيقات Chat في مستندات Chat API.

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

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

نقاط يجب مراعاتها في ما يتعلّق بإضافات Google Workspace الحالية

تتطلّب تطبيقات Chat عملية ضبط مختلفة مقارنةً بإضافة Google Workspace التي تضيف ميزات إلى تطبيقات Google Workspace الأخرى. إذا كانت الإضافة توفّر ميزات إضافية في تطبيقات Google Workspace الأخرى، يجب مراعاة المتطلبات التالية لضبط تطبيق Chat:

  • يجب أن يتمكّن المستخدمون الفرديون ومشرفي Google Workspace من تثبيت إضافتك من Marketplace. يمكنك ضبط إعدادات التثبيت هذه في حزمة تطوير البرامج (SDK) في Google Workspace Marketplace.
  • لا تستخدم تطبيقات Chat الاسم والشعار اللذين تضبطهما لتطبيقات Google Workspace الأخرى في عنصر addons.common من manifest.
  • بالنسبة إلى الإضافات المنشورة على Google Workspace Marketplace، لا يمكنك حفظ مسودة لأي تغييرات على إعدادات ضبط Google Chat API. بعد تعديل إعدادات ضبط Chat API وحفظها، يصبح تطبيق Chat المعدَّل متاحًا لجميع المستخدِمين الحاليين. لتعديل بطاقة بياناتك على Marketplace، يمكنك إنشاء مسودة قبل إرسال أي تغييرات.

  • إذا أنشأت الإضافة باستخدام برمجة التطبيقات:

  • إذا أنشأت الإضافة باستخدام خدمة HTTP، احذف أي تفاصيل لإعدادات تطبيق Chat فيملف الادراج وعمليات النشر التي تنشئها باستخدام Google Workspace Add-ons API. إنّ عمليات نشر بروتوكول HTTP التي تحدّدها في حزمة تطوير البرامج (SDK) في Google Workspace Marketplace لا تُستخدَم إلا لتطبيقات Google Workspace الأخرى.