회의 스페이스 및 참여자 구성

회의 스페이스는 회의가 개최되는 가상 장소 또는 지속적 객체 (예: 회의실)를 나타냅니다. 회의 스페이스는 사용자가 만나고 공유 리소스를 찾는 데도 도움이 됩니다.

spaces.create 메서드를 사용하여 회의 스페이스를 만들면 spaces 리소스의 인스턴스가 반환됩니다. 리소스 에는 회의 스페이스의 구성인 SpaceConfig 객체 가 포함되어 있습니다. 또한 회의 스페이스 내의 현재 conferenceRecords 리소스에 대한 링크인 ActiveConference 객체도 포함되어 있습니다. 회의 스페이스 관리에 대한 자세한 내용은 회의 스페이스 만들기 및 관리를 참고하세요.

다음 섹션에서는 이러한 객체와 메서드를 사용하여 회의 스페이스를 구성하는 방법을 자세히 설명합니다.

조정 및 회의 액세스 설정

`SpaceConfig` 객체를 통해 사용자가 회의에 참여하는 방법, 조정 모드, 기능 제한, 회의에 참여할 때 사용자에게 부여되는 권한을 설정할 수 있습니다.

회의 스페이스 액세스

노크하지 않고 회의 스페이스에 참여할 수 있는 사용자를 결정하려면 accessType 필드를 사용하여 AccessType 객체를 설정합니다. 참석자가 자동으로 참여하도록 허용할지 여부에 관한 여러 설정 중에서 선택할 수 있습니다. 필드는 기본적으로 사용자의 기본 액세스 설정으로 설정됩니다.

회의 스페이스에서 호스팅되는 회의에 참여하는 데 사용할 수 있는 진입점을 정의하려면 EntryPointAccess 객체를 사용하여 entryPointAccess 필드를 설정합니다. 모든 진입점을 허용하려면 ALL로 설정하고, 진입점을 회의 스페이스를 만든 Google Cloud 프로젝트가 소유한 진입점으로만 범위를 지정하려면 CREATOR_APP_ONLY로 설정합니다.

회의 스페이스 조정

회의를 조정하려면 moderation 필드를 사용하여 Moderation 객체를 설정합니다. moderation 모드가 on이면 회의 주최자는 공동 호스트 관리 (spaces.members 참고) 및 moderationRestrictions 필드를 사용한 기능 제한과 같은 기능을 통해 회의를 제어할 수 있습니다. 구성원에 대한 자세한 내용은 스페이스 구성원 관리를 참고하세요.

회의가 조정될 때 (moderation이 on) 기능 제한을 정의하려면 moderationRestrictions 필드를 사용하여 ModerationRestrictions 객체를 설정합니다. 제한은 회의 스페이스 내에서 채팅 메시지 또는 반응을 보내거나 화면을 공유할 수 있는 사용자를 정의합니다.

moderationRestrictions 필드에 기능 제한을 설정하려면 RestrictionType 을 사용하여 chatRestriction, reactionRestriction, presentRestriction을 적용합니다. 회의 주최자와 공동 호스트 모두에게 권한을 적용하려면 HOSTS_ONLY로 설정하고, 모든 참여자에게 적용하려면 NO_RESTRICTION으로 설정합니다.

사용자에게 뷰어로 할당된 기본 역할을 제한하려면 불리언 defaultJoinAsViewerType 필드를 사용하여 DefaultJoinAsViewerType을 설정합니다. defaultJoinAsViewerType이 on이면 사용자가 뷰어로 참여합니다. off이면 사용자가 참여자로 참여합니다. 기본값은 off입니다. spaces.members에서 사용자에게 명시적 역할이 설정된 경우 사용자는 해당 역할로 참여합니다.

참석 보고서 생성

회의 스페이스의 참석 보고서를 만들려면 attendanceReportGenerationType 필드를 사용하여 AttendanceReportGenerationType 객체를 설정합니다. 보고서가 요청되면 Google Meet에서 참석 보고서를 회의 주최자의 Google Drive에 저장하고 이메일도 전송됩니다.

자동 아티팩트 관리

회의 주최자는 공동 호스트가 아닌 회의 스페이스 내에서 자동 녹화, 자동 스크립트, 스마트 노트를 미리 구성할 수 있습니다. 이러한 설정이 사용 설정되면 회의 스페이스가 녹화되고, 스크립트가 생성되며, 회의록이 캡처되어 Google Docs에 자동으로 정리됩니다. 각 기능은 독립적이며 회의 스페이스별로 설정됩니다. 녹화 자막은 영어로만 제공됩니다.

회의 스페이스를 만들 때 또는 회의 스페이스가 생성된 후에 자동 아티팩트를 미리 구성할 수 있습니다. 두 메서드 모두 meetings.space.settings OAuth 범위가 필요합니다. 자세한 내용은 설정의 OAuth 범위를 참고하세요.

Google Calendar에서 만든 회의의 자동 아티팩트를 설정할 수도 있습니다.

자동 아티팩트를 설정하려면 ArtifactConfig 객체 내에서 SpaceConfig 객체를 사용합니다. ArtifactConfig 는 recordingConfig, transcriptionConfig, smartNotesConfig 필드로 구성됩니다.

각 필드는 RecordingConfig, TranscriptionConfig, 및 SmartNotesConfig 과 같은 유사한 객체에 매핑됩니다. 각 객체를 설정하려면 AutoGenerationType 을 사용하여 구성 객체를 on 또는 off로 전환합니다.

회의 중에 생성된 아티팩트를 검색하려면 아티팩트 작업을 참고하세요.

스크립트와 스마트 노트의 차이점

회의 스크립트와 스마트 노트('자동 회의록'이라고도 함)는 모두 회의에서 정보를 캡처하지만 이러한 기능은 서로 다른 목적을 제공하고 서로 다른 아티팩트를 생성합니다.

다음 표에서는 이러한 차이점을 보여줍니다.

기능	스크립트	스마트 노트
개요	단어 하나하나를 그대로 기록한 것입니다.	Gemini에서 생성한 핵심 사항의 간결한 요약입니다.
세부정보 수준	100% 세부정보입니다. 말한 모든 내용이 기록됩니다.	개략적인 수준입니다. 결정 및 작업 항목에 중점을 둡니다.
사용 사례	법규 준수, 정확한 인용 확인, 사용자 접근성	늦게 참여한 참석자가 즉시 따라잡을 수 있도록 지원하고, 회의록 작성 및 프로젝트 추적을 자동화합니다.
실시간 사용	자막에 사용됩니다. 파일은 통화 후에 생성됩니다.	통화 중에 측면 패널에서 요약이 작성되는 것을 볼 수 있습니다.
출력	발언자 이름과 타임스탬프가 포함된 긴 Google Docs 문서입니다.	섹션과 글머리 기호가 포함된 회의록의 간결한 Google Docs 문서입니다.
인용	연결할 수 있는 전체 텍스트가 포함되어 있습니다.	스크립트와 스마트 노트가 모두 사용 설정된 경우 컨텍스트를 위해 스크립트의 특정 순간으로 다시 연결되는 인용 (타임스탬프)이 포함됩니다. 자세한 내용은 두 기능이 모두 사용 설정된 경우를 참고하세요.

두 기능이 모두 사용 설정된 경우

각 기능을 개별적으로 사용할 수도 있지만 스크립트와 스마트 노트를 동시에 사용하여 더 나은 회의 후 아티팩트를 만들 수도 있습니다.

두 기능이 모두 사용 설정되면 생성된 스마트 노트 문서에 인용이 표시됩니다. 이러한 인용은 세부정보 섹션 전체에 표시되며 회의 스크립트의 특정 타임스탬프로 연결됩니다. 해당 인용을 클릭하면 스크립트의 관련 섹션으로 바로 이동하여 회의 내용을 더 자세히 알아볼 수 있습니다.

회의 중에 참여자에게 두 기능이 모두 활성 상태임을 나타내는 표시기가 표시됩니다. 클릭 가능한 인용을 생성하려면 회의 기간 동안 활성 상태를 유지해야 합니다. 파일이 서로 연결되어 있더라도 시스템은 여전히 호스트의 Google Drive에 두 개의 개별 문서를 생성합니다. 두 파일 모두 Google Calendar 일정에 자동으로 첨부됩니다.

설정의 OAuth 범위

회의 설정을 설정하거나 액세스하려면 다음 OAuth 범위가 필요합니다.

사용 사례	범위 코드
다른 앱에서 만든 스페이스의 자동 아티팩트 생성을 설정합니다.	`https://www.googleapis.com/auth/meetings.space.settings`
다른 앱에서 만든 회의의 아티팩트를 가져오거나 나열합니다.	`https://www.googleapis.com/auth/meetings.space.readonly`
서드 파티 앱에서 만든 회의 스페이스의 다른 회의 전 설정을 가져오거나 나열합니다.	`https://www.googleapis.com/auth/meetings.space.created` `https://www.googleapis.com/auth/meetings.space.readonly`
사용자가 Calendar와 같은 다른 앱을 통해 액세스할 수 있는 모든 회의 스페이스의 설정을 읽고 수정합니다.	`https://www.googleapis.com/auth/meetings.space.settings`

OAuth 범위에 대한 자세한 내용은 Meet REST API 범위를 참고하세요.

스페이스 구성원 관리

스페이스 구성원은 회의 스페이스에서 역할을 하도록 구성된 사용자입니다. 이러한 사용자는 연결 권한 요청(일명 '노크') 없이 회의 스페이스에 참여할 수 있습니다.

회의 주최자는 회의 스페이스에 자동으로 참여할 수 있지만 노크하지 않고 회의에 참여하도록 추가 구성원을 구성할 수도 있습니다. 또한 구성원은 회의에서 Role 을 갖도록 구성할 수 있습니다(예: 회의 주최자와 동일한 회의 관리 기능을 제공하는 COHOST). 노크하지 않고 회의 스페이스에 액세스하는 방법에 대한 자세한 내용은 AccessType을 참고하세요.

spaces.members 리소스에는 name, user, role 필드가 포함되어 있습니다.

구성원은 참여자와 다릅니다. 참여자는 통화에 참여한 사람 또는 컴패니언 모드를 사용하는 사람, 뷰어로 시청하는 사람, 통화에 연결된 회의실 기기입니다. 각 사용자에게는 하나의 conferenceRecords.participants 리소스가 있습니다.

다음 메서드를 사용하여 스페이스 구성원을 관리할 수 있습니다.

각 메서드는 경로 매개변수를 사용합니다. 만들기 및 목록 메서드는 parent 필드를 사용하여 회의 스페이스를 나타내고, 삭제 및 가져오기 메서드는 name 필드를 사용하여 회의 스페이스 및 구성원 이름을 기준으로 결과를 필터링합니다. 삭제를 제외한 모든 메서드는 spaces.members 리소스의 인스턴스를 반환합니다.

삭제를 제외한 모든 메서드는 fields 매개변수를 SystemParameterContext에서 지원합니다. fields 매개변수가 생략되면 API 응답은 기본적으로 "name,email,role,user"로 설정됩니다.

fields 매개변수는 응답 필터링을 위해 FieldMask 를 사용합니다. FieldMask는 API 호출자가 요청에서 반환해야 하는 필드를 나열하는 방법입니다. 객체의 특정 필드만 사용하고 다른 필드는 변경되지 않은 상태로 두도록 지정하는 쉼표로 구분된 필드 목록입니다. FieldMask를 사용하면 API가 불필요한 작업을 방지하고 성능을 개선할 수 있습니다. 필드 마스크는 만들기, 가져오기, 목록 메서드에 사용됩니다. 필드 마스크에 대한 자세한 내용은 Google Sheets API의 필드 마스크 사용을 참고하세요.