تقدّم هذه الصفحة نظرة عامة على كيفية استخدام مشرفي 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
|
"نفَّذ مشرف المؤسسة [إجراءً]." على سبيل المثال، "غيّر مشرف المؤسسة دور "كيران ب" إلى مدير مساحة". ولا يحدّد هذا المعرّف اسم المستخدم المشرف أو رقم تعريفه أو اسم تطبيق 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() ل listing
جميعهم. بعد ذلك، استخدِم spaces.members.list في كل مساحة من القائمة ل retrieving the managers.
مواضيع ذات صلة
- المصادقة والاعتماد باستخدام امتيازات المشرف
- البحث في مساحات Google Chat وإدارتها باستخدام Google Chat API بصفتك مشرفًا في Google Workspace
- طريقة
spaces.search()