Không gian họp đại diện cho một địa điểm ảo hoặc một đối tượng ổn định (chẳng hạn như phòng họp) nơi tổ chức hội nghị. Không gian họp cũng giúp người dùng gặp gỡ và tìm thấy tài nguyên dùng chung.
Khi bạn tạo không gian họp bằng phương thức spaces.create, phương thức này sẽ trả về một thực thể của tài nguyên spaces. Tài nguyên này bao gồm đối tượng SpaceConfig là cấu hình cho không gian họp. Tệp này cũng chứa đối tượng ActiveConference là đường liên kết đến tài nguyên conferenceRecords hiện tại trong không gian họp.
Các phần sau đây trình bày chi tiết cách định cấu hình không gian họp bằng một số đối tượng và phương thức beta mới.
Thiết lập chế độ kiểm duyệt và quyền truy cập vào cuộc họp
Thông qua các đối tượng thử nghiệm mới, giờ đây, bạn có thể thiết lập chế độ kiểm duyệt, các hạn chế về tính năng và quyền mà người dùng nhận được khi tham gia cuộc họp. Các giá trị này được đặt thông qua đối tượng SpaceConfig đã cập nhật.
Trường moderation là chế độ kiểm duyệt được định cấu hình sẵn cho một cuộc họp, trong đó chế độ mặc định do chính sách của người dùng kiểm soát. Phương thức này sử dụng đối tượng Moderation. Khi chế độ kiểm duyệt đang bật, chủ sở hữu cuộc họp sẽ có quyền kiểm soát cuộc họp thông qua các tính năng như quản lý người đồng tổ chức (xem spaces.members) và hạn chế sử dụng tính năng (xem moderationRestrictions). Để biết thêm thông tin về thành viên, hãy xem bài viết Quản lý thành viên trong không gian.
Trường moderationRestrictions thực thi các quy định hạn chế về việc kiểm duyệt cho cuộc họp khi moderation đang bật. Phương thức này sử dụng đối tượng ModerationRestrictions. Các quy định hạn chế xác định những người có quyền gửi tin nhắn trò chuyện và biểu tượng cảm xúc, chia sẻ màn hình và liệu có hạn chế vai trò mặc định được chỉ định cho người dùng là người xem hay không. Trường moderationRestrictions dựa vào RestrictionType để áp dụng 3 quy định hạn chế đầu tiên. Bạn có thể áp dụng RestrictionType cho chủ sở hữu và người đồng tổ chức cuộc họp hoặc cho tất cả người tham gia. DefaultJoinAsViewerType áp dụng quyền cuối cùng, theo đó người dùng tham gia với tư cách là cộng tác viên theo mặc định, nhưng người tổ chức cũng có thể hạn chế người dùng tham gia với tư cách là người xem.
Trường firstJoinerType thiết lập việc người dùng có thể tham gia trước người tổ chức cho các cuộc họp trong không gian họp này hay không. Phương thức này xác định những người dùng nào có thể tham gia cuộc họp trước và liệu những người dùng khác có ở trạng thái chờ hay không. Phương thức này sử dụng đối tượng FirstJoinerType.
Quản lý thành viên của không gian
Chủ sở hữu cuộc họp luôn có thể tham gia cuộc họp mà không cần yêu cầu tham gia. Tuy nhiên, giờ đây, bạn có thể thiết lập để các thành viên cũng có thể tham gia cuộc họp mà không cần yêu cầu tham gia. Ngoài ra, bạn có thể định cấu hình để các thành viên có vai trò trong cuộc họp, chẳng hạn như COHOST, cho phép họ có các quyền quản lý cuộc họp giống như chủ sở hữu cuộc họp. Để biết thêm thông tin về cách truy cập vào không gian họp mà không cần gửi yêu cầu tham gia, hãy xem AccessType.
Tài nguyên spaces.members bao gồm các trường name, user và role.
Xin lưu ý rằng thành viên khác với người tham gia. Người tham gia là người đã tham gia cuộc gọi hoặc sử dụng Chế độ đồng hành, xem với tư cách người xem hoặc thiết bị phòng được kết nối với cuộc gọi. Mỗi người có một tài nguyên conferenceRecords.participants.
Bạn có thể quản lý thành viên trong không gian bằng các phương thức sau:
Mỗi phương thức lấy một tham số đường dẫn với các phương thức tạo và liệt kê sử dụng trường parent để biểu thị không gian họp, cũng như các phương thức xoá và lấy sử dụng trường name để lọc kết quả dựa trên không gian họp và tên thành viên.
Tất cả phương thức, ngoại trừ xoá, đều hỗ trợ tham số fields trong SystemParameterContext. Khi bạn bỏ qua tham số fields, phản hồi API sẽ mặc định là "name,email,role,user".
Tham số fields dựa vào FieldMask để lọc phản hồi. FieldMask là một cách để phương thức gọi API liệt kê các trường mà yêu cầu sẽ trả về. Đây là danh sách các trường được phân tách bằng dấu phẩy để chỉ định chỉ một số trường nhất định trong đối tượng được sử dụng trong khi giữ nguyên các trường khác.
Việc sử dụng FieldMask cho phép API tránh làm những việc không cần thiết và cải thiện hiệu suất. Mặt nạ trường được dùng cho các phương thức tạo, lấy và liệt kê. Để biết thêm thông tin về mặt nạ trường, hãy xem phần Sử dụng mặt nạ trường của API Google Trang tính.