توضّح هذه الصفحة كيفية استخدام Google Chat API لمشاركة مساحة في Google Chat مع مستخدمين محدّدين في مؤسسة Google Workspace، حتى يتمكّنوا من اكتشاف المساحة والانضمام إليها.
لتحديد المستخدمين في مؤسستك الذين يمكنهم اكتشاف مساحة والانضمام إليها، يمكنك إنشاء شرائح جمهور مستهدفة. الجمهور المستهدَف هو مجموعة من الأشخاص، مثل الأقسام المحدّدة أو المؤسسة بأكملها، يمكنك مشاركة مساحة Chat معهم لتحسين مستوى الوعي بالمساحة و إمكانية مشاركتها. تتيح لك شرائح الجمهور المستهدَفة أيضًا إدارة عضويات المساحة وتخصيصها بدلاً من الحاجة إلى دعوة مستخدمين فرديين إلى مساحة. لمزيد من المعلومات، اطّلِع على لمحة عن شرائح الجمهور المستهدفة.
لا يمكنك جعل المساحات المُسمّاة قابلة للاكتشاف إلا للجماهير المستهدَفة. لا يمكنك مشاركة أنواع المساحات الأخرى، مثل الرسائل المباشرة أو المحادثات الجماعية، مع الجماهير المستهدَفة.
المتطلبات الأساسية
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى 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هو المعرّف الأبجدي الرقمي لجمهورك المستهدَف.
في القسم التالي، يمكنك استخدام رقم تعريف الجمهور المستهدَف لإنشاء مساحة قابلة للاكتشاف أو تعديل مساحة حالية لجعلها قابلة للاكتشاف أمام الجمهور المستهدَف.
تحديد الجمهور المستهدَف في طلب 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، يُرجى الاطّلاع على المراجع التالية: