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