تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

إتاحة مساحة في 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 استهداف شريحة جمهور واحدة بهذا الإذن.
عرض العضوية: استخدِم viewSpaceMembershipSetting لتحديد المستخدمين الذين يمكنهم الاطّلاع على قائمة الأعضاء في مساحة. عند تعديل المستخدمين الذين يمكنهم الاطّلاع على عضوية المساحة، يجب تحديد accessSettings.accessPermissionSettings.viewSpaceMembershipSetting مع permissionSettings.viewSpaceMembership في كل من updateMask ونص الطلب. عند ضبط جمهور مستهدَف في viewSpaceMembershipSetting، يجب منح الإذن viewSpaceMembership لجميع الأعضاء (يجب ضبط managersAllowed وassistantManagersAllowed وmembersAllowed على true).

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

{
  "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" } }
        ]
      },
      "viewSpaceMembershipSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      }
    }
  },
  "permissionSettings": {
    "viewSpaceMembership": {
      "managersAllowed": true,
      "assistantManagersAllowed": true,
      "membersAllowed": true
    }
  }
}

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

للتوافق مع الإصدارات القديمة، استخدِم الحقل `audience`

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

ضبط حقل audience يعادل تحديد الجمهور المستهدَف في joinSpaceSetting:

  "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 تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.