إدارة مساحات Google Chat كمشرف في Google Workspace

تقدّم هذه الصفحة نظرة عامة حول كيفية استخدام مشرفي 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.

إدارة عضويات المستخدمين في المساحات

في ما يلي سيناريوهات يمكنك من خلالها، بصفتك مشرفًا في Google Workspace، إدارة عضوية المستخدمين في المساحة داخل مؤسستك باستخدام Chat API.

إضافة مستخدمين إلى المساحات

باستخدام spaces.members.create، يمكن للمشرفين إضافة مستخدم إلى أي مساحة في مؤسسة.

عند استخدامها مع spaces.search، يمكن للمشرفين إضافة مستخدم إلى مجموعة من المساحات يحدّدها طلب البحث. ويمكن أن يكون ذلك مفيدًا عند إعداد موظفين جدد في مؤسسة، إذ يتيح للمشرفين إتمام عملية روتينية بشكل آلي.

العثور على المستخدمين وإزالتهم من المساحات

باستخدام spaces.members.get، يمكن للمشرفين تحديد ما إذا كان المستخدم (داخليًا أو خارجيًا للمؤسسة) عضوًا في أي مساحة في المؤسسة.

عند استخدامها مع spaces.search، يمكن للمشرفين العثور على جميع المساحات التي يكون المستخدم عضوًا فيها ثم إزالته من المساحات باستخدام spaces.members.delete. يمكن أن يكون ذلك مفيدًا عندما ينتقل الموظفون إلى فرق أخرى داخل المؤسسة أو عند إيقاف حسابات الموظفين الذين لم يعودوا يعملون في المؤسسة، إذ يتيح ذلك للمشرفين أتمتة عملية روتينية.

ترقية المستخدمين إلى دور مدير مساحة

باستخدام spaces.members.patch، يمكن للمشرفين تغيير دور أحد الأعضاء من خلال تعديل MembershipRole بين الخيارات التالية:

  • ROLE_MEMBER: عضو في المساحة في واجهة مستخدم Chat، يُطلق على هذا الدور اسم عضو.
  • ROLE_ASSISTANT_MANAGER: مدير مساحة في واجهة مستخدم Chat، يُطلق على هذا الدور اسم المشرف.
  • ROLE_MANAGER: مالك مساحة في واجهة مستخدم "المحادثة"، يُطلق على هذا الدور اسم المالك.

بالاقتران مع spaces.search، يمكن للمشرفين العثور على المساحات التي ليس لديها مدير أو مالك، ثم ترقية أحد الأعضاء الحاليين إلى مدير أو مالك باستخدام 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 لاسترداد المدراء.