Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

إتاحة مساحة في Google Chat لمستخدمين محدّدين في مؤسسة Google Workspace

توضّح هذه الصفحة كيفية استخدام Google Chat API لمشاركة مساحة Google Chat مع مستخدمين محدّدين في مؤسسة Google Workspace، كي يتمكّنوا من العثور على المساحة والانضمام إليها.

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

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

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

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

الحصول على رقم تعريف الجمهور المستهدَف

للحصول على معرّف جمهور مستهدَف، اتّبِع الخطوات التالية:

في "وحدة تحكّم المشرف في Google"، انتقِل إلى القائمة > الدليل > الجماهير المستهدفة.

الانتقال إلى "الجماهير المستهدفة"
في جدول الجماهير المستهدفة، انقر على حقل الاسم الخاص بالجمهور المستهدف.
ابحث عن معرّف الجمهور المستهدَف في عنوان URL الخاص بالصفحة. يكون تنسيق عنوان URL كما يلي: https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID، حيث TARGET_AUDIENCE_ID هو المعرّف الأبجدي الرقمي للجمهور المستهدف.

في القسم التالي، يمكنك استخدام رقم تعريف الجمهور المستهدف إما لإنشاء مساحة قابلة للاكتشاف أو لتعديل مساحة حالية وجعلها قابلة للاكتشاف من قِبل الجمهور المستهدف.

تحديد الجماهير المستهدَفة والأذونات الدقيقة

لإنشاء مساحة بأذونات وصول محدّدة، استخدِم الطريقتَين create أو setup في المورد Space. لتعديل أذونات مساحة حالية، استخدِم طريقة update. بما أنّه لا يمكن مشاركة المساحات إلا مع الجماهير المستهدَفة، يجب أن يكون نوع المساحة (الممثّل في الحقل spaceType) هو SPACE.

لتحديد المستخدمين الذين يمكنهم العثور على مساحة أو الانضمام إليها، أدرِج عنصر AccessSettings في مصدر Space. في الكائن، استخدِم الحقل accessPermissionSettings لتحديد إذن واحد أو أكثر من الأذونات التالية:

قابلة للاكتشاف: استخدِم discoverSpaceSetting لتحديد المستخدمين الذين يمكنهم العثور على اسم المساحة ووصفها وتصفّحها في Google Chat. يمكنك تحديد شرائح جمهور مستهدَفة متعددة لاكتشاف المحتوى.
قابلة للانضمام: استخدِم joinSpaceSetting لتحديد المستخدمين الذين يمكنهم الانضمام إلى مساحة بدون دعوة صريحة ومعاينة رسالة المساحة. يجب أن يتمكّن المستخدمون الذين يمكنهم الانضمام إلى مساحة من اكتشافها أيضًا. يتوافق Google Chat مع شريحة جمهور مستهدَفة واحدة لهذا الإذن.

يوضّح المثال التالي كيف يمكنك السماح لجمهورَين مستهدفَين بالعثور على مساحة، والسماح لأحدهما بالانضمام إليها:

  "accessSettings": {
    "accessPermissionSettings": {
      "discoverSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      },
      "joinSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
        ]
      }
    }
  }

استبدِل TARGET_AUDIENCE_ID_1 وTARGET_AUDIENCE_ID_2 برقم تعريف الجمهور المستهدَف الذي حصلت عليه في الحصول على رقم تعريف الجمهور المستهدَف. لاستخدام إعدادات المشاركة التلقائية في مساحة Chat لمؤسستك على Google Workspace، استبدِل default.

للتوافق مع الأنظمة القديمة، استخدِم الحقل `audience`

للتوافق مع الأنظمة القديمة، يمكنك مواصلة استخدام الحقل audience لتحديد جمهور مستهدف واحد يمكنه الانضمام إلى مساحة، ولكن ننصحك بتحديد الجماهير المستهدفة والأذونات الدقيقة بدلاً من ذلك.

يؤدي ضبط الحقل audience إلى تحديد الجمهور المستهدَف في كل من joinSpaceSetting وdiscoverSpaceSetting:

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

استبدِل TARGET_AUDIENCE_ID برقم تعريف الجمهور المستهدَف الذي حصلت عليه في الحصول على رقم تعريف الجمهور المستهدَف. لاستخدام إعدادات المشاركة التلقائية في مساحة Chat لمؤسستك على Google Workspace، استبدِل default.

التعرّف على إعدادات الوصول في ردود واجهة برمجة التطبيقات

عند الحصول على مساحات، يعكس عنصر AccessSettings في الردّ الأذونات الدقيقة المحدّدة للمساحة.

تشير الحقول التالية في AccessSettings إلى إمكانية البحث عن مساحة وأذونات الانضمام إليها:

accessState: مشتقّ من أذونات الاستكشاف (discoverSpaceSetting). إذا تم منح إذن الاستكشاف لشريحة جمهور مستهدَفة واحدة أو أكثر، ستكون قيمة هذا الحقل DISCOVERABLE. في ما عدا ذلك، تكون القيمة PRIVATE.
‫audience: يتم ربط هذا الحقل بشكل خاص بأذونات الانضمام (joinSpaceSetting). إذا تم منح جمهور مستهدف واحد إذن الانضمام، سيحتوي هذا الحقل على اسم المورد الخاص بهذا الجمهور المستهدف.

مساحة قابلة للاكتشاف بدون جمهور للانضمام

قد تكون المساحة قابلة للاكتشاف من قِبل جمهور مستهدَف ولكن لا يمكن الانضمام إليها مباشرةً (على سبيل المثال، إذا كان يجب دعوة المستخدمين صراحةً للانضمام).

في هذه الحالة، يحتوي العنصر AccessSettings على القيم التالية:

accessState: DISCOVERABLE
audience: تم حذفها أو null

إذا رأيت accessState مضبوطًا على DISCOVERABLE ولكن لم يظهر audience، يعني ذلك أنّه يمكن للجمهور المستهدَف المحدّد في discoverSpaceSetting اكتشاف المساحة، ولكن لا يمكن الانضمام إليها إلا من خلال دعوة. لمعرفة شرائح الجمهور المستهدَفة التي يمكنها العثور على المساحة، اطّلِع على حقل accessPermissionSettings.discoverSpaceSetting.

للحصول على تفاصيل حول الجماهير المستهدفة، راجِع الأدلة التالية:

للحصول على تفاصيل حول إنشاء مساحات أو تعديلها باستخدام Chat API، راجِع الأدلة التالية:

إتاحة مساحة في Google Chat لمستخدمين محدّدين في مؤسسة Google Workspace تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.