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 diễn ra các hội nghị. Không gian tổ chức hội nghị 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. Để 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 Sử dụng 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, người tổ chức cuộc họp sẽ 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ế 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 người tổ chức 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
Người tổ chức 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ể định cấu hình những 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ư 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à 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ừ 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 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.
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, 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, hệ thống sẽ tự động ghi lại không gian họp, tạo bản chép lời và ghi lại cũng như sắp xếp ghi chú cuộc họ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 ghi âm chỉ có phụ đề 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.
Cấu phần phần mềm tự động được đặt thông qua đối tượng ArtifactConfig trong đối tượng SpaceConfig, là một phần của tài nguyên spaces. 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. Mỗi đối tượng được đặt bằng cách sử dụng enum boolean AutoGenerationType để bật hoặc tắt đối tượng cấu hình.
Phạm vi OAuth cho phần 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 Phạm vi API Meet REST.