Trang này cung cấp thông tin tổng quan về cách quản trị viên Google Workspace có thể sử dụng Google Chat API để quản lý các không gian trên Google Chat trong tổ chức của họ.
Để quản lý không gian trong Chat, quản trị viên Google Workspace có thể sử dụng Công cụ quản lý không gian trong Bảng điều khiển dành cho quản trị viên của Google hoặc gọi Google Chat API. Khi dùng Chat API, quản trị viên có thể tạo các ứng dụng Google Chat để quản lý không gian ở quy mô lớn và tự động hoá các công việc thường xuyên hoặc có thể lặp lại.
Những việc mà quản trị viên có thể làm với Chat API
Quản trị viên có thể thực hiện các tác vụ quản lý dựa trên vai trò quản trị viên được chỉ định.
Là quản trị viên Google Workspace, bạn có thể thực hiện một số tác vụ quản lý bằng Chat API, chẳng hạn như:
- Tìm kiếm không gian dựa trên tiêu chí đã chỉ định
- Liệt kê các thành viên của một không gian
- Thêm thành viên vào và xoá thành viên khỏi một không gian
- Xem thông tin chi tiết về thành viên và không gian
- Cập nhật hoặc xoá một không gian
- Cập nhật gói thành viên của người dùng
Cách xác thực và uỷ quyền với tư cách là quản trị viên Google Workspace
Khi sử dụng Chat API cho các tác vụ quản lý, quản trị viên có thể xác thực và uỷ quyền các yêu cầu bằng cách gọi đặc quyền quản trị viên hoặc định cấu hình uỷ quyền trên toàn miền cho tài khoản dịch vụ của một ứng dụng.
Bảng sau đây mô tả những cách mà quản trị viên có thể xác thực khi sử dụng Chat API.
| Xác thực người dùng | Người gọi phương thức API | Nội dung mà người dùng nhìn thấy trong Chat |
|---|---|---|
| Đặc quyền của quản trị viên | Quản trị viên có useAdminAccess=true
|
"Quản trị viên của tổ chức đã thực hiện [một hành động]." Ví dụ: "Quản trị viên của tổ chức đã thay đổi vai trò của Kiran B thành người quản lý không gian". Thông tin này không xác định tên hoặc mã nhận dạng người dùng của người dùng quản trị viên hoặc tên của ứng dụng Chat. |
| Uỷ quyền trên toàn miền | Tài khoản dịch vụ thay mặt cho người dùng |
"[Người dùng] đã thực hiện [một hành động] thông qua [tên ứng dụng]." Ví dụ: "Sasha T đã đổi tên không gian thành Thảo luận về dự án phát hành". Người dùng mà dịch vụ đang mạo danh được xác định là đã thực hiện hành động. |
Sử dụng API Chat cho tổ chức của bạn
Các ví dụ trong phần này minh hoạ cách quản trị viên sử dụng Chat API khi quản lý các không gian và thành viên trong tổ chức của họ bằng đặc quyền quản trị viên.
Các phương thức Chat API sau đây cho phép đặc quyền quản trị bằng 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()
Quản lý tư cách thành viên không gian của người dùng
Sau đây là những trường hợp mà bạn (với tư cách là quản trị viên Google Workspace) có thể quản lý tư cách thành viên không gian của người dùng trong tổ chức bằng Chat API.
Thêm người dùng vào không gian
Bằng cách sử dụng spaces.members.create(), quản trị viên có thể thêm người dùng vào bất kỳ không gian nào trong tổ chức.
Khi sử dụng cùng với spaces.search(), quản trị viên có thể thêm người dùng vào một nhóm không gian do cụm từ tìm kiếm của họ xác định. Điều này có thể hữu ích khi giới thiệu nhân viên mới vào một tổ chức; tính năng này cho phép quản trị viên tự động hoá một quy trình thường xuyên.
Tìm người dùng và xoá họ khỏi không gian
Khi sử dụng spaces.members.get(), quản trị viên có thể xác định xem người dùng (trong hay ngoài tổ chức) có phải là thành viên của không gian nào trong tổ chức hay không.
Khi dùng cùng với spaces.search(), quản trị viên có thể tìm thấy tất cả các không gian mà người dùng là thành viên, sau đó xoá người dùng khỏi các không gian bằng spaces.members.delete().
Điều này có thể hữu ích khi nhân viên chuyển đổi giữa các nhóm trong một tổ chức hoặc khi nhân viên không còn làm việc cho tổ chức nữa; tính năng này cho phép quản trị viên tự động hoá một quy trình thường xuyên.
Thăng cấp người dùng lên vai trò người quản lý không gian
Khi sử dụng spaces.members.patch(), quản trị viên có thể thăng cấp thành viên của một không gian từ ROLE_MEMBER lên ROLE_MANAGER.
Quản trị viên cũng có thể dùng biểu tượng spaces.members.patch() để di chuyển thành viên từ ROLE_MANAGER sang ROLE_MEMBER.
Khi dùng cùng với spaces.search(), quản trị viên có thể tìm thấy những không gian không có người quản lý, sau đó thăng cấp một thành viên hiện tại lên ROLE_MANAGER bằng spaces.members.patch().
Tìm thành viên bên ngoài của một không gian
Khi sử dụng spaces.members.list(), quản trị viên có thể truy xuất danh sách thành viên trong một không gian, truy xuất hồ sơ người dùng từ People API hoặc Directory API của tổ chức, sau đó lọc kết quả cho những người là thành viên của một miền hoặc tổ chức bên ngoài.
Để biết thêm thông tin, hãy xem bài viết Cách Chat nhận dạng người dùng.
Kiểm tra và quản lý không gian
Sau đây là những trường hợp mà bạn (với tư cách là quản trị viên Google Workspace) có thể kiểm tra và quản lý các không gian trong tổ chức của mình bằng Chat API.
Tìm và xoá không gian không hoạt động
Các không gian Chat không dùng đến có thể chiếm dung lượng lưu trữ quý giá và gây ra tình trạng lộn xộn trong giao diện người dùng. Quản trị viên có thể sử dụng spaces.search() để tìm các không gian không hoạt động, sau đó dùng spaces.delete() để xoá các không gian đó. Để biết thêm hướng dẫn và mã mẫu, hãy xem bài viết Tìm và xoá không gian Chat không hoạt động.
Kiểm tra không gian trong tổ chức
Khi sử dụng spaces.search(), quản trị viên có thể truy xuất danh sách tất cả các không gian trong một tổ chức cùng với thông tin chi tiết về chế độ cài đặt và siêu dữ liệu của từng không gian, chẳng hạn như ngày tạo, ngày hoạt động gần đây nhất, số lượng thành viên, trạng thái của chế độ cài đặt nhật ký và khả năng mời khách bên ngoài.
Xuất danh sách các không gian dựa trên tiêu chí tìm kiếm
Khi sử dụng spaces.search(), quản trị viên có thể truy xuất danh sách các không gian đáp ứng tiêu chí được chỉ định trong query và xuất kết quả sang tệp CSV để phân tích.
Tìm thành viên của một không gian dựa trên tiêu chí tìm kiếm
Bằng cách sử dụng spaces.members.list(), quản trị viên có thể truy xuất danh sách thành viên của bất kỳ không gian nào trong tổ chức và phân tích kết quả theo tiêu chí cụ thể.
Tìm người quản lý của một không gian
Khi sử dụng spaces.members.list(), quản trị viên có thể truy xuất danh sách thành viên của một không gian được lọc theo MembershipState=ROLE_MANAGER.
Để tìm tất cả người quản lý không gian trong tổ chức của bạn trên tất cả các không gian, bạn có thể sử dụng spaces.search() để liệt kê tất cả. Sau đó, đối với mỗi khoảng trống trong danh sách, hãy dùng spaces.members.list để truy xuất các trình quản lý.
Chủ đề có liên quan
- Xác thực và uỷ quyền bằng đặc quyền của quản trị viên
- Tìm kiếm và quản lý không gian trong Google Chat bằng Google Chat API với tư cách là quản trị viên Google Workspace
- Phương thức
spaces.search()