نشر تطبيقات Google Chat

بعد إنشاء تطبيق في Chat، يمكنك نشره ليصبح متاحًا لمجموعة مختارة من المستخدمين أو المجموعات أو لجميع المستخدمين في مؤسسة Google Workspace أو أي مستخدم من مستخدمي Google Chat.

كيفية اكتشاف المستخدمين لتطبيقات Chat واستخدامها

لاكتشاف تطبيقات Google Chat، يمكن للمستخدمين إجراء أي مما يلي:

  • ابحث عن تطبيقات Chat وثبِّتها من Google Chat أو Google Workspace Marketplace.
  • التفاعل مع تطبيق تمت إضافته إلى مساحة Chat
  • يمكنك استكشاف التطبيق في لوحة الرسائل المباشرة بعد تثبيت مشرف Google Workspace للتطبيق نيابةً عنه.

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

يمكنك إضافة تطبيق إلى مساحة من خلال كتابة @ في رسالة.

كيفية تثبيت مشرفي Google Workspace لتطبيقات Chat

يمكن لمشرفي Google Workspace العثور على التطبيقات في Chat في Google Workspace Marketplace وتثبيت التطبيقات للمستخدمين في مؤسستهم. عندما يثبّت المشرف تطبيق Chat، يظهر التطبيق في لوحة الرسائل المباشرة للمستخدمين.

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

إعداد تطبيقك على Chat ونشره باستخدام Google Cloud Console

لنشر تطبيق Chat وإتاحته للمستخدمين الآخرين، عليك بشكل عام اتّباع الخطوات التالية:

  1. تفعيل Google Chat API وضبطها عند ضبط واجهة برمجة التطبيقات، تمنح مستخدمي Google Chat الآخرين الإذن بالوصول إلى تطبيق Chat للاختبار.
  2. نشر تطبيقك باستخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace يمكنك ضبط تطبيق Chat ليكون متاحًا للمستخدمين في مؤسستك على Google Workspace أو لجميع مستخدمي Google Chat.
  3. إذا كانت مؤسستك على Google Workspace تدير إمكانية الوصول إلى تطبيقات Chat، اطلب من مشرف Google Workspace إضافة التطبيق إلى القائمة المسموح بها للمؤسسة.

إعدادات إذن الوصول والنشر لتطبيق Chat

يوضّح الجدول التالي كيفية ضبط إعدادات Google Chat API وحزمة تطوير البرامج (SDK) في Google Workspace Marketplace استنادًا إلى جمهور تطبيق Chat:

مستخدمو التطبيق المستهدَفون طريقة المصادقة إعدادات Google Chat API إعدادات حزمة تطوير البرامج (SDK) في Google Workspace Marketplace أين يتم نشر تطبيقي في Chat؟
فريقك الصغير المصادقة بصفتك مستخدم أو تطبيق: في إعداد مستوى الرؤية، حدِّد الأشخاص أو "مجموعات Google" التي يمكنها الوصول إلى التطبيق.

إذا كان حسابك على Google Workspace يتطلّب إدراج التطبيقات في القائمة المسموح بها، يمكنك تحديد ما يصل إلى 5 عناوين بريد إلكتروني فردية فقط (لا يمكنك تحديد "مجموعات Google").

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

بعد الاختبار، يمكنك نشر تطبيق Chat في مؤسستك على Google Workspace باستخدام الإعدادات في حزمة تطوير البرامج (SDK) الخاصة بـ Google Workspace Marketplace.

اضبط ظهور التطبيق على خاص.

اضبط إعدادات التثبيت على فردي + مشرف.

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

يمكن لأي شخص في مؤسستك على Google Workspace العثور على تطبيق Chat وتثبيته في Google Chat والاطّلاع على تطبيقك في Google Workspace Marketplace. يمكن للمستخدمين ومشرفي Google Workspace تثبيت تطبيقك من Marketplace.

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

بعد الاختبار، يمكنك نشر تطبيق Chat في مؤسستك على Google Workspace باستخدام الإعدادات في حزمة تطوير البرامج (SDK) الخاصة بـ Google Workspace Marketplace.

اضبط ظهور التطبيق على خاص.

اضبط إعدادات التثبيت على فردي + مشرف.

يمكن لأي شخص في مؤسستك على Google Workspace العثور على تطبيق Chat وتثبيته في Google Chat والاطّلاع على تطبيقك في Google Workspace Marketplace. لا يمكن إلا لمشرفي Google Workspace تثبيت تطبيقك من Marketplace.

الجميع (تطبيق Chat المتاح للجميع) المصادقة بصفتك مستخدم أو تطبيق: في إعداد مستوى الرؤية، حدِّد المستخدمين أو "مجموعات Google" لاختبار تطبيق Chat.

بعد الاختبار، يمكنك نشر تطبيق Chat للجميع باستخدام الإعدادات في Google Workspace Marketplace.

اضبط ظهور التطبيق على علني.

ضبط إعدادات التثبيت على فردي + مشرف

يمكن لأي مستخدم في Google Workspace العثور على تطبيق Chat وتثبيته في Google Chat، والاطّلاع على تطبيقك في Google Workspace Marketplace. لا يمكن إلا لمشرفي Google Workspace تثبيت تطبيقك من Marketplace.

تفعيل Google Chat API وضبطها

يمكنك إعداد مشروع لتطبيقك في وحدة تحكُّم Google Cloud وتفعيل Google Chat API:

  1. استخدِم الزر أدناه لإنشاء مشروع جديد (أو اختَر مشروعًا حاليًا) وأضِف حساب خدمة إليه. امنح حساب الخدمة دور مالك المشروع.
    تفعيل واجهة برمجة التطبيقات
  2. احفظ مفتاح JSON الذي تم تنزيله. يمكن لتطبيقك استخدام هذا المفتاح لمصادقة الرسائل التي يرسلها إلى المساحات بشكل غير متزامن.
  3. افتح مشروعك في . في قائمة واجهات برمجة التطبيقات، انقر على Google Chat API.
  4. اختَر علامة التبويب الإعداد وأدخِل معلومات التطبيق، كما هو موضّح في الجدول التالي.

عند حفظ إعدادات التطبيق، يصبح تطبيقك متاحًا للمستخدمين المحددين في مؤسستك على Google Workspace.

إعدادات ضبط Google Chat API

الحقل الوصف
اسم التطبيق الاسم الذي يستخدمه المستخدمون عند التفاعل مع تطبيق Chat.
عنوان URL للصورة الرمزية عنوان URL يستخدم HTTPS ويشير إلى صورة ذات رسومات مربّعة (مثل PNG أو JPEG)، بحجم 128x128 على الأقل، وستظهر كصورة رمزية لتطبيق Chat.
الوصف وصف لوظيفة تطبيق Chat يظهر أسفل اسم تطبيق Chat
الوظائف مجموعة من الحقول التي تحدِّد كيفية تفاعل تطبيق Chat مع المستخدمين:
  • تلقّي رسائل بين شخصَين: يمكن للمستخدمين العثور على تطبيق Chat ومراسلته مباشرةً في Google Chat.
  • الانضمام إلى المساحات والمحادثات الجماعية: يمكن للمستخدمين إضافة تطبيق Chat إلى المساحات والمحادثات الجماعية.
إعدادات الربط نقطة النهاية لتطبيق Chat، وهي إحدى النقاط التالية:
  • عنوان URL للتطبيق: نقطة نهاية HTTPS تستضيف تنفيذ تطبيق Chat.
  • مشروع "برمجة تطبيقات Google": رقم تعريف نشر لمشروع "برمجة تطبيقات Google" ينفّذ تطبيق Chat.
  • اسم موضوع Cloud Pub/Sub: موضوع Cloud Pub/Sub يشترك فيه تطبيق Chat كنقطة نهاية.
  • Dialogflow: لتسجيل تطبيق Chat من خلال عملية دمج Dialogflow. لمزيد من المعلومات، راجِع مستندات Dialogflow حول الدمج مع Google Chat.
الأوامر التي تبدأ بشرطة مائلة الأوامر التي يمكن عرضها للمستخدمين ضمن Google Chat. يسمح هذا الإعداد للمستخدمين بالاطّلاع على الإجراءات الأساسية لتطبيق Chat في Google Chat، واختيار إجراء معيّن يريدون التفاعل معه.
معاينات الروابط أنماط عناوين URL التي يتعرّف عليها تطبيق Chat ويقدّم محتوًى إضافيًا عندما يرسل المستخدمون الروابط. لمزيد من المعلومات، يُرجى الرجوع إلى روابط المعاينة.
مستوى الرؤية بإمكان ما يصل إلى 5 أفراد أو مجموعة واحدة أو أكثر من "مجموعات Google" الاطّلاع على تطبيق Chat وتثبيته. استخدِم هذا الحقل لاختبار تطبيق Chat أو لمشاركة تطبيق Chat مع فريقك. لمزيد من المعلومات، يمكنك الاطّلاع على إعدادات إذن الوصول والنشر في تطبيق Chat.

منح أذونات إعداد التطبيق

يمكنك منح مستخدمين محددين إمكانية الوصول إلى صفحة إعداد التطبيق. لإجراء ذلك، استخدِم دورَي "إدارة الهوية وإمكانية الوصول" (IAM) في مالك تطبيقات Chat ومُشاهد تطبيقات Chat. ولا يمكن للمستخدمين الذين لديهم هذه الأدوار الانتقال إلى صفحة ضبط التطبيق عبر لوحة بيانات واجهات برمجة التطبيقات والخدمات، ولكن يمكنهم الوصول إلى صفحة الضبط من خلال الانتقال إلى وحدة التحكّم لمشروعهم على النحو التالي:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

نشر تطبيقك باستخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace

استخدِم حزمة تطوير البرامج (SDK) لـ Google Workspace Marketplace لتنفيذ أحد الإجراءات التالية:

  • انشر تطبيقك في Chat بشكل علني واسمح لأي مستخدم في Google Chat بإضافة تطبيقك إلى مساحة.
  • انشر تطبيق Chat في مؤسستك على Google Workspace.
  • يجب إتاحة تطبيقك لمشرفي Google Workspace حتى يتمكّنوا من تثبيت التطبيق للمستخدمين في مؤسستهم. يجب أن يوفّر تطبيقك ميزة "المراسلة المباشرة" لكي يكون مرئيًا لمشرفي Google Workspace.

قبل نشر تطبيقك باستخدام حزمة تطوير البرامج (SDK) الخاصة بـ Google Workspace Marketplace، اتّبِع الخطوات التالية:

  1. اختبِر تطبيق Chat من خلال تثبيته من Chat. يُرجى التأكّد من أنّ تطبيقك يعمل بشكل كامل وأنّه ليس قيد التنفيذ.
  2. راجِع متطلبات النشر وتأكَّد من استيفاء تطبيقك لها جميعًا. يمكنك الاطّلاع على مجالات المراجعة.
  3. سجِّل رقم إصدار تطبيقك. ستحتاج إلى هذا الرقم لضبط حزمة تطوير البرامج (SDK) في Google Workspace Marketplace.

عندما تكون مستعدًا للنشر، اطّلِع على المقالة نظرة عامة: نشر تطبيق.