색인
AudioOverviewService(인터페이스)NotebookService(인터페이스)SourceService(인터페이스)AccountAndRole(메시지)AgentspaceMetadata(메시지)AudioOverview(메시지)AudioOverview.MimeType(열거형)AudioOverviewGenerationOptions(메시지)AudioOverviewStatus(열거형)BatchCreateSourcesRequest(메시지)BatchCreateSourcesResponse(메시지)BatchDeleteNotebooksRequest(메시지)BatchDeleteSourcesRequest(메시지)CmekConfig(메시지)CreateAudioOverviewRequest(메시지)CreateAudioOverviewResponse(메시지)CreateNotebookRequest(메시지)DeleteAudioOverviewRequest(메시지)FailureReason(메시지)FailureReason.AudioTranscriptionError(메시지)FailureReason.AudioTranscriptionError.LanguageDetectionFailed(메시지)FailureReason.AudioTranscriptionError.NoAudioDetected(메시지)FailureReason.DomainBlocked(메시지)FailureReason.GoogleDriveError(메시지)FailureReason.GoogleDriveError.DownloadPrevented(메시지)FailureReason.IngestionError(메시지)FailureReason.PaywallError(메시지)FailureReason.SourceEmpty(메시지)FailureReason.SourceLimitExceeded(메시지)FailureReason.SourceTooLong(메시지)FailureReason.SourceUnreachable(메시지)FailureReason.Unknown(메시지)FailureReason.UploadError(메시지)FailureReason.YoutubeError(메시지)FailureReason.YoutubeError.VideoDeleted(메시지)GetNotebookRequest(메시지)GetSourceRequest(메시지)GoogleDocsSourceMetadata(메시지)ListRecentlyViewedNotebooksRequest(메시지)ListRecentlyViewedNotebooksResponse(메시지)Notebook(메시지)NotebookMetadata(메시지)ProjectRole(열거형)ShareNotebookRequest(메시지)ShareNotebookResponse(메시지)Source(메시지)SourceId(메시지)SourceMetadata(메시지)SourceSettings(메시지)SourceStatus(열거형)SourceUnreachableErrorReason(열거형)UserContent(메시지)UserContent.AgentspaceContent(메시지)UserContent.GoogleDriveContent(메시지)UserContent.TextContent(메시지)UserContent.VideoContent(메시지)UserContent.WebContent(메시지)YoutubeMetadata(메시지)
AudioOverviewService
AI 음성 개요를 관리하는 서비스입니다.
| CreateAudioOverview |
|---|
|
새 AI 음성 개요를 생성합니다.
|
| DeleteAudioOverview |
|---|
|
AI 오디오 오버뷰를 삭제합니다.
|
NotebookService
노트북 관리 서비스입니다.
| BatchDeleteNotebooks |
|---|
|
노트북을 일괄 삭제합니다.
|
| CreateNotebook |
|---|
|
노트북을 만듭니다.
|
| GetNotebook |
|---|
|
노트북을 가져옵니다.
|
| ListRecentlyViewedNotebooks |
|---|
|
마지막 조회 시간을 기준으로 정렬된 노트북을 나열합니다.
|
SourceService
소스를 관리하는 서비스입니다.
| BatchCreateSources |
|---|
|
|
| BatchDeleteSources |
|---|
|
여러 소스를 삭제합니다.
|
| GetSource |
|---|
|
|
AccountAndRole
계정 및 역할 정보
| 필드 | |
|---|---|
email |
필수 항목입니다. 계정과 연결된 이메일 주소입니다. |
role |
필수 항목입니다. 노트북의 역할입니다. |
AgentspaceMetadata
에이전트 스페이스 소스에 관한 메타데이터입니다.
| 필드 | |
|---|---|
document_name |
출력 전용입니다. Agentspace의 전체 문서 이름입니다. |
document_title |
출력 전용입니다. 문서의 제목입니다. |
AudioOverview
노트북의 AI 음성 개요입니다. 오디오 형식의 노트북 요약입니다.
| 필드 | |
|---|---|
name |
식별자. 노트북의 전체 리소스 이름입니다. 형식은 이 필드는 UTF-8로 인코딩된 문자열이어야 하며 길이 제한은 1,024자(영문 기준)입니다. |
audio_overview_id |
출력 전용입니다. 오디오 개요의 고유 ID입니다. |
status |
AI 음성 개요의 상태입니다. |
generation_options |
AI 음성 개요를 생성하는 데 사용된 옵션입니다. |
mime_type |
오디오 개요의 MIME 유형입니다. |
language_code |
생성된 AI 음성 개요의 언어 코드입니다. BCP 47 언어 코드 (예: 'en', 'es', 'hi' 등)를 사용합니다. |
MimeType
AI 음성 개요에 지원되는 MIME 유형입니다.
| 열거형 | |
|---|---|
MIME_TYPE_UNKNOWN |
MIME 유형이 설정되지 않았습니다. |
MIME_TYPE_WAV |
MIME 유형은 audio/wav입니다. |
MIME_TYPE_MP4 |
MIME 유형은 audio/mp4입니다. |
AudioOverviewGenerationOptions
AI 음성 개요 생성 중에 사용되는 옵션입니다.
| 필드 | |
|---|---|
source_ids[] |
(선택사항) AI 음성 개요의 근거가 되는 소스입니다. |
episode_focus |
방송 호스트가 집중해야 할 부분 |
language_code |
AI 오디오 오버뷰가 요청된 언어입니다. |
AudioOverviewStatus
AI 음성 개요의 상태입니다.
| 열거형 | |
|---|---|
AUDIO_OVERVIEW_STATUS_UNSPECIFIED |
상태가 설정되지 않았습니다. |
AUDIO_OVERVIEW_STATUS_NOT_STARTED |
AI 음성 개요 생성이 시작되지 않았습니다. |
AUDIO_OVERVIEW_STATUS_IN_PROGRESS |
AI 음성 개요를 생성하는 중입니다. |
AUDIO_OVERVIEW_STATUS_COMPLETE |
AI 오디오 오버뷰가 생성되어 사용할 수 있습니다. |
AUDIO_OVERVIEW_STATUS_FAILED |
오디오 개요를 생성할 수 없습니다. |
BatchCreateSourcesRequest
SourceService.BatchCreateSources 메서드 요청입니다.
| 필드 | |
|---|---|
parent |
필수 항목입니다. 소스가 생성될 상위 리소스입니다. 형식: projects/{project}/locations/{location}/notebooks/{notebook} |
user_contents[] |
필수 항목입니다. 업로드할 |
BatchCreateSourcesResponse
SourceService.BatchCreateSources 메서드에 대한 응답입니다.
| 필드 | |
|---|---|
sources[] |
|
BatchDeleteNotebooksRequest
NotebookService.BatchDeleteNotebooks 메서드 요청입니다.
| 필드 | |
|---|---|
parent |
필수 항목입니다. 상위 브랜치 리소스 이름입니다(예: |
names[] |
필수 항목입니다. |
BatchDeleteSourcesRequest
[SourceService.BatchDeleteSourcesRequest][] 메서드 요청입니다.
| 필드 | |
|---|---|
parent |
필수 항목입니다. 소스가 삭제될 상위 리소스입니다. 형식: projects/{project}/locations/{location}/notebooks/{notebook} |
names[] |
필수 항목입니다. 삭제할 소스의 이름입니다. 형식: projects/{project}/locations/{location}/notebooks/{notebook}/sources/{source} |
CmekConfig
노트북의 고객 관리 암호화 구성입니다.
| 필드 | |
|---|---|
kms_key |
필수 항목입니다. |
CreateAudioOverviewRequest
AudioOverviewService.CreateAudioOverview 메서드 요청입니다.
| 필드 | |
|---|---|
parent |
필수 항목입니다. 이 노트북이 생성될 상위 리소스입니다. 형식: projects/{project}/locations/{location}/notebooks/{notebook} |
generation_options |
AI 음성 개요 생성 옵션입니다. |
CreateAudioOverviewResponse
AudioOverviewService.CreateAudioOverview 메서드에 대한 응답입니다.
| 필드 | |
|---|---|
audio_overview |
생성된 AI 음성 개요입니다. |
CreateNotebookRequest
NotebookService.CreateNotebook 메서드 요청입니다.
| 필드 | |
|---|---|
parent |
필수 항목입니다. 상위 리소스 이름입니다(예: |
notebook |
필수 항목입니다. 만들 노트북입니다. |
DeleteAudioOverviewRequest
AudioOverviewService.DeleteAudioOverview 메서드 요청입니다.
| 필드 | |
|---|---|
name |
필수 항목입니다. |
FailureReason
소스가 수집되지 않은 이유에 관한 세부정보가 포함된 실패 이유입니다.
| 필드 | |
|---|---|
통합 필드 error. 구체적인 오류입니다. error은 다음 중 하나여야 합니다. |
|
unknown |
알 수 없는 오류가 발생했음을 나타냅니다. |
source_too_long |
소스 단어 수가 사용자 한도를 초과했음을 나타냅니다. |
ingestion_error |
소스를 인제스트하는 중에 오류가 발생했음을 나타냅니다. |
source_empty |
소스가 비어 있음을 나타냅니다. |
upload_error |
소스를 업로드하는 중에 오류가 발생했음을 나타냅니다. |
paywall_error |
소스가 페이월로 설정되어 있어 인제스트할 수 없음을 나타냅니다. |
source_unreachable |
소스에 연결할 수 없음을 나타냅니다. |
google_drive_error |
Google Drive 관련 오류입니다. |
youtube_error |
YouTube 관련 오류입니다. |
audio_transcription_error |
오디오 파일 스크립트 작성 관련 오류입니다. |
source_limit_exceeded |
사용자가 한도를 초과하여 업데이트하려고 하면 오류가 발생합니다. |
domain_blocked |
사용자가 차단된 도메인에서 소스를 추가하려고 하면 오류가 발생합니다. |
AudioTranscriptionError
오디오 파일 스크립트 작성 관련 오류입니다.
| 필드 | |
|---|---|
통합 필드 error. 오디오 파일 스크립트 작성 관련 오류입니다. error은 다음 중 하나여야 합니다. |
|
language_detection_failed |
파일의 언어를 감지할 수 없습니다 (음성이 아닐 수 있음). |
no_audio_detected |
입력 파일에서 오디오가 감지되지 않았습니다 (동영상일 수 있음). |
LanguageDetectionFailed
이 유형에는 필드가 없습니다.
파일의 언어를 감지할 수 없습니다 (음성이 아닐 수 있음).
NoAudioDetected
이 유형에는 필드가 없습니다.
입력 파일에서 오디오가 감지되지 않았습니다.
DomainBlocked
이 유형에는 필드가 없습니다.
도메인이 차단되어 소스가 삭제되었음을 나타내는 오류입니다.
GoogleDriveError
Google Drive 관련 오류입니다.
| 필드 | |
|---|---|
통합 필드 error. Drive 관련 오류입니다. error은 다음 중 하나여야 합니다. |
|
download_prevented |
사용자가 파일을 다운로드할 수 없습니다. |
DownloadPrevented
이 유형에는 필드가 없습니다.
사용자가 파일을 다운로드할 수 없습니다.
IngestionError
이 유형에는 필드가 없습니다.
소스를 인제스트하는 중에 오류가 발생했음을 나타냅니다.
PaywallError
이 유형에는 필드가 없습니다.
소스가 페이월로 설정되어 있어 인제스트할 수 없음을 나타냅니다.
SourceEmpty
이 유형에는 필드가 없습니다.
소스가 비어 있음을 나타냅니다.
SourceLimitExceeded
이 유형에는 필드가 없습니다.
사용자에게 이 소스를 위한 공간이 없음을 나타냅니다.
SourceTooLong
소스 단어 수가 사용자 한도를 초과했음을 나타냅니다.
| 필드 | |
|---|---|
word_count |
소스의 단어 수입니다. |
word_limit |
업로드 시점의 현재 사용자의 단어 수 한도입니다. |
SourceUnreachable
소스에 연결할 수 없음을 나타냅니다. 주로 URL을 통해 추가된 소스에 사용됩니다.
| 필드 | |
|---|---|
error_details |
소스에 연결할 수 없는 이유를 설명합니다. |
알 수 없음
이 유형에는 필드가 없습니다.
알 수 없는 오류가 발생했음을 나타냅니다.
UploadError
이 유형에는 필드가 없습니다.
소스를 업로드하는 중에 오류가 발생했음을 나타냅니다.
YoutubeError
YouTube 관련 오류입니다.
| 필드 | |
|---|---|
통합 필드 error. YouTube 관련 오류입니다. error은 다음 중 하나여야 합니다. |
|
video_deleted |
동영상이 삭제되어 소스가 삭제되었음을 나타내는 오류입니다. |
VideoDeleted
이 유형에는 필드가 없습니다.
동영상이 삭제되어 소스가 삭제되었음을 나타내는 오류입니다.
GetNotebookRequest
NotebookService.GetNotebook 메서드 요청입니다.
| 필드 | |
|---|---|
name |
필수 항목입니다. |
GetSourceRequest
SourceService.GetSource 메서드 요청입니다.
| 필드 | |
|---|---|
name |
필수 항목입니다. 소스의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/notebooks/{notebook}/sources/{source} |
GoogleDocsSourceMetadata
Google 문서 소스에 관한 메타데이터입니다.
| 필드 | |
|---|---|
document_id |
출력 전용입니다. Google 문서의 문서 ID입니다. |
revision_id |
출력 전용입니다. 문서의 버전 ID입니다. |
ListRecentlyViewedNotebooksRequest
NotebookService.ListRecentlyViewedNotebooks 메서드 요청입니다.
| 필드 | |
|---|---|
parent |
필수 항목입니다. 상위 브랜치 리소스 이름입니다(예: |
page_size |
(선택사항) 반환할 최대 |
page_token |
(선택사항) 페이지 토큰입니다. 후속 페이지를 가져오려면 이 토큰을 제공하세요. |
ListRecentlyViewedNotebooksResponse
NotebookService.ListRecentlyViewedNotebooks 메서드에 대한 응답입니다.
| 필드 | |
|---|---|
notebooks[] |
최근에 본 노트북 목록입니다. |
next_page_token |
페이지 토큰입니다. 후속 페이지를 가져오려면 이 토큰을 제공하세요. |
노트북
노트북은 사용자가 콘텐츠를 소스로 저장하고 콘텐츠와 상호작용할 수 있는 리소스입니다.
| 필드 | |
|---|---|
name |
식별자. 노트북의 식별자입니다. 형식은 이 필드는 UTF-8로 인코딩된 문자열이어야 합니다. |
sources[] |
출력 전용입니다. 노트북의 소스 목록입니다. 출력 전용 필드입니다. |
cmek_config |
출력 전용입니다. Notebook의 CMEK 관련 정보입니다. |
title |
(선택사항) 노트북의 제목입니다. |
notebook_id |
출력 전용입니다. 노트북 ID입니다. 노트북 리소스 이름의 마지막 세그먼트입니다. |
emoji |
출력 전용입니다. 노트북의 그림 이모티콘입니다. |
metadata |
출력 전용입니다. 노트북의 메타데이터입니다. |
NotebookMetadata
노트북의 메타데이터입니다.
| 필드 | |
|---|---|
is_shared |
이 프로젝트가 현재 다른 사용자와 공유되고 있으면 true, 그렇지 않으면 false입니다. |
is_shareable |
프로젝트를 공유할 수 있으면 true입니다. |
last_viewed |
현재 세션의 사용자가 프로젝트를 마지막으로 본 시간을 나타내는 타임스탬프입니다. |
create_time |
이 프로젝트가 생성된 시간입니다. |
ProjectRole
프로젝트의 역할입니다.
| 열거형 | |
|---|---|
PROJECT_ROLE_UNKNOWN |
알 수 없는 역할입니다. |
PROJECT_ROLE_OWNER |
사용자가 프로젝트를 소유합니다. |
PROJECT_ROLE_WRITER |
사용자에게 프로젝트에 대한 쓰기 권한이 있습니다. |
PROJECT_ROLE_READER |
사용자에게 프로젝트에 대한 읽기 권한이 있습니다. |
PROJECT_ROLE_NOT_SHARED |
사용자에게 프로젝트에 대한 액세스 권한이 없습니다. |
소스
소스는 단일 콘텐츠 소스를 나타냅니다.
| 필드 | |
|---|---|
name |
식별자. 소스의 전체 리소스 이름입니다. 형식은 이 필드는 UTF-8로 인코딩된 문자열이어야 하며 길이 제한은 1,024자(영문 기준)입니다. |
title |
(선택사항) 소스의 제목입니다. |
source_id |
(선택사항) 출력 전용입니다. 소스 ID입니다. 소스 리소스 이름의 마지막 세그먼트입니다. |
metadata |
출력 전용입니다. 소스에 대한 메타데이터입니다. |
settings |
출력 전용입니다. 소스의 상태 및 실패 이유입니다. |
SourceId
SourceId는 소스의 리소스 이름의 마지막 세그먼트입니다.
| 필드 | |
|---|---|
id |
소스의 ID입니다. |
SourceMetadata
소스의 메타데이터와 일부 추가 정보를 나타냅니다.
| 필드 | |
|---|---|
통합 필드 metadata. 소스의 메타데이터입니다. metadata은 다음 중 하나여야 합니다. |
|
google_docs_metadata |
Google 문서 소스의 메타데이터입니다. |
youtube_metadata |
YouTube 동영상 소스의 메타데이터입니다. |
agentspace_metadata |
agentspace 소스의 메타데이터입니다. |
word_count |
소스의 단어 수입니다. |
token_count |
소스의 토큰 수입니다. |
source_added_timestamp |
소스가 추가된 타임스탬프입니다. |
SourceSettings
BatchCreateSources (이전의 AddSource 요청)에서 소스 설정의 확장을 허용합니다.
| 필드 | |
|---|---|
status |
소스의 상태입니다. |
failure_reason |
소스가 수집되지 않은 이유에 관한 세부정보가 포함된 실패 이유입니다. |
SourceStatus
소스의 가능한 상태 목록입니다.
| 열거형 | |
|---|---|
SOURCE_STATUS_UNSPECIFIED |
지정되지 않은 상태입니다. |
SOURCE_STATUS_PENDING |
소스가 추가 대기 중입니다. |
SOURCE_STATUS_COMPLETE |
소스 추가가 완료되었으며 성공했습니다. |
SOURCE_STATUS_ERROR |
소스 추가가 영구적으로 실패했습니다. |
SOURCE_STATUS_PENDING_DELETION |
소스가 삭제 대기 중입니다. |
SOURCE_STATUS_TENTATIVE |
사용자가 소스를 추가하려고 하지만 아직 소스가 업로드되지 않았거나 사용자 한도가 확인되지 않았습니다. 사용자의 소스 한도에 포함되지 않습니다. |
SourceUnreachableErrorReason
소스에 연결할 수 없는 이유에 관한 세부정보입니다. 사용자에게 적절한 메시지를 표시하는 데 사용됩니다.
| 열거형 | |
|---|---|
ERROR_REASON_UNSPECIFIED |
기본값 |
ERROR_REASON_INVALID_URL |
소스 URL이 잘못되었습니다. |
ERROR_REASON_NOT_ACCESSIBLE |
소스 URL에 액세스할 수 없습니다. |
ERROR_REASON_NOT_REACHABLE |
소스 URL에 연결할 수 없습니다. |
ERROR_REASON_URL_NOT_FOUND |
소스 URL에서 404를 반환했습니다. |
ERROR_REASON_TRANSIENT_ERROR |
일시적인 네트워크 오류나 호스트 제한 시간 등으로 인해 소스 URL에 연결할 수 없습니다. |
ERROR_REASON_FETCH_FAILED |
내부 오류로 인해 소스 URL을 가져올 수 없습니다. |
ERROR_REASON_NOT_SUPPORTED |
아직 지원되지 않는 URL입니다. 예로는 가져온 콘텐츠가 트롤러 가져오기 최대 크기를 초과하거나 가져온 콘텐츠가 아직 지원되지 않는 유형인 경우 등이 있습니다. |
UserContent
'콘텐츠' 메시지는 사용자가 업로드하려는 데이터를 의미합니다.
| 필드 | |
|---|---|
통합 필드 content. 사용자 콘텐츠입니다. content은 다음 중 하나여야 합니다. |
|
google_drive_content |
Google Drive의 콘텐츠입니다. |
text_content |
소스로 업로드된 텍스트 콘텐츠입니다. |
web_content |
소스로 업로드된 웹 콘텐츠입니다. |
video_content |
소스로 업로드된 동영상 콘텐츠입니다. |
agentspace_content |
소스로 업로드된 에이전트 스페이스 콘텐츠입니다. |
AgentspaceContent
소스로 업로드된 에이전트 스페이스 콘텐츠입니다.
| 필드 | |
|---|---|
document_name |
(선택사항) Agentspace 문서의 전체 리소스 이름입니다. 형식은 |
engine_name |
(선택사항) 문서의 권한을 확인하는 엔진입니다. 형식은 |
ideaforge_idea_name |
(선택사항) 아이디어 생성 도구 인스턴스의 리소스 이름입니다. 형식: |
GoogleDriveContent
Google Drive의 콘텐츠입니다.
| 필드 | |
|---|---|
document_id |
선택한 문서의 문서 ID입니다. |
mime_type |
선택한 문서의 MIME 유형입니다. 드라이브 선택기에서 선택한 콘텐츠의 유형을 구분하는 데 사용할 수 있습니다. Google Docs의 경우 application/vnd.google-apps.document를 사용하고 Google Slides의 경우 application/vnd.google-apps.presentation을 사용합니다. |
source_name |
소스에 표시할 이름입니다. |
TextContent
소스로 업로드된 텍스트 콘텐츠입니다.
| 필드 | |
|---|---|
source_name |
텍스트 소스의 표시 이름입니다. |
content |
소스에 표시할 이름입니다. |
VideoContent
소스로 업로드된 동영상 콘텐츠입니다.
| 필드 | |
|---|---|
통합 필드 format. 동영상 콘텐츠의 형식을 지정합니다. format은 다음 중 하나여야 합니다. |
|
youtube_url |
동영상 콘텐츠의 YouTube URL입니다. |
WebContent
소스로 업로드된 웹 콘텐츠입니다.
| 필드 | |
|---|---|
url |
URL이 제공되면 백엔드에서 웹페이지를 가져옵니다. |
source_name |
소스에 표시할 이름입니다. |
YoutubeMetadata
YouTube 동영상 소스에 관한 메타데이터입니다.
| 필드 | |
|---|---|
video_id |
출력 전용입니다. YouTube 동영상의 ID입니다. |
channel_name |
출력 전용입니다. YouTube 동영상의 채널 이름입니다. |