بعد إنشاء تطبيق 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 وإتاحته للآخرين، عليك بشكل عام اتّباع الخطوات التالية:
- تفعيل Google Chat API وضبطها من خلال ضبط واجهة برمجة التطبيقات، أنت تمنح مستخدمي Google Chat الآخرين الإذن بالوصول إلى تطبيق Chat للاختبار.
- انشر تطبيقك باستخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace. يمكنك ضبط تطبيق Chat ليكون متاحًا للمستخدمين في مؤسسة Google Workspace أو لجميع مستخدمي Google Chat.
- إذا كانت مؤسستك على 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 Console وتفعيل Google Chat API:
- استخدِم الزر أدناه لإنشاء مشروع جديد (أو اختَر مشروعًا حاليًا) وأضِف حساب خدمة إليه. امنح حساب الخدمة دور مالك المشروع.
تفعيل واجهة برمجة التطبيقات - احفظ مفتاح JSON الذي تم تنزيله. يمكن لتطبيقك استخدام هذا المفتاح لمصادقة الرسائل التي يرسلها إلى المساحات بشكلٍ غير متزامن.
- افتح مشروعك في . في قائمة واجهات برمجة التطبيقات، انقر على Google Chat API.
- حدد علامة التبويب الضبط وأدخل معلومات التطبيق، كما هو موضح في الجدول التالي.
عند حفظ إعدادات التطبيق، يصبح تطبيقك متاحًا للمستخدمين المحدَّدين في مؤسستك على Google Workspace.
إعدادات ضبط Google Chat API
| الحقل | الوصف |
|---|---|
| اسم التطبيق | الاسم الذي يستخدمه المستخدمون عند التفاعل مع تطبيق Chat. |
| عنوان URL للصورة الرمزية | عنوان URL يستخدم HTTPS يشير إلى صورة ذات رسومات مربّعة (مثل PNG أو JPEG)، لا يقل حجمها عن 128x128، وستظهر كصورة رمزية لتطبيق Chat. |
| الوصف | وصف لوظيفة تطبيق Chat يظهر أسفل اسم تطبيق Chat |
| الوظائف | مجموعة من الحقول التي تحدِّد كيفية تفاعل تطبيق Chat مع المستخدمين:
|
| إعدادات الربط | نقطة النهاية لتطبيق 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، يُرجى اتّباع الخطوات التالية:
- اختبِر تطبيق Chat من خلال تثبيته من Chat. تأكَّد من أنّ تطبيقك يعمل بشكل كامل وأنّه ليس قيد التنفيذ.
- عليك مراجعة متطلبات النشر والتأكّد من أنّ تطبيقك يفي بها جميعًا. يمكنك الاطّلاع على الجوانب من المراجعة.
- سجِّل رقم إصدار تطبيقك، وستحتاج إلى هذا الرقم لإعداد حزمة تطوير البرامج (SDK) في Google Workspace Marketplace.
وعندما تكون مستعدًا للنشر، يُرجى الاطّلاع على نظرة عامة: نشر تطبيق.