REST Resource: spaces

리소스: 스페이스

회의가 개최되는 가상 장소입니다. 언제든지 하나의 스페이스에서 하나의 활성 회의만 개최할 수 있습니다.

JSON 표현 
{
  "name": string,
  "meetingUri": string,
  "meetingCode": string,
  "config": {
    object (SpaceConfig)
  },
  "activeConference": {
    object (ActiveConference)
  },
  "phoneAccess": [
    {
      object (PhoneAccess)
    }
  ],
  "gatewaySipAccess": [
    {
      object (GatewaySipAccess)
    }
  ]
}
필드
name

string

변경할 수 없습니다. 스페이스의 리소스 이름입니다.

형식은 spaces/{space}입니다.

{space}는 스페이스의 리소스 식별자입니다. 서버에서 생성된 고유 ID이며 대소문자를 구분합니다. 예를 들면 다음과 같습니다. jQCFfuBOdN5z

자세한 내용은 Meet에서 회의 공간을 식별하는 방법을 참고하세요.
meetingUri

string

출력 전용입니다. https://meet.google.com/ 뒤에 meetingCode이 오는 회의에 참여하는 데 사용되는 URI입니다. 예를 들면 https://meet.google.com/abc-mnop-xyz입니다.
meetingCode

string

출력 전용입니다. 회의에 참여하는 데 사용되는 친숙한 고유 문자열 유형입니다.

형식은 [a-z]+-[a-z]+-[a-z]+입니다. 예를 들면 다음과 같습니다. abc-mnop-xyz

최대 길이는 128자(영문 기준)입니다.

스페이스를 가져오기 위한 스페이스 이름의 별칭으로만 사용할 수 있습니다.
config

object (SpaceConfig)

회의 스페이스와 관련된 구성입니다.
activeConference

object (ActiveConference)

활성 회의(있는 경우)
phoneAccess[]

object (PhoneAccess)

출력 전용입니다. 이 회의 스페이스의 모든 지역 전화 액세스 방법입니다. 비어 있을 수 있습니다.
gatewaySipAccess[]

object (GatewaySipAccess)

출력 전용입니다. 회의에 참여하는 데 사용할 수 있는 SIP 기반 액세스 방법입니다. 비어 있을 수 있습니다.

SpaceConfig

회의 공간과 관련된 구성입니다.

JSON 표현 
{
  "accessType": enum (AccessType),
  "entryPointAccess": enum (EntryPointAccess),
  "moderation": enum (Moderation),
  "moderationRestrictions": {
    object (ModerationRestrictions)
  },
  "attendanceReportGenerationType": enum (AttendanceReportGenerationType),
  "artifactConfig": {
    object (ArtifactConfig)
  }
}
필드
accessType

enum (AccessType)

노크 없이 참여할 수 있는 사용자를 결정하는 회의 스페이스의 액세스 유형입니다. 기본값: 사용자의 기본 액세스 설정입니다. 엔터프라이즈 사용자의 경우 사용자의 관리자가 제어하거나 제한됩니다.
entryPointAccess

enum (EntryPointAccess)

이 회의 스페이스에서 호스팅되는 회의에 참여하는 데 사용할 수 있는 진입점을 정의합니다. 기본값: EntryPointAccess.ALL
moderation

enum (Moderation)

회의에 대해 사전 구성된 진행 모드입니다. 기본값: 사용자의 정책에 따라 제어됩니다.
moderationRestrictions

object (ModerationRestrictions)

moderation.ON인 경우 이러한 제한사항이 회의에 적용됩니다. moderation.OFF인 경우 기본 ModerationRestrictions로 재설정됩니다.
attendanceReportGenerationType

enum (AttendanceReportGenerationType)

회의실에 참석 보고서가 사용 설정되어 있는지 여부입니다.
artifactConfig

object (ArtifactConfig)

회의에서 지원하는 자동 생성 아티팩트와 관련된 구성입니다.

AccessType

회의실의 가능한 액세스 유형입니다.

열거형
ACCESS_TYPE_UNSPECIFIED 사용자 조직에서 지정한 기본값입니다. 참고: 구성된 액세스 유형이 대신 반환되므로 이는 반환되지 않습니다.
OPEN 참여 정보 (예: URL 또는 전화 액세스 정보)가 있는 사용자는 노크 없이 참여할 수 있습니다.
TRUSTED 호스트의 조직 구성원, 초대된 외부 사용자, 전화 접속 사용자는 참여 요청 없이 참여할 수 있습니다. 그 외 모든 사용자는 노크해야 합니다.
RESTRICTED 초대받은 사용자만 노크 없이 참여할 수 있습니다. 그 외 모든 사용자는 노크해야 합니다.

EntryPointAccess

회의에 참여하는 데 사용할 수 있는 진입점입니다. 예: meet.google.com, Meet Embed SDK Web 또는 모바일 애플리케이션

열거형
ENTRY_POINT_ACCESS_UNSPECIFIED 사용하지 않습니다.
ALL 모든 진입점이 허용됩니다.
CREATOR_APP_ONLY 스페이스를 만든 Google Cloud 프로젝트가 소유한 진입점만 이 스페이스의 회의에 참여하는 데 사용할 수 있습니다. 앱은 Meet 삽입 SDK 웹 또는 모바일 Meet SDK를 사용하여 소유한 진입점을 만들 수 있습니다.

검토

회의의 조정 모드입니다. 조정 모드가 사용 설정되면 회의 소유자는 공동 호스트 관리 (메시지 Member 참고) 및 기능 제한 (메시지 ModerationRestrictions 참고)과 같은 기능을 통해 회의를 더 효과적으로 관리할 수 있습니다.

열거형
MODERATION_UNSPECIFIED 조정 유형이 지정되지 않았습니다. 이는 사용자가 상태를 업데이트할 의도가 없으므로 값을 지정하지 않았음을 나타내는 데 사용됩니다. 사용자는 값을 unspecified로 설정할 수 없습니다.
OFF 검토가 사용 중지되어 있습니다.
ON 검토가 사용 설정되어 있습니다.

ModerationRestrictions

회의가 조정될 때 기능에 대한 제한을 정의합니다.

JSON 표현 
{
  "chatRestriction": enum (RestrictionType),
  "reactionRestriction": enum (RestrictionType),
  "presentRestriction": enum (RestrictionType),
  "defaultJoinAsViewerType": enum (DefaultJoinAsViewerType)
}
필드
chatRestriction

enum (RestrictionType)

회의 스페이스에서 채팅 메시지를 보낼 권한이 있는 사용자를 정의합니다.
reactionRestriction

enum (RestrictionType)

회의 스페이스에서 반응을 보낼 권한이 있는 사용자를 정의합니다.
presentRestriction

enum (RestrictionType)

회의 스페이스에서 화면을 공유할 수 있는 권한이 있는 사용자를 정의합니다.
defaultJoinAsViewerType

enum (DefaultJoinAsViewerType)

사용자에게 할당된 기본 역할을 보기 권한으로 제한할지 여부를 정의합니다.

RestrictionType

특정 기능을 사용할 수 있는 권한이 있는 사용자를 결정합니다.

열거형
RESTRICTION_TYPE_UNSPECIFIED 사용자 정책에 의해 지정된 기본값입니다. 이 값은 반환되지 않아야 합니다.
HOSTS_ONLY 회의 소유자와 공동 호스트에게 권한이 있습니다.
NO_RESTRICTION 모든 참여자에게 권한이 있습니다.

DefaultJoinAsViewerType

기본적으로 사용자는 참여자로 참여합니다. 호스트는 사용자가 참관자로만 참여하도록 제한할 수 있습니다. 참고: Member 리소스에서 사용자에게 명시적 역할이 설정된 경우 사용자는 해당 역할로 참여합니다.

열거형
DEFAULT_JOIN_AS_VIEWER_TYPE_UNSPECIFIED 사용자 정책에 의해 지정된 기본값입니다. 이 값은 반환되지 않아야 합니다.
ON 사용자는 기본적으로 참관자로 참여합니다.
OFF 사용자는 기본적으로 참여자로 참여합니다.

AttendanceReportGenerationType

회의실에 참석 보고서가 사용 설정되어 있는지 여부의 가능한 상태입니다.

열거형
ATTENDANCE_REPORT_GENERATION_TYPE_UNSPECIFIED 사용자 정책에 의해 지정된 기본값입니다. 이 값은 반환되지 않아야 합니다.
GENERATE_REPORT 참석 보고서가 생성되어 드라이브/이메일로 전송됩니다.
DO_NOT_GENERATE 참석 보고서가 생성되지 않습니다.

ArtifactConfig

이 회의 스페이스에서 생성될 수 있는 회의 아티팩트와 관련된 구성입니다.

JSON 표현 
{
  "recordingConfig": {
    object (RecordingConfig)
  },
  "transcriptionConfig": {
    object (TranscriptionConfig)
  },
  "smartNotesConfig": {
    object (SmartNotesConfig)
  }
}
필드
recordingConfig

object (RecordingConfig)

녹화 구성입니다.
transcriptionConfig

object (TranscriptionConfig)

자동 스크립트 구성입니다.
smartNotesConfig

object (SmartNotesConfig)

자동 회의록 구성입니다.

RecordingConfig

회의 스페이스의 녹화와 관련된 구성입니다.

JSON 표현 
{
  "autoRecordingGeneration": enum (AutoGenerationType)
}
필드
autoRecordingGeneration

enum (AutoGenerationType)

녹화 권한이 있는 사용자가 회의에 참여할 때 회의 스페이스가 자동으로 녹화되는지 정의합니다.

AutoGenerationType

회의 스페이스에서 아티팩트가 자동으로 생성될 수 있는지 여부를 결정합니다.

열거형
AUTO_GENERATION_TYPE_UNSPECIFIED 사용자 정책에 의해 지정된 기본값입니다. 이 값은 반환되지 않아야 합니다.
ON 아티팩트는 자동으로 생성됩니다.
OFF 아티팩트는 자동으로 생성되지 않습니다.

TranscriptionConfig

회의 스페이스의 스크립트 작성과 관련된 구성입니다.

JSON 표현 
{
  "autoTranscriptionGeneration": enum (AutoGenerationType)
}
필드
autoTranscriptionGeneration

enum (AutoGenerationType)

스크립트 작성 권한이 있는 사용자가 회의에 참여할 때 회의 콘텐츠가 자동으로 스크립트로 작성되는지 정의합니다.

SmartNotesConfig

회의 스페이스의 자동 회의록과 관련된 구성입니다. 스마트 메모에 관한 자세한 내용은 Google Meet의 '자동 회의록'을 참고하세요.

JSON 표현 
{
  "autoSmartNotesGeneration": enum (AutoGenerationType)
}
필드
autoSmartNotesGeneration

enum (AutoGenerationType)

스마트 회의록을 사용 설정할 권한이 있는 사용자가 회의에 참여할 때 조직의 모든 초대 대상자를 대상으로 회의 요약 및 간단한 요약을 자동으로 생성할지 여부를 정의합니다.

ActiveConference

활성 회의

JSON 표현 
{
  "conferenceRecord": string
}
필드
conferenceRecord

string

출력 전용입니다. 'ConferenceRecord' 리소스에 대한 참조입니다. 형식: conferenceRecords/{conferenceRecord}(여기서 {conferenceRecord}은 스페이스 내 통화의 각 인스턴스에 대한 고유 ID임)

PhoneAccess

전화 액세스에는 지역 전화번호와 해당 전화번호에 고유한 PIN을 사용하여 회의에 전화를 거는 데 필요한 정보가 포함되어 있습니다.

JSON 표현 
{
  "phoneNumber": string,
  "pin": string,
  "regionCode": string,
  "languageCode": string
}
필드
phoneNumber

string

이 회의 공간에 다이얼할 전화번호입니다(E.164 형식). 앞에 '+' 문자가 있는 전체 전화번호입니다.
pin

string

사용자가 지정된 번호를 다이얼한 후 입력해야 하는 PIN입니다. PIN은 10진수 숫자만으로 구성되며 길이는 다를 수 있습니다.
regionCode

string

이 전화 액세스와 연결된 국가의 CLDR/ISO 3166 지역 코드입니다. i18n RegionCode 유틸리티로 파싱됩니다. 예: 스웨덴의 경우 'SE'
languageCode

string

이 전화 액세스와 연결된 언어의 BCP 47/LDML 언어 코드입니다. i18n LanguageCode 유틸리티로 파싱됩니다. 예: 라틴 아메리카 스페인어의 경우 'es-419', 캐나다 프랑스어의 경우 'fr-CA'

GatewaySipAccess

SIP 게이트웨이를 통해 회의에 참여하는 방법을 자세히 설명합니다.

JSON 표현 
{
  "uri": string,
  "sipAccessCode": string
}
필드
uri

string

회의에 연결할 수 있는 세션 시작 프로토콜 (SIP) URI입니다.

문자열은 다음 형식 중 하나입니다.

여기서 USER_ID는 13자리 범용 PIN이며 (향후 Meet 회의 코드를 사용하는 옵션도 지원 예정) GATEWAY_ADDRESS는 DNS SRV 조회를 사용하여 확인되는 유효한 주소 또는 점으로 구분된 4자리 숫자입니다.
sipAccessCode

string

특별히 구성된 기기에서 수동으로 입력하는 데 사용되는 영구 숫자 코드입니다.

메서드

create

 스페이스를 만듭니다.

endActiveConference

 진행 중인 회의를 종료합니다 (있는 경우).

get

 회의 스페이스에 관한 세부정보를 가져옵니다.

patch

 회의 스페이스에 관한 세부정보를 업데이트합니다.