Thiết lập không gian họp và thành viên

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 tổ chức cuộc 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, 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 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 phạm vi 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.

Không gian họp vừa phải

Để kiểm duyệt cuộc họp, bạn có thể đặt trường 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 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 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 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à cộng tác viên. 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ò đó.

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 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.

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 hình, tự động chép lời và ghi chú thông minh 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 trong 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. 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.

Bạn cũng có thể thiết lập tính năng tạo tự động các thành phần cho những cuộc họp được tạo trên Lịch Google.

Để đặt các 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ự, chẳng hạn như RecordingConfig, TranscriptionConfig và SmartNotesConfig. Để đặt từng đối tượng, hãy sử dụng AutoGenerationType để chuyển đổi đối tượng cấu hình on hoặc off.

Để truy xuất các nội dung được tạo trong một cuộc họp, hãy xem phần Làm việc với nội dung.

Điểm khác biệt giữa bản chép lời và ghi chú thông minh

Mặc dù cả bản chép lời cuộc họp và ghi chú thông minh (còn gọi là "ghi chú cho tôi") đều ghi lại thông tin từ cuộc họp, nhưng những tính năng này phục vụ các mục đích khác nhau và tạo ra các thành phần khác nhau.

Bảng sau đây cho thấy sự khác biệt giữa hai loại:

Tính năng Bản chép lời Ghi chú thông minh
Tổng quan Bản ghi nguyên văn, từng từ. Bản tóm tắt ngắn gọn về các điểm chính do Gemini tạo.
Mức độ chi tiết 100% chi tiết. Mọi lời nói đều được ghi lại. Cấp cao. Tập trung vào các quyết định và việc cần làm.
Trường hợp sử dụng Tuân thủ pháp luật, kiểm tra trích dẫn chính xác và khả năng hỗ trợ tiếp cận của người dùng. Giúp những người tham gia muộn có thể nắm bắt thông tin ngay lập tức; tự động ghi biên bản cuộc họp và theo dõi dự án.
Mức sử dụng theo thời gian thực Dùng cho phụ đề. Tệp này được tạo sau cuộc gọi. Bạn có thể xem bản tóm tắt được tạo trong bảng điều khiển bên trong cuộc gọi.
Đầu ra Một tài liệu dài trên Google Tài liệu có tên người nói và dấu thời gian. Một tài liệu Google Tài liệu ngắn gọn chứa ghi chú cuộc họp, có các phần và dấu đầu dòng.
Trích dẫn Chứa toàn bộ văn bản có thể được liên kết. Bao gồm các trích dẫn (dấu thời gian) liên kết ngược lại với thời điểm cụ thể trong bản chép lời để cung cấp bối cảnh, nếu cả bản chép lời và ghi chú thông minh đều được bật. Để biết thêm thông tin, hãy xem phần Khi cả hai tính năng đều được bật.

Khi cả hai tính năng đều được bật

Mặc dù có thể sử dụng riêng từng tính năng, nhưng bạn cũng có thể dùng cả bản chép lời và ghi chú thông minh cùng lúc để tạo ra các bản ghi hiệu quả hơn sau cuộc họp.

Khi bật cả hai tính năng này, bạn sẽ thấy các trích dẫn trong tài liệu ghi chú thông minh đã tạo. Các trích dẫn này nằm trong phần chi tiết và liên kết với các dấu thời gian cụ thể trong bản chép lời cuộc họp. Bằng cách nhấp vào các trích dẫn này, bạn có thể chuyển thẳng đến phần có liên quan trong bản chép lời để hiểu rõ hơn về nội dung thảo luận.

Trong cuộc họp, người tham gia sẽ thấy các chỉ báo cho biết cả hai tính năng đều đang hoạt động. Các thành phần này phải hoạt động trong suốt thời gian diễn ra cuộc họp để tạo ra các trích dẫn có thể nhấp vào. Mặc dù các tệp được liên kết với nhau, nhưng hệ thống vẫn tạo ra hai tài liệu riêng biệt trong Google Drive của người tổ chức. Cả hai tệp này cũng được tự động đính kèm vào sự kiện trên Lịch Google.

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ê các cấu phần phần mềm từ những 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.created
https://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 bài viết Các phạm vi của API REST Meet.

Quản lý thành viên trong không gian

Thành viên của không gian là người dùng được thiết lập để có một vai trò trong không gian họp. Những người dùng này có thể tham gia không gian họp mà không cần yêu cầu quyền kết nối (còn gọi là "yêu cầu tham gia").

Mặc dù người tổ chức cuộc họp có thể tự động vào không gian họp, 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 tham gia. Ngoài ra, bạn có thể định cấu hình để các thành viên có Role trong cuộc họp, chẳng hạn như COHOST. Nhờ đó, họ có thể 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 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 đề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 trả về một phiên bản của tài nguyên spaces.members.

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 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à cách để người 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.