이 가이드에서는 Google Meet REST API를 사용하여 회의에서 생성된 다양한 회의 아티팩트에 관한 세부정보를 가져오는 방법을 설명합니다.
아티팩트는 회의에 대한 응답으로 Google Meet에서 생성하는 파일 또는 데이터입니다. 여기에는 동영상과 스크립트와 같은 기타 아티팩트가 포함됩니다.
아티팩트를 생성하려면 회의가 끝나기 전에 참여자가 Meet에서 생성해야 합니다. 스크립트는 녹화와 별개로 작동하며 회의를 녹화하지 않아도 스크립트를 생성할 수 있습니다. 자세한 내용은 화상 회의 녹화하기 및 Google Meet에서 스크립트 사용하기를 참고하세요.
회의 공간 소유자 또는 참여자는 recordings
, transcripts
, transcripts.entries
리소스에서 get()
및 list()
메서드를 호출하여 아티팩트를 가져올 수 있습니다.
사용자 인증 정보로 인증하고 승인하면 Google Meet 앱이 사용자 데이터에 액세스하고 인증된 사용자를 대신하여 작업을 실행할 수 있습니다. 도메인 전체 위임으로 인증하면 각 사용자의 동의를 받지 않고도 애플리케이션의 서비스 계정이 사용자의 데이터에 액세스하도록 승인할 수 있습니다.
아티팩트 보관
회의가 끝나면 Meet에서 녹화 파일과 스크립트를 회의 주최자의 Google Drive에 저장합니다. 기본적으로 Meet 아티팩트는 Drive 규칙에 따라 보관됩니다.
Meet REST API에서 제공하는 스크립트 항목은 회의가 종료된 후 30일 후에 삭제됩니다.
Google Vault에서 Meet용 보관 규칙을 사용하여 Meet 아티팩트의 보관 기간을 별도로 관리할 수도 있습니다. 자세한 내용은 Vault를 사용하여 Google Meet 데이터 보관하기를 참고하세요.
녹화
다음 섹션에서는 회의 레코드에서 녹화에 관한 정보를 가져오는 방법을 자세히 설명합니다.
Meet은 녹화 파일이 생성된 후 녹화 ID에 액세스할 수 있습니다. 사용자가 Google Drive에서 녹화 파일을 삭제했지만 Meet에서 고유한 이름이 계속 반환될 수 있습니다.
recordings
리소스에는 DriveDestination
객체와 State
객체가 모두 포함됩니다.
DriveDestination
객체는 녹화 파일이 MP4 파일로 저장되는 Drive의 내보내기 위치를 보유합니다. 녹음 파일을 다운로드하거나 브라우저에서 재생하려면 객체의 exportUri
필드 값을 사용하세요. Google Drive API에 익숙한 경우 file
필드 값은 files
리소스의 id
에 해당합니다. 자세한 내용은 파일 다운로드 및 내보내기를 참고하세요.
State
객체는 녹음 세션의 상태를 보유합니다. 이를 통해 녹음이 시작되었는지, 녹음이 종료되었지만 녹음 파일이 준비되지 않았는지, 녹음 파일이 생성되어 다운로드할 준비가 되었는지 쿼리할 수 있습니다.
녹화에 대한 세부정보 가져오기
특정 녹화에 대한 세부정보를 가져오려면 name
경로 매개변수를 사용하여 recordings
리소스의 get()
메서드를 사용합니다. 녹음 파일 이름을 모르는 경우 list()
메서드를 사용하여 모든 녹음 파일 이름을 나열할 수 있습니다.
이 메서드는 recordings
리소스의 인스턴스를 반환합니다.
다음 코드 샘플은 특정 녹화 파일을 검색하는 방법을 보여줍니다.
자바
Node.js
Python
회의 레코드에서 녹화 파일 이름을 특정 녹화 ID의 이름으로 바꿉니다.
모든 녹화 파일 목록 보기
회의 레코드의 모든 녹화에 관한 세부정보를 나열하려면 parent
경로 매개변수를 사용하여 recordings
리소스의 list()
메서드를 사용합니다. 형식은 conferenceRecords/{conferenceRecord}
입니다.
이 메서드는 startTime
를 기준으로 오름차순으로 정렬된 회의 녹화 파일 목록을 recordings
리소스의 인스턴스로 반환합니다. 페이지 크기를 조정하려면 페이징 맞춤설정 을 참고하세요.
다음 코드 샘플은 회의 기록의 모든 녹화 파일을 나열하는 방법을 보여줍니다.
자바
Node.js
Python
상위 값을 회의 레코드 이름으로 바꿉니다.
스크립트
다음 섹션에서는 회의 기록에서 회의 스크립트에 관한 정보를 가져오는 방법을 자세히 설명합니다.
스크립트 데이터가 생성되면 Meet에서 스크립트 ID에 액세스할 수 있습니다. 사용자가 Drive에서 스크립트 파일을 삭제해도 Meet에서는 고유한 이름이 계속 반환될 수 있습니다.
transcripts
리소스에는 DocsDestination
객체와 State
객체가 모두 포함됩니다.
DocsDestination
객체는 Google Docs 스크립트 파일이 저장되는 Drive의 내보내기 위치를 보유합니다. 브라우저에서 콘텐츠를 가져오거나 스크립트를 탐색하려면 객체의 exportUri
필드 값을 사용합니다. Google Docs API에 익숙한 경우 document
필드 값은 documents
리소스의 documentId
에 해당합니다.
State
객체는 스크립트 세션의 상태를 보유합니다. 이를 통해 스크립트 세션이 시작되었는지, 스크립트 세션이 종료되었지만 스크립트 파일이 준비되지 않았는지, 스크립트 파일이 생성되어 다운로드할 준비가 되었는지 쿼리할 수 있습니다.
스크립트 세부정보 가져오기
특정 스크립트에 대한 세부정보를 가져오려면 name
경로 매개변수를 사용하여 transcripts
리소스의 get()
메서드를 사용합니다. 스크립트 이름을 모르는 경우 list()
메서드를 사용하여 모든 스크립트 이름을 나열할 수 있습니다.
이 메서드는 transcripts
리소스의 인스턴스를 반환합니다.
다음 코드 샘플은 특정 스크립트를 검색하는 방법을 보여줍니다.
자바
Node.js
Python
회의 기록에서 스크립트 이름을 특정 스크립트 ID의 이름으로 바꿉니다.
모든 스크립트 목록
회의 기록의 모든 스크립트에 관한 세부정보를 나열하려면 parent
경로 매개변수를 사용하여 transcripts
리소스의 list()
메서드를 사용합니다. 형식은 conferenceRecords/{conferenceRecord}
입니다.
이 메서드는 startTime
를 기준으로 오름차순으로 정렬된 회의 스크립트 목록을 transcripts
리소스의 인스턴스로 반환합니다. 페이지 크기를 조정하려면 페이징 맞춤설정 을 참고하세요.
다음 코드 샘플은 회의 기록의 모든 스크립트를 나열하는 방법을 보여줍니다.
자바
Node.js
Python
상위 값을 회의 레코드 이름으로 바꿉니다.
스크립트 항목
다음 섹션에서는 회의 스크립트 세션 중에 각 참여자의 발화를 스크립트 항목으로 가져오는 방법을 자세히 설명합니다.
스크립트 항목에는 참여자의 음성에서 스크립트로 변환된 텍스트가 최대 10,000단어까지 포함됩니다. 음성 텍스트 languageCode
(예: en-US
)도 IETF BCP 47 문법으로 포함됩니다.
각 스크립트 항목은 회의의 participant
이름에 연결됩니다. 참여자 세부정보를 검색하려면 참여자 세부정보 가져오기를 참고하세요.
스크립트 항목 데이터는 회의가 종료된 후 30일 동안 사용할 수 있습니다.
Meet REST API에서 반환된 스크립트 항목이 Docs 스크립트 파일에 있는 스크립트와 일치하지 않을 수 있습니다. 이는 스크립트 파일이 생성된 후 수정될 때 발생합니다.
스크립트 항목에 대한 세부정보 가져오기
특정 스크립트 항목에 대한 세부정보를 가져오려면 name
경로 매개변수를 사용하여 transcripts.entries
리소스의 get()
메서드를 사용합니다. 스크립트 항목 이름을 모르는 경우 list()
메서드를 사용하여 모든 스크립트 이름을 나열할 수 있습니다.
이 메서드는 transcripts.entries
리소스의 인스턴스를 반환합니다.
다음 코드 샘플은 특정 스크립트 항목을 검색하는 방법을 보여줍니다.
자바
Node.js
Python
스크립트 항목 이름을 스크립트의 특정 스크립트 항목 ID 이름으로 바꿉니다.
모든 스크립트 항목 나열
스크립트의 모든 스크립트 항목에 관한 세부정보를 나열하려면 parent
경로 매개변수를 사용하여 transcripts.entries
리소스의 list()
메서드를 사용합니다. 형식은 conferenceRecords/{conferenceRecord}/transcripts/{transcript}
입니다.
이 메서드는 회의 스크립트당 구조화된 스크립트 항목 목록을 startTime
순으로 오름차순으로 정렬하여 transcripts.entries
리소스의 인스턴스로 반환합니다. 페이지 크기를 조정하려면 페이징 맞춤설정 을 참고하세요.
다음 코드 샘플은 스크립트의 모든 스크립트 항목을 나열하는 방법을 보여줍니다.
자바
Node.js
Python
상위 값을 회의 기록 이름 및 스크립트 이름으로 바꿉니다.
페이지 매김 맞춤설정
녹음 파일, 스크립트, 스크립트 항목의 페이지로 나누기를 맞춤설정하려면 다음 쿼리 매개변수를 전달합니다.
pageSize
: 반환할 최대 항목 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 10개의 항목이 반환됩니다. 최댓값은 100이며, 100을 초과하는 값은 자동으로 100으로 변경됩니다.pageToken
: 이전 목록 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이 토큰을 입력합니다.