Không gian hội 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 diễn ra hội nghị. Không gian họp cũng giúp người dùng gặp gỡ và tìm thấy các 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ội nghị. Tệp này cũng chứa đối tượng ActiveConference là một đường liên kết đến tài nguyên conferenceRecords hiện tại trong không gian hội nghị. Để biết thêm thông tin về cách quản lý không gian họp, hãy xem bài viết Tạo và quản lý 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 các đối tượng và phương thức này.
Thiết lập chế độ kiểm duyệt và quyền truy cập vào cuộc họp
Bạn có thể thiết lập cách người dùng tham gia cuộc họ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 thông qua đối tượng SpaceConfig.
Truy cập vào không gian tổ chức cuộc họp
Để xác định những người có thể tham gia không gian họp mà không cần yêu cầu tham gia, hãy đặt trường accessType bằng đối tượng AccessType.
Bạn có thể chọn trong số nhiều chế độ cài đặt về việc có tự động cho phép người tham dự tham gia hay không. Trường này mặc định là chế độ cài đặt quyền truy cập mặc định của người dùng.
Để xác định các điểm truy cập có thể dùng để tham gia cuộc họp được lưu trữ trong không gian họp, hãy đặt trường entryPointAccess bằng đối tượng EntryPointAccess. Đặt thành ALL để cho phép tất cả các điểm truy cập hoặc CREATOR_APP_ONLY để chỉ định phạm vi các điểm truy cập cho những điểm truy cập thuộc sở hữu của dự án Google Cloud đã tạo không gian họp.
Tạo báo cáo điểm danh
Để tạo báo cáo về số người tham dự cho không gian họp, hãy đặt trường boolean attendanceReportGenerationType bằng đối tượng AttendanceReportGenerationType. Nếu bạn yêu cầu báo cáo, Google Meet sẽ lưu báo cáo về danh sách người tham dự vào Google Drive của người tổ chức cuộc họp và gửi email.
Không gian họp có mức độ kiểm duyệt trung bình
Để kiểm duyệt cuộc họp, bạn có thể đặt trường boolean moderation bằng đối tượng Moderation.
Khi chế độ moderation là on, người tổ chức cuộc họp có quyền kiểm soát cuộc họp bằng các tính năng như quản lý người đồng tổ chức (xem spaces.members) và hạn chế tính năng bằng trường 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.
Để xác định các hạn chế về tính năng khi cuộc họp được kiểm duyệt (moderation là on), hãy đặt trường moderationRestrictions bằng đối tượng ModerationRestrictions. Các quy định hạn chế này xác định những người có quyền trong không gian họp để gửi tin nhắn trò chuyện hoặc biểu tượng cảm xúc hoặc chia sẻ màn hình.
Để đặt các quy định hạn chế về tính năng trên trường moderationRestrictions, hãy sử dụng enum RestrictionType để áp dụng chatRestriction, reactionRestriction, presentRestriction. Đặt thành HOSTS_ONLY để áp dụng các quyền cho cả người tổ chức và người đồng tổ chức cuộc họp hoặc NO_RESTRICTION để áp dụng cho tất cả người tham gia.
Để hạn chế vai trò mặc định được chỉ định cho người dùng là người xem, hãy đặt trường boolean defaultJoinAsViewerType bằng cách sử dụng enum DefaultJoinAsViewerType. Nếu defaultJoinAsViewerType là on, người dùng sẽ tham gia với tư cách là người xem. Nếu là off, người dùng sẽ tham gia với tư cách là người đóng góp. Giá trị mặc định là off. Nếu bạn đặt một vai trò rõ ràng cho người dùng trong spaces.members, thì người dùng đó sẽ tham gia với vai trò đó.
Quản lý cấu phần phần mềm tự động
Người tổ chức cuộc họp (chứ không phải người đồng tổ chức) có thể định cấu hình trước tính năng tự động ghi lại, tự động chép lời và "ghi chú cho tôi" trong không gian cuộc họp. Khi bạn bật các chế độ cài đặt này, không gian họp sẽ được ghi lại, bản chép lời sẽ được tạo và ghi chú cuộc họp sẽ được tự động ghi lại và sắp xếp vào Google Tài liệu. Mỗi tính năng đều độc lập và được đặt cho từng không gian họp. Bản chép lời của bản ghi âm chỉ có bằng tiếng Anh.
Bạn có thể định cấu hình trước cấu phần phần mềm tự động khi tạo không gian họp hoặc sau khi tạo không gian họp. Tính năng này cũng cho phép bạn thiết lập cấu phần phần mềm tự động cho các cuộc họp được tạo từ Lịch Google. Cả hai phương thức đều yêu cầu phạm vi OAuth meetings.space.settings. Để biết thêm thông tin, hãy xem phần Phạm vi OAuth cho chế độ cài đặt.
Để đặt cấu phần phần mềm tự động, hãy sử dụng đối tượng ArtifactConfig trong đối tượng SpaceConfig. ArtifactConfig bao gồm các trường recordingConfig, transcriptionConfig và smartNotesConfig.
Mỗi trường được liên kết với một đối tượng tương tự như RecordingConfig, TranscriptionConfig và SmartNotesConfig. Để đặt từng đối tượng, hãy sử dụng enum boolean AutoGenerationType để bật/tắt đối tượng cấu hình on hoặc off.
Phạm vi OAuth cho chế độ cài đặt
Bạn cần có các phạm vi OAuth sau để thiết lập hoặc truy cập vào chế độ cài đặt cuộc họp:
| Trường hợp sử dụng | Mã phạm vi |
|---|---|
| Thiết lập tính năng tạo cấu phần phần mềm tự động cho các không gian do các ứng dụng khác tạo. | https://www.googleapis.com/auth/meetings.space.settings |
| Nhận hoặc liệt kê các cấu phần phần mềm từ các hội nghị do các ứng dụng khác tạo. | https://www.googleapis.com/auth/meetings.space.readonly |
| Nhận hoặc liệt kê các chế độ cài đặt khác trước cuộc họp của một không gian họp do ứng dụng bên thứ ba tạo. | https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| Đọc và chỉnh sửa chế độ cài đặt cho tất cả không gian họp mà người dùng có thể truy cập thông qua bất kỳ ứng dụng nào khác, chẳng hạn như Lịch. | https://www.googleapis.com/auth/meetings.space.settings |
Để biết thêm thông tin về phạm vi OAuth, hãy xem phần Giới thiệu về phạm vi API Meet REST.
Quản lý thành viên của không gian
Mặc dù người tổ chức cuộc họp luôn có thể tham gia cuộc họp mà không cần gửi yêu cầu tham gia, nhưng bạn cũng có thể định cấu hình để các thành viên khác tham gia cuộc họp mà không cần gửi 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ư người tổ chức 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õ cửa, 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à một 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 một thiết bị trong phòng đã 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ừ phương thức 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 được cô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.