회의 공간은 회의가 열리는 가상 장소 또는 영구 객체 (예: 회의실)를 나타냅니다. 한 공간에서 한 번에 하나의 회의만 진행할 수 있습니다. 회의 공간은 사용자가 공유 리소스를 찾고 만나는 데도 도움이 됩니다.
다음 섹션에서는 회의 공간을 만들고, 가져오고, 업데이트하는 방법을 자세히 설명합니다.
Meet에서 회의 스페이스를 식별하는 방법
Google Meet REST API는 각 회의 공간에 대해 spaces
리소스를 생성합니다. name
필드는 리소스의 리소스 이름입니다.
다음은 name
필드를 사용하여 회의 공간을 식별하는 두 가지 중요한 방법입니다.
space
는spaces/{space}
형식의 스페이스 리소스 식별자입니다. 서버에서 생성된 고유 ID이며 대소문자가 구분됩니다.spaces/jQCFfuBOdN5z
를 예로 들 수 있습니다.meetingCode
은 스페이스의 별칭으로spaces/{meetingCode}
형식입니다. 대소문자를 구분하지 않는 입력 가능한 고유한 문자열입니다.abc-mnop-xyz
를 예로 들 수 있습니다. 최대 길이는 128자(영문 기준)입니다.meetingUri
:https://meet.google.com/abc-mnop-xyz
의 일부를 형성합니다.
회의 스페이스를 관리하려면 {name}
필드에 다음 값을 사용합니다.
회의 공간에 대한 세부정보를 가져오려면
spaces/{space}
또는 별칭spaces/{meetingCode}
를 사용하면 됩니다. 자세한 내용은 회의 공간 가져오기를 참고하세요.회의 공간의 세부정보를 업데이트하려면
spaces/{space}
만 사용할 수 있습니다. 자세한 내용은 회의 공간 업데이트를 참고하세요.회의 공간 내에서 진행 중인 회의를 종료하려면
spaces/{space}
만 사용할 수 있습니다. 자세한 내용은 진행 중인 회의 종료를 참고하세요.
회의 공간 만들기
회의 공간을 만들려면 spaces
리소스에서 create
메서드를 사용합니다.
이 메서드는 회의 공간의 구성인 SpaceConfig
객체가 포함된 spaces
리소스의 인스턴스를 반환합니다. 또한 회의 공간 내 현재 conferenceRecords
리소스로 연결되는 ActiveConference
객체도 포함되어 있습니다.
다음 코드 샘플은 회의 공간을 만드는 방법을 보여줍니다.
자바
Node.js
Python
회의 공간 가져오기
회의 공간에 대한 세부정보를 가져오려면 지정된 name
을 사용하여 spaces
리소스의 get
메서드를 사용합니다.
자세한 내용은 Meet에서 회의 공간을 식별하는 방법을 참고하세요.
이 메서드는 회의 공간을 space
리소스의 인스턴스로 반환합니다.
다음 코드 샘플은 회의 공간을 검색하는 방법을 보여줍니다.
자바
Node.js
Python
스페이스 이름을 회의 스페이스의 고유한 서버 생성 ID로 바꿉니다.
회의 공간 업데이트
회의 공간의 세부정보를 업데이트하려면 지정된 name
를 사용하여 spaces
리소스의 patch
메서드를 사용합니다.
자세한 내용은 Meet에서 회의 공간을 식별하는 방법을 참고하세요.
patch
메서드는 선택적 updateMask
매개변수도 사용합니다. 필드 유형은 FieldMask
입니다.
스페이스에서 업데이트하려는 필드의 쉼표로 구분된 목록입니다.
이 메서드는 회의 공간을 spaces
리소스의 인스턴스로 반환합니다.
다음 코드 샘플은 회의 공간을 업데이트하는 방법을 보여줍니다.
자바
Node.js
Python
스페이스 이름을 회의 스페이스의 고유한 서버 생성 ID로 바꿉니다.
진행 중인 회의 종료
회의 공간 내에서 진행 중인 회의를 종료하려면 spaces
리소스에서 spaces.endActiveConference
메서드를 사용합니다. 요청 본문과 응답 본문이 모두 비어 있습니다. 자세한 내용은 Meet에서 회의 공간을 식별하는 방법을 참고하세요.
다음 코드 샘플은 진행 중인 회의를 종료하는 방법을 보여줍니다.
자바
Node.js
Python
스페이스 이름을 회의 스페이스의 고유한 서버 생성 ID로 바꿉니다.