색인
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 동영상의 채널 이름입니다. |