هل يمكنك تخصيص 5 دقائق من وقتك؟ يمكنك مساعدتنا في تحسين مستندات مطوّري برامج Google Chat من خلال المشاركة في استطلاع سريع.

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

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

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

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

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

لبدء استخدام تطبيق، يمكن لمستخدمي Google Chat بدء رسالة مباشرة مع التطبيق أو إضافتها إلى مساحة. يمكن للمستخدمين أيضًا إضافة التطبيق من خلال الإشارة إليه باستخدام @. يوضِّح المثال التالي كيف يشير المستخدم @ إلى تطبيق 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 Console وتفعيل 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 لتنفيذ ما يلي:

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

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

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

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

إيقاف تطبيق Chat

بعد حفظ صفحة الضبط، سيظهر حقل "حالة التطبيق". ويتيح لك هذا الحقل التحكم في ما إذا كان التطبيق مباشر أو غير مفعَّل.

لإيقاف تطبيق Chat:

  1. افتَح Google Cloud Console.
  2. إذا لزم الأمر، اختَر مشروع Google Cloud الذي يستضيف تطبيق Chat:
    1. بجانب "Google Cloud"، انقر على السهم المتّجه للأسفل . يظهر مربع حوار يسرد المشروعات الحالية.
    2. اختَر المشروع الذي يستضيف تطبيق Chat الذي تم نقله.
    3. انقر على فتح.
  3. ابحث عن "Google Chat API" وانقر على Google Chat API.
  4. انقر على إدارة.
  5. انقر على الإعداد.
  6. في القسم "حالة التطبيق"، اختَر غير مُفعَّل.
  7. انقر على حفظ.