این صفحه یک نمای کلی از نحوه استفاده مدیران Google Workspace از Google Chat API برای مدیریت فضاهای Google Chat در سراسر سازمان خود ارائه می دهد.
برای مدیریت فضاهای گپ، مدیران Google Workspace می‌توانند از ابزار مدیریت فضا در کنسول مدیریت Google استفاده کنند یا با Google Chat API تماس بگیرند. با استفاده از Chat API، سرپرستان می‌توانند برنامه‌های Google Chat را ایجاد کنند که فضاها را در مقیاس مدیریت می‌کند و وظایف مشترک یا تکرارپذیر آنها را خودکار می‌کند.
آنچه مدیران می توانند با Chat API انجام دهند
یک مدیر می تواند وظایف مدیریتی را بر اساس نقش های مدیر اختصاص داده شده خود انجام دهد.
به عنوان یک سرپرست Google Workspace، می‌توانید تعدادی از وظایف مدیریتی را با Chat API انجام دهید، مانند موارد زیر:
- فضاها را بر اساس معیارهای مشخص شده جستجو کنید
- اعضای یک فضا را فهرست کنید
- اعضا را به یک فضا اضافه کنید و اعضا را از آن حذف کنید
- جزئیات مربوط به یک عضو و یک فضا را دریافت کنید
- یک فاصله را به روز کنید یا حذف کنید
- عضویت کاربر را به روز کنید
نحوه احراز هویت و مجوز به عنوان سرپرست Google Workspace
هنگام استفاده از Chat API برای وظایف مدیریتی، مدیران می‌توانند درخواست‌ها را با فراخوانی امتیازات سرپرست یا پیکربندی تفویض اختیار در سطح دامنه برای حساب سرویس یک برنامه تأیید و تأیید کنند.
جدول زیر روش‌هایی را که مدیران می‌توانند هنگام استفاده از Chat API احراز هویت کنند، توضیح می‌دهد.
| احراز هویت کاربر | چه کسی متد API را فراخوانی می کند | آنچه کاربران در چت می بینند |
|---|---|---|
| امتیازات مدیر | مدیر با useAdminAccess=true | «مدیر سازمان [اقدامی] را انجام داد». به عنوان مثال، "مدیر سازمان Kiran B را به مدیر فضایی تغییر داد." نام کاربر سرپرست یا شناسه کاربری یا نام برنامه چت را مشخص نمی کند. |
| تفویض اختیار در دامنه | حساب سرویس از طرف یک کاربر | "[کاربر] [یک عمل] را از طریق [نام برنامه] انجام داد." به عنوان مثال، "Sasha T فضا را به Release Project Discussion تغییر نام داد." کاربری که توسط سرویس جعل هویت می‌شود، به‌عنوان انجام این عمل شناسایی می‌شود. |
از 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() ، ادمین ها می توانند فضاهایی را پیدا کنند که مدیر ندارند و سپس با spaces.members.patch() یک عضو موجود را به ROLE_MANAGER ارتقا دهند.
اعضای خارجی یک فضا را پیدا کنید
با استفاده از 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 برای بازیابی مدیران استفاده کنید.
موضوعات مرتبط
- احراز هویت و مجوز با استفاده از امتیازات مدیر
- فضاهای Google Chat را با Google Chat API به عنوان سرپرست Google Workspace جستجو و مدیریت کنید
- متد
spaces.search()