ضبط تطبيق Google Chat

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

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

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

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

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

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

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

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

  3. ضمن الميزات التفاعلية، انقر على تفعيل الميزات التفاعلية في موضع التشغيل وأكمِل ما يلي:

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

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

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

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

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

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

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

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

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

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

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

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

اعتبارات بشأن إضافات Google Workspace الحالية

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

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

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

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