فضاهای Google Chat را به عنوان سرپرست Google Workspace مدیریت کنید

این صفحه مروری بر نحوه استفاده مدیران Google Workspace از Google Chat API برای مدیریت فضاهای Google Chat در سراسر سازمان خود ارائه می‌دهد.

برای مدیریت فضاهای چت، مدیران Google Workspace می‌توانند از ابزار مدیریت فضا در کنسول مدیریت گوگل استفاده کنند یا Google Chat API را فراخوانی کنند. با استفاده از Chat API، مدیران می‌توانند برنامه‌های Google Chat ایجاد کنند که فضاها را در مقیاس بزرگ مدیریت کرده و وظایف رایج یا تکرارپذیر آنها را خودکار کنند.

مدیران چه کارهایی می‌توانند با Chat API انجام دهند؟

یک مدیر می‌تواند وظایف مدیریتی را بر اساس نقش‌های مدیریتی تعیین‌شده خود انجام دهد.

به عنوان مدیر Google Workspace، می‌توانید تعدادی از وظایف مدیریتی را با Chat API انجام دهید، مانند موارد زیر:

نحوه احراز هویت و مجوزدهی به عنوان مدیر Google Workspace

هنگام استفاده از API چت برای وظایف مدیریتی، مدیران می‌توانند با استناد به امتیازات مدیر یا پیکربندی واگذاری اختیارات در سطح دامنه برای حساب سرویس یک برنامه، درخواست‌ها را تأیید و مجاز کنند.

جدول زیر روش‌های احراز هویت مدیران هنگام استفاده از Chat API را شرح می‌دهد.

احراز هویت کاربر چه کسی متد API را فراخوانی می‌کند؟ آنچه کاربران در چت می‌بینند
امتیازات مدیر مدیر با useAdminAccess=true

«مدیر سازمان [عملی] را انجام داد.»

برای مثال، «مدیر سازمان، کیران بی را به مدیر فضا تغییر داد.»

نام یا شناسه کاربری مدیر یا نام برنامه چت را شناسایی نمی‌کند.

واگذاری اختیار در سطح دامنه حساب کاربری سرویس از طرف یک کاربر

«[کاربر] از طریق [نام برنامه]، [عملی] را انجام داد.»

برای مثال، «ساشا تی نام این فضا را به بحث در مورد پروژه انتشار تغییر داد.»

کاربری که توسط سرویس جعل هویت می‌شود، به عنوان انجام‌دهنده‌ی عمل شناسایی می‌شود.

از API چت برای سازمان خود استفاده کنید

مثال‌های این بخش نشان می‌دهد که مدیران چگونه هنگام مدیریت فضاها و اعضای سازمان خود با امتیازات مدیر، از Chat API استفاده می‌کنند.

متدهای 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 : عضوی از فضا. در رابط کاربری چت، این نقش Member نامیده می‌شود.
  • ROLE_ASSISTANT_MANAGER : یک مدیر فضا. در رابط کاربری چت، این نقش Manager نامیده می‌شود.
  • ROLE_MANAGER : مالک فضا. در رابط کاربری چت، این نقش Owner نامیده می‌شود.

با استفاده از spaces.search در کنار آن، مدیران می‌توانند فضاهایی را که مدیر یا مالک ندارند پیدا کنند و سپس با spaces.members.patch یک عضو موجود را به مدیر یا مالک ارتقا دهند.

پیدا کردن اعضای خارجی یک فضا

با استفاده از spaces.members.list ، مدیران می‌توانند فهرستی از اعضای یک فضا را بازیابی کنند، پروفایل‌های کاربر را از People API یا Directory API سازمان بازیابی کنند و سپس نتایج را برای کسانی که عضو یک دامنه یا سازمان خارجی هستند فیلتر کنند. برای اطلاعات بیشتر، به بخش «چت چگونه کاربران را شناسایی می‌کند» مراجعه کنید.

حسابرسی و مدیریت فضاها

سناریوهای زیر روش‌هایی هستند که شما، به عنوان مدیر Google Workspace، می‌توانید فضاهای موجود در سازمان خود را با استفاده از Chat API حسابرسی و مدیریت کنید.

فضاهای غیرفعال را پیدا و حذف کنید

فضاهای چت بلااستفاده می‌توانند فضای ذخیره‌سازی ارزشمندی را اشغال کنند و باعث ایجاد بی‌نظمی در رابط کاربری شوند. مدیران می‌توانند از spaces.search برای یافتن فضاهای غیرفعال و سپس spaces.delete برای حذف آنها استفاده کنند. برای راهنمایی بیشتر و نمونه کد، به «یافتن و حذف فضاهای چت غیرفعال» مراجعه کنید.

فضاهای حسابرسی در سازمان

با استفاده از spaces.search ، مدیران می‌توانند فهرستی از تمام فضاهای موجود در یک سازمان را به همراه اطلاعات دقیقی در مورد تنظیمات و ابرداده‌های هر فضا مانند تاریخ ایجاد، تاریخ آخرین فعالیت، تعداد اعضا، وضعیت تنظیمات تاریخچه و قابلیت دعوت از مهمانان خارجی بازیابی کنند.

فهرستی از فضاها را بر اساس معیارهای جستجو صادر کنید

با استفاده از spaces.search ، مدیران می‌توانند فهرستی از فضاهایی را که معیارهای مشخص‌شده در query را برآورده می‌کنند، بازیابی کرده و نتایج را برای تجزیه و تحلیل به یک فایل CSV صادر کنند.

یافتن اعضای یک فضا بر اساس معیارهای جستجو

با استفاده از spaces.members.list ، مدیران می‌توانند فهرستی از اعضا را برای هر فضایی در سازمان بازیابی کرده و نتایج را برای معیارهای خاص تجزیه و تحلیل کنند.

مدیران یک فضا را پیدا کنید

با استفاده از spaces.members.list ، مدیران می‌توانند فهرستی از اعضای یک فضا را که به MembershipState=ROLE_MANAGER فیلتر شده است، بازیابی کنند.

برای یافتن همه مدیران فضا در سازمان خود، در تمام فضاها، می‌توانید spaces.search برای فهرست کردن همه آنها استفاده کنید. سپس برای هر فضا در لیست، از spaces.members.list برای بازیابی مدیران استفاده کنید.