توضّح هذه الصفحة كيفية استخدام Google Chat API لمشاركة مساحة في Google Chat. مع مستخدمين محدّدين في مؤسسة Google Workspace، ليتمكّنوا من الفضاء الخارجي والانضمام إليها.
لتحديد المستخدمين الذين يمكنهم اكتشاف مساحة والانضمام إليها في مؤسستك، في إنشاء الجماهير المستهدفة. الجمهور المستهدف هو مجموعة من الأشخاص، مثل أقسام معينة أو المؤسسة بأكملها - فيمكنك مشاركة مساحة Chat مع زيادة الوعي بالمساحة والقابلية للمشاركة. تتيح لك أيضًا الجماهير المستهدفة إدارة المساحة وتخصيصها بدلاً من الحاجة إلى دعوة مستخدمين فرديين إلى مساحة. لمزيد من المعلومات، لمزيد من المعلومات، يُرجى الاطّلاع على لمحة عن الهدف الجماهير.
يمكنك إتاحة المساحات المُعنونة للجماهير المستهدفة فقط. لا يمكنك مشاركة أنواع المساحات الأخرى، مثل الرسائل المباشرة أو المحادثات الجماعية، مع الجماهير المستهدفة.
المتطلبات الأساسية
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat يجب أن يتضمن الحساب المشرف المتميز الدور لمؤسستك على Google Workspace.
- جمهور مستهدف متاح للوصول إليه في Chat. إلى إنشاء جمهور مستهدف، راجع إنشاء هدف جمهورك. لإنشاء قائمة حالية الجمهور المستهدف المتاح لمساحات Chat، يمكنك الاطّلاع على إعداد إمكانية الوصول إلى المساحة لتطبيق Chat
الحصول على رقم تعريف الجمهور المستهدف
للحصول على رقم تعريف جمهور مستهدف، اتّبِع الخطوات التالية:
في "وحدة تحكُّم المشرف في Google"، انتقِل إلى قائمة الطعام > الدليل > الجماهير المستهدفة.
في جدول الجماهير المستهدفة، انقر على الحقل الاسم في الاستهداف. جمهورك.
ابحث عن رقم تعريف الجمهور المستهدف في عنوان URL للصفحة. تنسيق عنوان URL هو
https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, حيثTARGET_AUDIENCE_IDهو المعرّف الأبجدي الرقمي جمهورك المستهدف.
في القسم التالي، يمكنك استخدام معرّف الجمهور المستهدف لإنشاء مساحة قابلة للاكتشاف أو تعديل مساحة حالية لجعلها قابلة للاكتشاف من الجمهور المستهدف.
تحديد الجمهور المستهدف في طلب Chat API
لإنشاء مساحة لجمهور مستهدَف محدّد، استخدِم create() أو
setup() على المورد Space. لإنشاء مساحة حالية
قابلة للاكتشاف، يمكنك استخدام الطريقة update() في مورد Space. لأن فقط
يمكن مشاركة المساحات المُسمّاة مع الجماهير المستهدفة، ونوع المساحة
(ممثلة في الحقل spaceType) يجب أن تكون SPACE.
لإتاحة مساحة قابلة للاكتشاف لدى جمهورك المستهدَف، يجب تضمين
AccessSettings
في مورد Space كجزء من طلب Chat API. ضِمن
الكائن، حدِّد الحقل audience:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
استبدال TARGET_AUDIENCE_ID برقم تعريف الهدف
الذي حصلت عليه في القسم السابق. لاستخدام الإعداد التلقائي
إعدادات مشاركة مساحة Chat في Google Workspace
المؤسسة، يُرجى استبدالها بـ default.
للحصول على تفاصيل عن إنشاء المساحات أو تعديلها باستخدام Chat API، يُرجى الاطّلاع على الأدلة التالية: