Quản lý phòng Google Chat trong vai trò quản trị viên Google Workspace

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 Google Chat trong tổ chức của họ.

Để quản lý không gian 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 API Google Chat. Bằng cách sử 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 gặp hoặc lặp lại.

Những việc quản trị viên có thể làm với API Chat

Quản trị viên có thể thực hiện các nhiệm 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ư:

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 quyền quản trị 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 ứng dụng.

Bảng sau đây mô tả các cách 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 Ai 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".

Mã này không xác định tên hoặc mã nhận dạng người dùng của quản trị viên hoặc tên của ứng dụng Chat.
Ủy 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 đang bị dịch vụ 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ý không gian và thành viên của tổ chức bằng quyền quản trị.

Các phương thức Chat API sau đây cho phép đặc quyền quản trị viên bằng useAdminAccess=true.

Quản lý gói thành viên của người dùng trong không gian

Là quản trị viên Google Workspace, bạn có thể quản lý tư cách thành viên của người dùng trong tổ chức bằng Chat API theo các tình huống sau.

Thêm người dùng vào không gian

Khi 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 cho một tổ chức; cho phép quản trị viên tự động hoá một quy trình định kỳ.

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 một người dùng (trong hoặc ngoài tổ chức) có phải là thành viên của bất kỳ không gian nào trong tổ chức hay không.

Khi sử dụng cùng với spaces.search(), quản trị viên có thể tìm thấy tất cả không gian mà người dùng là thành viên, sau đó xoá họ 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 nhóm trong một tổ chức hoặc rời khỏi 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 định kỳ.

Chuyển 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ể sử dụng spaces.members.patch() để di chuyển thành viên từ ROLE_MANAGER sang ROLE_MEMBER.

Khi sử dụng cùng với spaces.search(), quản trị viên có thể tìm 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 phần Cách Chat nhận dạng người dùng.

Kiểm tra và quản lý không gian

Là quản trị viên Google Workspace, bạn 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 theo các tình huống sau.

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 dụng dung lượng lưu trữ quý giá và tạo ra sự 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 đó sử dụng spaces.delete() để xoá các không gian đó. Để được hướng dẫn thêm và xem mã mẫu, hãy xem phần Tìm và xoá các 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ả không gian trong một tổ chức, trong đó có 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 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 không gian đáp ứng các 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 không gian dựa trên tiêu chí tìm kiếm

Khi sử dụng spaces.members.list(), quản trị viên có thể truy xuất danh sách thành viên cho bất kỳ không gian nào trong tổ chức và phân tích kết quả theo các tiêu chí cụ thể.

Tìm người quản lý 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 thành 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ả không gian, bạn có thể sử dụng spaces.search() để liệt kê tất cả người quản lý không gian. Sau đó, đối với mỗi không gian trong danh sách, hãy sử dụng spaces.members.list để truy xuất các trình quản lý.