تقدّم هذه الصفحة نظرة عامة حول كيفية استخدام مشرفي Google Workspace لواجهة برمجة التطبيقات Google Chat API لإدارة مساحات Google Chat في مؤسساتهم.
لإدارة مساحات Chat، يمكن لمشرفي Google Workspace استخدام أداة إدارة المساحات في "وحدة تحكّم المشرف في Google" أو الاتصال بواجهة برمجة التطبيقات Google Chat API. باستخدام Chat API، يمكن للمشرفين إنشاء تطبيقات Google Chat تدير المساحات على نطاق واسع وتبرمج المهام الشائعة أو المتكررة.
الإجراءات التي يمكن للمشرفين اتّخاذها باستخدام Chat API
يمكن للمشرف تنفيذ مهام الإدارة استنادًا إلى أدوار المشرفين المعيّنة.
بصفتك مشرفًا في Google Workspace، يمكنك تنفيذ عدد من مهام الإدارة باستخدام Chat API، مثل ما يلي:
- البحث في المساحات استنادًا إلى معايير محدّدة
- عرض قائمة بأعضاء مساحة
- إضافة أعضاء وإزالة أعضاء من مساحة
- الحصول على تفاصيل حول عضو ومساحة
- تعديل مساحة أو حذفها
- تعديل اشتراك مستخدم
كيفية المصادقة والتفويض بصفتك مشرف Google Workspace
عند استخدام Chat API لإجراء مهام إدارية، يمكن للمشرفين مصادقة الطلبات ومنحها الإذن من خلال تفعيل امتيازات المشرف أو إعداد تفويض على مستوى النطاق للحساب الخدمي الخاص بأحد التطبيقات.
يوضّح الجدول التالي الطرق التي يمكن للمشرفين استخدامها للمصادقة عند استخدام Chat API.
| مصادقة المستخدم | المستخدم الذي يستدعي طريقة واجهة برمجة التطبيقات | ما يظهر للمستخدمين في Chat |
|---|---|---|
| امتيازات المشرف | المشرف الذي لديه useAdminAccess=true
|
"نفَّذ مشرف المؤسسة [إجراء]." على سبيل المثال، "غيّر مشرف المؤسسة دور Kiran B إلى مدير مساحة". ولا تحدّد اسم مستخدم المشرف أو رقم تعريفه أو اسم تطبيق Chat. |
| التفويض على مستوى النطاق | حساب الخدمة نيابةً عن مستخدم |
"نفّذ [المستخدم] [إجراء] من خلال [اسم التطبيق]". على سبيل المثال، "أعادت ساشا تسمية المساحة إلى مناقشة مشروع الإصدار". يتم تحديد المستخدم الذي ينتحل الخدمة هويته على أنّه نفّذ الإجراء. |
استخدام Chat API في مؤسستك
توضّح الأمثلة الواردة في هذا القسم كيفية استخدام المشرفين لواجهة برمجة التطبيقات Chat API عند إدارة مساحات مؤسستهم وأعضائها باستخدام امتيازات المشرف.
تتيح طرق Chat API التالية امتيازات المشرف باستخدام
useAdminAccess=true.
spaces.delete()spaces.get()spaces.patch()spaces.search()spaces.members.create()spaces.members.delete()spaces.members.get()spaces.members.list()spaces.members.patch()
إدارة عضويات المستخدمين في المساحات
في ما يلي سيناريوهات يمكنك من خلالها، بصفتك مشرفًا في Google Workspace، إدارة عضوية المستخدمين في المساحات ضمن مؤسستك باستخدام Chat API.
إضافة مستخدمين إلى المساحات
باستخدام spaces.members.create()، يمكن للمشرفين إضافة مستخدم إلى أي مساحة في مؤسسة.
عند استخدامها مع spaces.search()،
يمكن للمشرفين إضافة مستخدم إلى مجموعة من المساحات يحدّدها طلب البحث. ويمكن أن يكون ذلك مفيدًا عند إعداد الموظفين الجدد في المؤسسة، إذ يتيح للمشرفين إتمام عملية روتينية بشكل آلي.
العثور على المستخدمين وإزالتهم من المساحات
باستخدام spaces.members.get()، يمكن للمشرفين تحديد ما إذا كان المستخدم (داخليًا أو خارجيًا للمؤسسة) عضوًا في أي مساحة في المؤسسة.
عند استخدامها مع spaces.search()،
يمكن للمشرفين العثور على جميع المساحات التي يكون المستخدم عضوًا فيها ثم إزالته
من المساحات باستخدام
spaces.members.delete().
يمكن أن يكون ذلك مفيدًا عندما ينتقل الموظفون إلى فرق أخرى داخل المؤسسة أو عند إيقاف حسابات الموظفين الذين لم يعودوا يعملون في المؤسسة، إذ يتيح للمشرفين إمكانية التشغيل التلقائي لعملية روتينية.
ترقية المستخدمين إلى مدير مساحة
باستخدام spaces.members.patch()،
يمكن للمشرفين ترقية أعضاء المساحة من ROLE_MEMBER إلى ROLE_MANAGER.
يمكن للمشرفين أيضًا استخدام spaces.members.patch() لنقل الأعضاء من ROLE_MANAGER إلى ROLE_MEMBER.
عند استخدامها مع spaces.search()،
يمكن للمشرفين العثور على المساحات التي ليس لديها مدير، ثم ترقية أحد الأعضاء الحاليين إلى دور ROLE_MANAGER باستخدام spaces.members.patch().
البحث عن أعضاء خارجيين في مساحة
باستخدام spaces.members.list()،
يمكن للمشرفين استرداد قائمة بالأعضاء في مساحة، واسترداد الملفات الشخصية للمستخدمين
من واجهة برمجة التطبيقات People API أو Directory API الخاصة بالمؤسسة، ثم فلترة
النتائج للأعضاء في نطاق أو مؤسسة خارجيين.
لمزيد من المعلومات، يُرجى الاطّلاع على كيفية تحديد هوية المستخدمين في المحادثة.
التدقيق في المساحات وإدارتها
في ما يلي سيناريوهات يمكنك من خلالها، بصفتك مشرفًا في Google Workspace، تدقيق المساحات وإدارتها في مؤسستك باستخدام Chat API.
العثور على المساحات غير النشطة وحذفها
يمكن أن تشغل مساحات Chat غير المستخدَمة مساحة تخزين قيّمة وتتسبّب في حدوث فوضى في واجهة المستخدم. يمكن للمشرفين استخدام
spaces.search()
للعثور على المساحات غير النشطة، ثم استخدام
spaces.delete()
لحذفها. للحصول على مزيد من الإرشادات ونموذج للرمز، يُرجى الاطّلاع على مقالة
العثور على مساحات Chat غير النشطة وحذفها.
تدقيق المساحات في المؤسسة
باستخدام spaces.search()، يمكن للمشرفين استرداد قائمة بجميع المساحات في مؤسسة تتضمّن معلومات تفصيلية حول إعدادات كل مساحة وبياناتها الوصفية، مثل تاريخ الإنشاء وتاريخ آخر نشاط وعدد الأعضاء وحالة إعداد سجلّ المحادثات وإمكانية دعوة ضيوف خارجيين.
تصدير قائمة بالمساحات استنادًا إلى معايير البحث
باستخدام spaces.search()،
يمكن للمشرفين استرداد قائمة بالمساحات التي تستوفي المعايير المحدّدة في
query
وتصدير النتائج إلى ملف CSV لتحليلها.
العثور على أعضاء في مساحة استنادًا إلى معايير البحث
باستخدام spaces.members.list()،
يمكن للمشرفين استرداد قائمة بالأعضاء في أي مساحة ضمن المؤسسة
وتحليل النتائج وفقًا لمعايير معيّنة.
الاطّلاع على مدراء مساحة
باستخدام spaces.members.list()،
يمكن للمشرفين استرداد قائمة بأعضاء مساحة معيّنة تم فلترتها لتشمل MembershipState=ROLE_MANAGER.
للعثور على جميع مديري المساحات في مؤسستك، في جميع المساحات، يمكنك استخدام spaces.search() لإدراجهم جميعًا. بعد ذلك، استخدِم spaces.members.list لكل مساحة في القائمة لاسترداد المدراء.
مواضيع ذات صلة
- المصادقة والترخيص باستخدام امتيازات المشرف
- البحث عن مساحات Google Chat وإدارتها باستخدام Google Chat API بصفتك مشرف Google Workspace
- طريقة
spaces.search()