توضّح هذه الصفحة كيفية استخدام 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، يمكنك الاطّلاع على الأدلة التالية: