Không gian hội họp đại diện cho một địa điểm ảo hoặc một đối tượng cố định (chẳng hạn như phòng họp) nơi tổ chức các hội nghị. Không gian tổ chức cuộc 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 một 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. Đây là cấu hình cho không gian họp. Đối tượng này cũng chứa đối tượng ActiveConference. Đây là một đườ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 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ể đặt cách người dùng tham gia cuộc họp, các chế độ kiểm duyệt, các hạn chế về tính năng và các 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 một không gian họp mà không cần yêu cầu tham gia, hãy đặt trường accessType bằng cách sử dụ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 tổ chức trong một không gian họp, hãy đặt trường entryPointAccess bằng cách sử dụ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 để giới hạn các điểm truy cập chỉ cho những điểm truy cập thuộc 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 điểm danh cho không gian họp, hãy đặt trường boolean attendanceReportGenerationType bằng cách sử dụng đối tượng AttendanceReportGenerationType. Nếu có yêu cầu báo cáo, Google Meet sẽ lưu báo cáo điểm danh vào Google Drive của người tổ chức cuộc họp và gửi email.
Điều phối không gian họp
Để kiểm duyệt cuộc họp, bạn có thể đặt trường boolean moderation bằng cách sử dụ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 hạn chế này xác định những người có quyền 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 trong không gian họp.
Để đặt các hạn chế về tính năng trên trường moderationRestrictions, hãy dùng enum RestrictionType để áp dụng chatRestriction, reactionRestriction, presentRestriction. Đặt thành HOSTS_ONLY để áp dụng quyền cho cả người tổ chức cuộc họp và người đồng tổ chức, 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 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ò cụ thể 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 (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 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 ghi lại và sắp xếp tự động vào Google Tài liệu. Mỗi tính năng đều độc lập và được thiết lập cho từng không gian họp. Phụ đề trong bản ghi âm chỉ có bằng tiếng Anh.
Bạn có thể định cấu hình trước cá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ác tạo tác 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 bài viết Phạm vi OAuth cho chế độ cài đặt.
Để đặt cấu phần phần mềm tự động, hãy 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ự, chẳng hạn như RecordingConfig, TranscriptionConfig và SmartNotesConfig. Để đặt từng đối tượng, hãy 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
Để đặt hoặc truy cập vào chế độ cài đặt cuộc họp, bạn cần có các phạm vi OAuth sau:
| Trường hợp sử dụng | Mã phạm vi |
|---|---|
| Thiết lập chế độ tự động tạo cấu phần phần mềm cho các không gian do những ứng dụng khác tạo. | https://www.googleapis.com/auth/meetings.space.settings |
| Nhận hoặc liệt kê dữ liệu 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ề các phạm vi OAuth, hãy xem Các phạm vi của Meet REST API.
Quản lý thành viên trong 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, nhưng bạn cũng có thể thiết lập để 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. Ngoài ra, bạn có thể định cấu hình để các thành viên có một vai trò trong cuộc họp, chẳng hạn như COHOST. Vai trò này cho phép họ 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 một không gian họp mà không cần gõ cửa, hãy xem phần AccessType.
Tài nguyên spaces.members bao gồm các trường name, user và role.
Xin lưu ý rằng hội 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 là người xem hoặc là thiết bị phòng họp được kết nối với cuộc gọi. Mỗi người có một conferenceRecords.participants tài nguyên.
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 đều lấy một tham số đường dẫn, trong đó 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òn các phương thức xoá và nhận 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ả các phương thức, ngoại trừ phương thức xoá, đều hỗ trợ tham số fields trong SystemParameterContext. Khi tham số fields bị bỏ qua, 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à cách để phương thức gọi API liệt kê các trường mà một 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 rằng chỉ một số trường nhất định trong một đối tượng được dùng trong khi các trường khác vẫn không thay đổi. Việc sử dụng FieldMask giúp API tránh được những 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, nhận và liệt kê. Để biết thêm thông tin về mặt nạ trường, hãy xem bài viết Sử dụng mặt nạ trường của API Google Trang tính.