توضِّح هذه الصفحة كيفية استخدام Google Chat API لمشاركة مساحة Google Chat مع مستخدمين محدّدين في مؤسسة Google Workspace، ما يتيح لهم العثور على المساحة والانضمام إليها.
لتحديد المستخدمين في مؤسستك الذين يمكنهم العثور على مساحة والانضمام إليها، يمكنك إنشاء جماهير مستهدَفة. الجمهور المستهدَف هو مجموعة من الأشخاص، مثل أقسام محدّدة أو المؤسسة بأكملها، يمكنك مشاركة مساحة Chat معها لتحسين الوعي بالمساحة وإمكانية مشاركتها. تتيح لك الجماهير المستهدَفة أيضًا إدارة عضويات المساحات وتخصيصها بدلاً من الحاجة إلى دعوة مستخدمين فرديين إلى مساحة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة لمحة عن الجماهير المستهدَفة.
لا يمكنك إتاحة المساحات التي تحمل اسمًا للاكتشاف إلا للجماهير المستهدَفة. لا يمكنك مشاركة أنواع المساحات الأخرى، مثل الرسائل المباشرة أو المحادثات الجماعية، مع الجماهير المستهدَفة.
المتطلبات الأساسية
- حساب Business أو Enterprise على 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() في المصدر Space. بما أنّه لا يمكن مشاركة المساحات التي تحمل اسمًا فقط مع الجماهير المستهدَفة، يجب أن يكون نوع المساحة (الممثَّل في الحقل spaceType) هو SPACE.
لإتاحة مساحة للاكتشاف من قِبل جمهورك المستهدَف، ضِّمّن الـ
AccessSettings
عنصر في الـSpace مورد كجزء من طلب بيانات من واجهة برمجة التطبيقات لـ Chat. في العنصر، حدِّد حقل audience:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
استبدِل TARGET_AUDIENCE_ID برقم تعريف الجمهور المستهدَف الذي حصلت عليه في القسم السابق. لاستخدام إعدادات مشاركة مساحة Chat التلقائية لمؤسسة Google Workspace، استبدِلها بـ default.
للحصول على تفاصيل عن إنشاء المساحات أو تعديلها باستخدام Chat API، يُرجى الاطّلاع على الأدلة التالية: