회의 공간은 회의가 열리는 가상 장소 또는 영구 객체 (예: 회의실)를 나타냅니다. 회의 공간은 사용자가 공유 리소스를 찾고 만나는 데도 도움이 됩니다.
spaces.create 메서드를 사용하여 회의 공간을 만들면 spaces 리소스의 인스턴스가 반환됩니다. 리소스에는 회의 공간의 구성인 SpaceConfig 객체가 포함됩니다. 또한 회의 공간 내의 현재 conferenceRecords 리소스로 연결되는 링크인 ActiveConference 객체도 포함되어 있습니다. 회의 공간 관리에 관한 자세한 내용은 회의 공간 만들기 및 관리를 참고하세요.
다음 섹션에서는 이러한 객체와 메서드를 사용하여 회의 공간을 구성하는 방법을 자세히 설명합니다.
관리 및 회의 액세스 설정
SpaceConfig 객체를 통해 사용자가 회의에 참여하는 방식, 검토 모드, 기능 제한, 사용자가 회의에 참여할 때 받는 권한을 설정할 수 있습니다.
회의 공간 액세스
노크 없이 회의 공간에 참여할 수 있는 사용자를 확인하려면 AccessType 객체를 사용하여 accessType 필드를 설정합니다.
참석자가 자동으로 참여하도록 허용할지 여부에 관한 여러 설정 중에서 선택할 수 있습니다. 이 필드의 기본값은 사용자의 기본 액세스 설정입니다.
회의 스페이스에서 호스팅되는 회의에 참여하는 데 사용할 수 있는 진입점을 정의하려면 EntryPointAccess 객체를 사용하여 entryPointAccess 필드를 설정합니다. 모든 진입점을 허용하도록 ALL로 설정하거나 CREATOR_APP_ONLY로 설정하여 회의 공간을 만든 Google Cloud 프로젝트에서 소유한 진입점으로만 진입점을 범위 지정합니다.
참석 보고서 생성
회의 공간의 참석 보고서를 만들려면 AttendanceReportGenerationType 객체를 사용하여 불리언 attendanceReportGenerationType 필드를 설정합니다. 보고서가 요청되면 Google Meet에서 참석 보고서를 회의 주최자의 Google Drive에 저장하고 이메일도 전송합니다.
회의 공간 관리
회의를 관리하려면 Moderation 객체를 사용하여 불리언 moderation 필드를 설정하면 됩니다.
moderation 모드가 on인 경우 회의 주최자는 공동 호스트 관리 (spaces.members 참고) 및 moderationRestrictions 필드를 사용한 기능 제한과 같은 기능으로 회의를 제어할 수 있습니다. 구성원에 관한 자세한 내용은 스페이스 구성원 관리를 참고하세요.
회의가 관리되는 경우 (moderation이 on임) 기능 제한을 정의하려면 ModerationRestrictions 객체를 사용하여 moderationRestrictions 필드를 설정합니다. 제한사항에 따라 회의 공간 내에서 채팅 메시지 또는 반응을 보내거나 화면을 공유할 권한이 있는 사용자가 정의됩니다.
moderationRestrictions 필드에 지형지물 제한을 설정하려면 RestrictionType 열거형을 사용하여 chatRestriction, reactionRestriction, presentRestriction를 적용합니다. 회의 주최자와 공동 주최자에게 모두 권한을 적용하려면 HOSTS_ONLY로 설정하고 모든 참석자에게 적용하려면 NO_RESTRICTION로 설정합니다.
사용자에게 뷰어로 할당된 기본 역할을 제한하려면 DefaultJoinAsViewerType enum을 사용하여 불리언 defaultJoinAsViewerType 필드를 설정합니다. defaultJoinAsViewerType이 on인 경우 사용자는 시청자로 참여합니다. off인 경우 사용자는 참여자로 참여합니다. 기본값은 off입니다. spaces.members에서 사용자에게 명시적 역할이 설정된 경우 사용자는 해당 역할로 참여합니다.
자동 아티팩트 관리
공동 호스트가 아닌 회의 주최자는 회의 공간 내에서 자동 녹화, 자동 스크립트, '나를 위해 메모 작성'을 사전 구성할 수 있습니다. 이 설정을 사용 설정하면 회의 공간이 녹화되고, 스크립트가 생성되며, 회의 메모가 자동으로 캡처되어 Google Docs에 정리됩니다. 각 기능은 독립적이며 회의 공간별로 설정됩니다. 녹음 파일 자막은 영어로만 제공됩니다.
회의 스페이스를 만들 때 또는 회의 스페이스가 생성된 후에 자동 아티팩트를 사전 구성할 수 있습니다. 이 기능을 사용하면 Google Calendar에서 만든 회의에 대한 자동 아티팩트를 설정할 수도 있습니다. 두 메서드 모두 meetings.space.settings OAuth 범위가 필요합니다. 자세한 내용은 설정의 OAuth 범위를 참고하세요.
자동 아티팩트를 설정하려면 SpaceConfig 객체 아래의 ArtifactConfig 객체를 사용하세요. ArtifactConfig는 recordingConfig, transcriptionConfig, smartNotesConfig 필드로 구성됩니다.
각 필드는 RecordingConfig, TranscriptionConfig, SmartNotesConfig와 같은 유사한 객체에 매핑됩니다. 각 객체를 설정하려면 AutoGenerationType 불리언 enum을 사용하여 구성 객체 on 또는 off를 전환합니다.
설정의 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.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| 사용자가 캘린더와 같은 다른 앱을 통해 액세스할 수 있는 모든 회의 공간의 설정을 읽고 수정합니다. | https://www.googleapis.com/auth/meetings.space.settings |
OAuth 범위에 관한 자세한 내용은 Meet REST API 범위를 참고하세요.
스페이스 구성원 관리하기
회의 주최자는 언제든지 노크하지 않고도 회의에 참여할 수 있지만, 노크하지 않고도 회의에 참여할 수 있는 추가 구성원을 구성할 수도 있습니다.
또한 구성원에게 회의 주최자와 동일한 회의 관리 기능을 부여하는 COHOST와 같은 회의 역할을 할당할 수 있습니다. 노크하지 않고 회의 공간에 액세스하는 방법에 관한 자세한 내용은 AccessType를 참고하세요.
spaces.members 리소스에는 name, user, role 필드가 포함됩니다.
회원은 참여자와 다릅니다. 참여자는 통화에 참여하거나 컴패니언 모드를 사용하거나 시청자로 시청 중인 사용자 또는 통화에 연결된 회의실 기기입니다. 사용자당 하나의 conferenceRecords.participants 리소스가 있습니다.
다음 방법을 사용하여 스페이스 회원을 관리할 수 있습니다.
각 메서드는 parent 필드를 사용하여 회의 공간을 나타내는 create 및 list 메서드와 name 필드를 사용하여 회의 공간 및 구성원 이름을 기반으로 결과를 필터링하는 delete 및 get 메서드와 함께 경로 매개변수를 사용합니다.
삭제를 제외한 모든 메서드는 SystemParameterContext의 fields 매개변수를 지원합니다.
fields 매개변수를 생략하면 API 응답이 기본적으로 "name,email,role,user"로 설정됩니다.
fields 매개변수는 응답 필터링에 FieldMask를 사용합니다. FieldMask는 API 호출자가 요청이 반환해야 하는 필드를 나열하는 방법입니다. 쉼표로 구분된 필드 목록으로, 객체의 특정 필드만 사용하고 다른 필드는 변경하지 않도록 지정합니다.
FieldMask를 사용하면 API에서 불필요한 작업을 방지하고 성능을 개선할 수 있습니다. 필드 마스크는 생성, 가져오기, 목록 메서드에 사용됩니다. 필드 마스크에 관한 자세한 내용은 Google Sheets API의 필드 마스크 사용을 참고하세요.