ضبط تطبيق Google Chat

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

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

ملاحظة: توضّح هذه الصفحة كيفية إعداد تطبيق Chat باستخدام Apps Script أو خدمة HTTP. ‫Dialogflow وPub/Sub غير متاحتَين. لمزيد من التفاصيل، يُرجى الاطّلاع على القيود والمشاكل المعروفة.

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

• حساب Google Workspace من إصدار Business أو Enterprise مع إذن الوصول إلى Google Chat
• أنشئ مشروعًا على Google Cloud.
• ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
• تفعيل واجهة برمجة تطبيقات Google Chat

اختيار اسم معروض وأفاتار ووصف لتطبيق 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

في Google Cloud Console، يمكنك ضبط التفاصيل الخاصة بتطبيق Chat والتي تظهر للمستخدمين في Chat، بما في ذلك الاسم المعروض والصورة الرمزية والوصف. لا تظهر هذه التفاصيل إلا في Chat. لنشر تطبيق Chat على Marketplace، يجب أيضًا تحديد التفاصيل التي تظهر في بطاقة بيانات Marketplace الخاصة بتطبيق Chat.

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

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

   الانتقال إلى صفحة "إعدادات واجهة برمجة تطبيقات Chat"

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

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

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

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

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

      • لاستخدام خدمة HTTP، اختَر عنوان URL لنقطة نهاية HTTP وقدِّم عنوان URL.
      • لاستخدام مشروع Google Apps Script، اختَر Apps Script وقدِّم رقم تعريف عملية النشر للمشروع.
      تحذير: إذا كان معرّف نشر Apps Script مُدخلاً من قبل، يعني ذلك أنّ مشروع Cloud مرتبط بإضافة حالية على Google Workspace. إذا عدّلت معرّف النشر في Chat API، سيتم تعديل معرّف النشر الخاص بالإضافة، وقد يؤثر ذلك في بطاقة بياناتك على Google Workspace Marketplace. لمراجعة إعدادات الإضافة، يُرجى الاطّلاع على ضبط تطبيقك في حزمة تطوير البرامج (SDK) في Google Workspace Marketplace ضمن مستندات Google Workspace Marketplace.

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

      ملاحظة: في Apps Script، إذا لم تعدّل المشغّلات، عليك استخدام دوال معاودة الاتصال المقابلة التي يتم ملؤها في هذا القسم (مثل onMessage وonAddedToSpace وonRemovedFromSpace).
      • تمت الإضافة إلى المساحة: يضيف مستخدم تطبيق Chat إلى محادثة جماعية أو مساحة، أو يثبّت تطبيق Chat للرسائل بين شخصين.
      • الرسالة: يرسل المستخدم رسالة إلى تطبيق Chat، مثلاً، يرسل رسالة مباشرة إلى تطبيق Chat أو يشير إلى تطبيق Chat باستخدام @في مساحة تضم عدة مستخدمين.
      • تمت الإزالة من المساحة: يزيل المستخدم تطبيق Chat من المساحة أو يلغي تثبيته.
      • أمر التطبيق: يستخدم المستخدم أمرًا سريعًا أو أمرًا يبدأ بشرطة مائلة من تطبيق Chat.

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

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

4. اختياري: ضِمن السجلّات، ضَع علامة في مربّع الاختيار تسجيل الأخطاء في Logging لاستخدام Google Cloud Logging. لمزيد من المعلومات، راجِع مقالة سجلّات أخطاء طلب البحث عن تطبيقات 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 من بيان التطبيق.
• بالنسبة إلى الإضافات المنشورة على Google Workspace Marketplace، لا يمكنك حفظ مسودة لأي تغييرات في إعدادات ضبط واجهة برمجة التطبيقات Google Chat API. بعد تعديل إعدادات ضبط واجهة برمجة التطبيقات في Chat وحفظها، سيصبح تطبيق Chat المعدَّل متاحًا لجميع المستخدمين الحاليين. لتعديل بطاقة بياناتك على Marketplace، يمكنك إنشاء مسودة قبل إرسال أي تغييرات.

• إذا أنشأت الإضافة باستخدام Apps Script:

  • يجب استخدام معرّف عملية النشر نفسه في Apps Script الذي تستخدمه لبقية إعدادات الإضافة.
  • لا يمكنك استخدام محرِّر Apps Script لتثبيت عمليات نشر تجريبية في Chat. بدلاً من ذلك، عليك تثبيتها مباشرةً من واجهة مستخدم Chat.

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

مواضيع ذات صلة

• لإدارة إذن الوصول إلى Chat API، يُرجى الاطّلاع على مقالة ضبط Google Chat API في مستندات Google Chat API.
• اختبار الميزات التفاعلية لتطبيقات Google Chat