회의 공간은 회의가 열리는 가상 장소 또는 지속적인 객체 (예: 회의실)를 나타냅니다. 회의 공간은 사용자가 공유 리소스를 찾고 만나는 데도 도움이 됩니다.
spaces.create 메서드를 사용하여 회의 공간을 만들면 spaces 리소스의 인스턴스가 반환됩니다. 리소스에는 회의 공간의 구성인 SpaceConfig 객체가 포함됩니다. 또한 회의 공간 내 현재 conferenceRecords 리소스로 연결되는 ActiveConference 객체도 포함되어 있습니다.
다음 섹션에서는 몇 가지 새로운 베타 객체와 메서드를 사용하여 회의 공간을 구성하는 방법을 자세히 설명합니다.
관리 및 회의 액세스 설정
이제 새 베타 객체를 통해 검토 모드, 기능 제한, 사용자가 회의에 참여할 때 받는 권한을 설정할 수 있습니다. 이는 업데이트된 SpaceConfig 객체를 통해 설정됩니다.
moderation 필드는 회의에 대해 사전 구성된 검토 모드이며 기본값은 사용자의 정책에 따라 제어됩니다. Moderation 객체를 사용합니다. 검토 모드가 사용 설정된 경우 회의 소유자는 공동 호스트 관리 (spaces.members 참고) 및 기능 제한 (moderationRestrictions 참고)과 같은 기능을 사용하여 회의를 관리할 수 있습니다. 구성원에 관한 자세한 내용은 스페이스 구성원 관리를 참고하세요.
moderationRestrictions 필드는 moderation가 사용 설정된 경우 회의에 대한 검토 제한을 적용합니다. ModerationRestrictions 객체를 사용합니다. 제한사항에 따라 채팅 메시지 및 반응을 보내고 화면을 공유할 권한이 있는 사용자와 사용자에게 시청자로 할당된 기본 역할을 제한할지 여부가 정의됩니다. moderationRestrictions 필드는 RestrictionType를 사용하여 처음 세 가지 제한을 적용합니다. RestrictionType는 회의 소유자 및 공동 호스트 또는 모든 참석자에게 적용할 수 있습니다. DefaultJoinAsViewerType는 사용자가 기본적으로 참여자로 참여하지만 호스트가 시청자로 참여하도록 제한할 수도 있는 최종 권한을 적용합니다.
firstJoinerType 필드는 사용자가 이 회의 스페이스의 회의에 호스트보다 먼저 참여할 수 있는지 여부를 설정합니다. 먼저 회의에 참여할 수 있는 사용자와 다른 사용자가 대기 상태인지를 정의합니다. FirstJoinerType 객체를 사용합니다.
스페이스 구성원 관리하기
회의 소유자는 언제든지 노크 없이 회의에 참여할 수 있었지만 이제 노크 없이 회의에 참여할 수 있는 구성원도 구성할 수 있습니다. 또한 회의에서 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를 사용합니다. 필드 마스크는 API 호출자가 요청이 반환해야 하는 필드를 나열하는 방식입니다. 쉼표로 구분된 필드 목록으로, 객체의 특정 필드만 사용하고 다른 필드는 변경하지 않도록 지정합니다.
FieldMask를 사용하면 API가 불필요한 작업을 피하고 성능을 개선할 수 있습니다. 필드 마스크는 생성, 가져오기, 목록 메서드에 사용됩니다. 필드 마스크에 관한 자세한 내용은 Google Sheets API의 필드 마스크 사용을 참고하세요.