회의 스페이스 설정 구성하기

회의 공간은 회의가 열리는 가상 장소 또는 지속적인 객체 (예: 회의실)를 나타냅니다. 회의 공간은 사용자가 만나서 공유 리소스를 찾는 데도 도움이 됩니다.

spaces.create 메서드를 사용하여 회의 스페이스를 만들면 spaces 리소스의 인스턴스가 반환됩니다. 리소스에는 회의 공간의 구성인 SpaceConfig 객체가 포함됩니다. 또한 회의 공간 내 현재 conferenceRecords 리소스로 연결되는 링크인 ActiveConference 객체가 포함되어 있습니다. 회의 공간 관리에 대한 자세한 내용은 회의 공간 관리를 참고하세요.

다음 섹션에서는 이러한 객체와 메서드를 사용하여 회의실을 구성하는 방법을 자세히 설명합니다.

진행 및 회의 액세스 설정

SpaceConfig 객체를 통해 사용자가 회의에 참여하는 방법, 조정 모드, 기능 제한, 사용자가 회의에 참여할 때 부여되는 권한을 설정할 수 있습니다.

회의 액세스 구성

노크 없이 회의 스페이스에 참여할 수 있는 사용자를 확인하려면 AccessType 객체를 사용하여 accessType 필드를 설정합니다. 참석자의 자동 참여 허용 여부에 관한 여러 설정을 선택할 수 있습니다. 이 필드는 기본적으로 사용자의 기본 액세스 설정으로 설정됩니다.

회의 스페이스에서 호스팅되는 회의에 참여하는 데 사용할 수 있는 진입점을 정의하려면 EntryPointAccess 객체를 사용하여 entryPointAccess 필드를 설정합니다. 모든 진입점을 허용하려면 ALL로 설정하고, 회의 스페이스를 만든 Google Cloud 프로젝트가 소유한 진입점으로만 범위를 지정하려면 CREATOR_APP_ONLY로 설정합니다.

다음 코드 샘플은 회의실의 액세스 설정을 구성하는 방법을 보여줍니다.

자바

import com.google.apps.meet.v2.Space;
import com.google.apps.meet.v2.SpaceConfig;
import com.google.apps.meet.v2.SpacesServiceClient;
import com.google.apps.meet.v2.UpdateSpaceRequest;
import com.google.protobuf.FieldMask;

public class ConfigureSpaceAccess {
  public static void main(String[] args) throws Exception {
    try (SpacesServiceClient client = SpacesServiceClient.create()) {
      Space space =
          Space.newBuilder()
              .setName("spaces/SPACE_NAME")
              .setConfig(
                  SpaceConfig.newBuilder()
                      .setAccessType(SpaceConfig.AccessType.RESTRICTED)
                      .setEntryPointAccess(SpaceConfig.EntryPointAccess.ALL)
                      .build())
              .build();
      FieldMask updateMask =
          FieldMask.newBuilder()
              .addPaths("config.access_type")
              .addPaths("config.entry_point_access")
              .build();
      UpdateSpaceRequest request =
          UpdateSpaceRequest.newBuilder()
              .setSpace(space)
              .setUpdateMask(updateMask)
              .build();
      Space response = client.updateSpace(request);
      System.out.println("Updated space: " + response.getName());
    }
  }
}

Node.js

const {SpacesServiceClient} = require('@google-apps/meet').v2;

async function configureSpaceAccess(spaceName) {
  const meetClient = new SpacesServiceClient();
  const [response] = await meetClient.updateSpace({
    space: {
      name: spaceName,
      config: {
        accessType: 'RESTRICTED',
        entryPointAccess: 'ALL',
      },
    },
    updateMask: {
      paths: ['config.access_type', 'config.entry_point_access'],
    },
  });
  console.log(`Updated space: ${response.name}`);
  return response;
}

Python

from google.apps import meet_v2
from google.protobuf import field_mask_pb2

def configure_space_access(space_name):
    client = meet_v2.SpacesServiceClient()
    space = meet_v2.Space(
        name=space_name,
        config=meet_v2.SpaceConfig(
            access_type=meet_v2.SpaceConfig.AccessType.RESTRICTED,
            entry_point_access=meet_v2.SpaceConfig.EntryPointAccess.ALL,
        ),
    )
    update_mask = field_mask_pb2.FieldMask(
        paths=["config.access_type", "config.entry_point_access"]
    )
    request = meet_v2.UpdateSpaceRequest(
        space=space,
        update_mask=update_mask
    )
    response = client.update_space(request=request)
    print(f"Updated space: {response.name}")
    return response

Apps Script

function configureSpaceAccess(spaceName) {
  const baseUrl = 'https://meet.googleapis.com/v2/';
  const mask = 'updateMask=config.accessType,config.entryPointAccess';
  const response = UrlFetchApp.fetch(`${baseUrl}${spaceName}?${mask}`, {
    method: 'patch',
    contentType: 'application/json',
    headers: {
      Authorization: 'Bearer ' + ScriptApp.getOAuthToken(),
    },
    payload: JSON.stringify({
      config: {
        accessType: 'RESTRICTED',
        entryPointAccess: 'ALL',
      },
    }),
  });
  const space = JSON.parse(response.getContentText());
  Logger.log('Updated space: ' + space.name);
  return space;
}

cURL

curl -X PATCH \
  "https://meet.googleapis.com/v2/spaces/SPACE_NAME?updateMask=config.accessType,config.entryPointAccess" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "accessType": "RESTRICTED",
      "entryPointAccess": "ALL"
    }
  }'

ACCESS_TOKEN를 API에 대한 액세스 권한을 부여하는 액세스 토큰으로 바꿉니다.

스페이스 이름을 회의 스페이스의 고유한 서버 생성 ID로 바꿉니다.

검토 설정 구성

회의를 관리하려면 Moderation 객체를 사용하여 moderation 필드를 설정하면 됩니다. moderation 모드가 on인 경우 회의 주최자는 공동 호스트 관리 (spaces.members 참고) 및 moderationRestrictions 필드를 사용한 기능 제한과 같은 기능을 사용하여 회의를 관리할 수 있습니다. 구성원에 관한 자세한 내용은 회의 스페이스 구성원 관리를 참고하세요.

회의가 조정될 때 (moderation가 on인 경우) 기능 제한을 정의하려면 ModerationRestrictions 객체를 사용하여 moderationRestrictions 필드를 설정합니다. 제한사항은 회의 스페이스 내에서 채팅 메시지나 반응을 보내거나 화면을 공유할 수 있는 사용자를 정의합니다.

moderationRestrictions 필드에 기능 제한을 설정하려면 RestrictionType를 사용하여 chatRestriction, reactionRestriction, presentRestriction를 적용합니다. 회의 주최자와 공동 호스트 모두에게 권한을 적용하려면 HOSTS_ONLY로 설정하고 모든 참여자에게 적용하려면 NO_RESTRICTION로 설정합니다.

사용자에게 할당된 기본 역할을 보기 권한 사용자로 제한하려면 DefaultJoinAsViewerType를 사용하여 defaultJoinAsViewerType 필드를 설정합니다. defaultJoinAsViewerType이 on인 경우 사용자는 시청자로 참여합니다. off인 경우 사용자가 참여자로 참여합니다. 기본값은 off입니다. spaces.members에서 사용자에게 명시적 역할이 설정된 경우 사용자는 해당 역할로 참여합니다.

출석 보고서 구성

회의 공간의 출석 보고서를 만들려면 AttendanceReportGenerationType 객체를 사용하여 attendanceReportGenerationType 필드를 설정합니다. 보고서가 요청되면 Google Meet에서 참석 보고서를 회의 주최자의 Google Drive에 저장하고 이메일도 전송합니다.

자동 아티팩트 관리

회의 주최자는 공동 호스트와 달리 회의 스페이스 내에서 자동 녹화, 자동 스크립트, 자동 회의록을 사전 구성할 수 있습니다. 이러한 설정을 사용 설정하면 회의 스페이스가 녹화되고, 스크립트가 생성되며, 회의록이 캡처되어 Google Docs에 자동으로 정리됩니다. 각 기능은 독립적이며 회의실별로 설정됩니다. 녹화 콘텐츠의 자막은 영어로만 제공됩니다.

회의 스페이스를 만들 때 또는 회의 스페이스가 만들어진 후에 자동 아티팩트를 사전 구성할 수 있습니다. 두 메서드 모두 meetings.space.settings OAuth 범위가 필요합니다. 자세한 내용은 사용 사례별 OAuth 범위를 참고하세요.

Google Calendar에서 만든 회의에 대해 자동 아티팩트를 설정할 수도 있습니다.

자동 아티팩트를 설정하려면 SpaceConfig 객체 내에서 ArtifactConfig 객체를 사용합니다. ArtifactConfig은 recordingConfig, transcriptionConfig, smartNotesConfig 필드로 구성됩니다.

각 필드는 RecordingConfig, TranscriptionConfig, SmartNotesConfig과 같은 유사한 객체에 매핑됩니다. 각 객체를 설정하려면 AutoGenerationType를 사용하여 구성 객체 on 또는 off를 전환합니다.

회의 중에 생성된 아티팩트를 가져오려면 아티팩트 작업을 참고하세요.

스크립트와 스마트 메모의 차이점

회의 스크립트와 자동 회의록('회의록 작성'이라고도 함)은 모두 회의에서 정보를 캡처하지만, 이러한 기능은 서로 다른 목적으로 사용되며 서로 다른 아티팩트를 생성합니다.

다음 표는 두 인터페이스의 차이점을 보여줍니다.

기능 스크립트 스마트 노트
개요 단어 하나하나를 그대로 기록합니다. Gemini가 생성한 핵심 사항의 간결한 요약
세부사항 수준 100% 세부정보 말한 내용은 모두 기록됩니다. 상위 수준 결정 사항과 작업 항목에 중점을 둡니다.
사용 사례 법적 규정 준수, 정확한 인용구 확인, 사용자 접근성 늦게 참여한 사용자가 즉시 따라잡을 수 있도록 지원하며 회의록 작성 및 프로젝트 추적을 자동화합니다.
실시간 사용량 자막에 사용됩니다. 파일은 통화 후에 생성됩니다. 통화 중에 측면 패널에서 요약 빌드를 확인할 수 있습니다.
출력 화자 이름과 타임스탬프가 포함된 긴 Docs 문서 섹션과 글머리 기호가 있는 간결한 회의록 Docs 문서
인용 연결할 수 있는 전체 텍스트를 포함합니다. 스크립트와 자동 회의록이 모두 사용 설정된 경우 컨텍스트를 위해 스크립트의 특정 순간으로 다시 연결되는 인용 (타임스탬프)이 포함됩니다. 자세한 내용은 두 기능이 모두 사용 설정된 경우를 참고하세요.

두 기능이 모두 사용 설정된 경우

각 기능을 별도로 사용할 수도 있지만, 회의 후 아티팩트를 더 효과적으로 만들기 위해 스크립트와 자동 회의록을 동시에 사용할 수도 있습니다.

두 기능이 모두 사용 설정된 경우 생성된 스마트 메모 문서에 인용이 표시됩니다. 이러한 인용은 세부정보 섹션 전체에 표시되며 회의 스크립트의 특정 타임스탬프로 연결됩니다. 해당 인용을 클릭하면 스크립트의 관련 섹션으로 바로 이동하여 회의 내용을 더 자세히 알아볼 수 있습니다.

회의 중에 참여자에게 두 기능이 모두 활성화되어 있음을 나타내는 표시기가 표시됩니다. 클릭 가능한 인용을 생성하려면 회의 기간 동안 활성 상태를 유지해야 합니다. 파일이 서로 연결되어 있더라도 시스템에서는 호스트의 Drive에 서로 다른 두 문서를 생성합니다. 두 파일 모두 Calendar 일정에 자동으로 첨부됩니다.

회의실 및 설정에 필요한 OAuth 범위에 대한 자세한 내용은 사용 사례별 OAuth 범위를 참고하세요.