회의 공간은 회의가 열리는 가상 장소 또는 지속적인 객체 (예: 회의실)를 나타냅니다. 회의 공간은 사용자가 만나서 공유 리소스를 찾는 데도 도움이 됩니다.
spaces.create 메서드를 사용하여 회의 스페이스를 만들면 spaces 리소스의 인스턴스가 반환됩니다. 리소스에는 회의 공간의 구성인 SpaceConfig 객체가 포함됩니다. 또한 회의 공간 내의 현재 conferenceRecords 리소스로 연결되는 링크인 ActiveConference 객체도 포함됩니다. 회의 스페이스 관리에 대한 자세한 내용은 회의 스페이스 만들기 및 관리를 참고하세요.
다음 섹션에서는 이러한 객체와 메서드를 사용하여 회의 공간을 구성하는 방법을 자세히 설명합니다.
진행 및 회의 액세스 설정
SpaceConfig 객체를 통해 사용자가 회의에 참여하는 방법, 조정 모드, 기능 제한, 사용자가 회의에 참여할 때 부여되는 권한을 설정할 수 있습니다.
회의 스페이스 액세스
노크 없이 회의 스페이스에 참여할 수 있는 사용자를 확인하려면 AccessType 객체를 사용하여 accessType 필드를 설정합니다.
참석자의 자동 참여 허용 여부에 관한 여러 설정을 선택할 수 있습니다. 이 필드는 기본적으로 사용자의 기본 액세스 설정으로 설정됩니다.
회의 스페이스에서 호스팅되는 회의에 참여하는 데 사용할 수 있는 진입점을 정의하려면 EntryPointAccess 객체를 사용하여 entryPointAccess 필드를 설정합니다. 모든 진입점을 허용하려면 ALL로 설정하고, 회의 스페이스를 만든 Google Cloud 프로젝트가 소유한 진입점으로만 범위를 지정하려면 CREATOR_APP_ONLY로 설정합니다.
참석 보고서 생성
회의 공간의 출석 보고서를 만들려면 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 범위에 대한 자세한 내용은 REST API 범위 알아보기를 참고하세요.
스페이스 구성원 관리
회의 주최자는 항상 노크 없이 회의에 참여할 수 있지만, 노크 없이 회의에 참여할 수 있는 구성원을 추가로 구성할 수도 있습니다.
또한 회의에서 COHOST와 같은 역할을 갖도록 구성할 수 있으며, 이 경우 회의 주최자와 동일한 회의 관리 권한이 부여됩니다. 노크 없이 회의실에 액세스하는 방법에 대한 자세한 내용은 AccessType를 참고하세요.
spaces.members 리소스에는 name, user, role 필드가 포함됩니다.
회원은 참여자와 다릅니다. 참여자는 통화에 참여한 사람 또는 컴패니언 모드를 사용하여 참관자로 시청하는 사람, 통화에 연결된 회의실 기기입니다. 각 사용자에 대해 하나의 conferenceRecords.participants 리소스가 있습니다.
다음 방법을 사용하여 스페이스 구성원을 관리할 수 있습니다.
각 메서드는 parent 필드를 사용하여 회의 스페이스를 나타내는 생성 및 목록 메서드와 name 필드를 사용하여 회의 스페이스 및 회원 이름을 기반으로 결과를 필터링하는 삭제 및 가져오기 메서드를 사용하여 경로 매개변수를 사용합니다.
삭제를 제외한 모든 메서드는 SystemParameterContext에서 fields 매개변수를 지원합니다.
fields 매개변수를 생략하면 API 응답은 기본적으로 "name,email,role,user"입니다.
fields 매개변수는 응답 필터링을 위해 FieldMask를 사용합니다. FieldMask는 API 호출자가 요청에서 반환해야 하는 필드를 나열하는 방법입니다. 객체의 특정 필드만 사용하고 다른 필드는 변경하지 않도록 지정하는 쉼표로 구분된 필드 목록입니다.
FieldMask를 사용하면 API가 불필요한 작업을 방지하고 성능을 개선할 수 있습니다. 필드 마스크는 생성, 가져오기, 목록 메서드에 사용됩니다. 필드 마스크에 대한 자세한 내용은 Google Sheets API의 필드 마스크 사용을 참고하세요.