Package google.cloud.visionai.v1

색인

AppPlatform

리소스 핸들러를 설명하는 서비스

AddApplicationStreamInput

rpc AddApplicationStreamInput(AddApplicationStreamInputRequest) returns (Operation)

애플리케이션에 타겟 스트림 입력을 추가합니다. 애플리케이션이 배포되면 해당하는 새 애플리케이션 인스턴스가 생성됩니다. 스트림이 이미 애플리케이션에 있는 경우 RPC가 실패합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

CreateApplication

rpc CreateApplication(CreateApplicationRequest) returns (Operation)

특정 프로젝트 및 위치에 새 애플리케이션을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

CreateApplicationInstances

rpc CreateApplicationInstances(CreateApplicationInstancesRequest) returns (Operation)

애플리케이션에 타겟 스트림 입력을 추가합니다. 애플리케이션이 배포되면 해당하는 새 애플리케이션 인스턴스가 생성됩니다. 스트림이 이미 애플리케이션에 있는 경우 RPC가 실패합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

CreateDraft

rpc CreateDraft(CreateDraftRequest) returns (Operation)

특정 프로젝트 및 위치에 새 답안을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

CreateProcessor

rpc CreateProcessor(CreateProcessorRequest) returns (Operation)

특정 프로젝트 및 위치에 새 프로세서를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

DeleteApplication

rpc DeleteApplication(DeleteApplicationRequest) returns (Operation)

단일 애플리케이션을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

DeleteApplicationInstances

rpc DeleteApplicationInstances(DeleteApplicationInstancesRequest) returns (Operation)

애플리케이션에 대한 타겟 스트림 입력을 삭제합니다. 애플리케이션이 배포되면 해당 인스턴스 기반이 삭제됩니다. 스트림이 애플리케이션에 없으면 RPC가 실패합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

DeleteDraft

rpc DeleteDraft(DeleteDraftRequest) returns (Operation)

단일 초안을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

DeleteProcessor

rpc DeleteProcessor(DeleteProcessorRequest) returns (Operation)

단일 프로세서를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

DeployApplication

rpc DeployApplication(DeployApplicationRequest) returns (Operation)

단일 애플리케이션을 배포합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

GetApplication

rpc GetApplication(GetApplicationRequest) returns (Application)

단일 애플리케이션의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

GetDraft

rpc GetDraft(GetDraftRequest) returns (Draft)

단일 답안의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

GetInstance

rpc GetInstance(GetInstanceRequest) returns (Instance)

단일 인스턴스의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

GetProcessor

rpc GetProcessor(GetProcessorRequest) returns (Processor)

단일 프로세서의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

ListApplications

rpc ListApplications(ListApplicationsRequest) returns (ListApplicationsResponse)

특정 프로젝트 및 위치의 애플리케이션을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

ListDrafts

rpc ListDrafts(ListDraftsRequest) returns (ListDraftsResponse)

특정 프로젝트 및 위치의 답안 초안을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

ListInstances

rpc ListInstances(ListInstancesRequest) returns (ListInstancesResponse)

특정 프로젝트 및 위치의 인스턴스를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

ListPrebuiltProcessors

rpc ListPrebuiltProcessors(ListPrebuiltProcessorsRequest) returns (ListPrebuiltProcessorsResponse)

ListPrebuiltProcessors는 사전 빌드된 프로세서를 나열하는 맞춤 패스스루 동사입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

ListProcessors

rpc ListProcessors(ListProcessorsRequest) returns (ListProcessorsResponse)

특정 프로젝트 및 위치의 프로세서를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

RemoveApplicationStreamInput

rpc RemoveApplicationStreamInput(RemoveApplicationStreamInputRequest) returns (Operation)

애플리케이션에 대한 타겟 스트림 입력을 삭제합니다. 애플리케이션이 배포되면 해당 인스턴스 기반이 삭제됩니다. 스트림이 애플리케이션에 없으면 RPC가 실패합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

UndeployApplication

rpc UndeployApplication(UndeployApplicationRequest) returns (Operation)

단일 애플리케이션의 배포를 취소합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

UpdateApplication

rpc UpdateApplication(UpdateApplicationRequest) returns (Operation)

단일 애플리케이션의 매개변수를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

UpdateApplicationInstances

rpc UpdateApplicationInstances(UpdateApplicationInstancesRequest) returns (Operation)

애플리케이션에 타겟 스트림 입력을 추가합니다. 애플리케이션이 배포되면 해당하는 새 애플리케이션 인스턴스가 생성됩니다. 스트림이 이미 애플리케이션에 있는 경우 RPC가 실패합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

UpdateApplicationStreamInput

rpc UpdateApplicationStreamInput(UpdateApplicationStreamInputRequest) returns (Operation)

애플리케이션에 대상 스트림 입력을 업데이트합니다. 애플리케이션이 배포된 경우 해당 인스턴스 기반이 배포됩니다. CreateOrUpdate 동작의 경우 allow_missing를 true로 설정합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

UpdateDraft

rpc UpdateDraft(UpdateDraftRequest) returns (Operation)

단일 답안의 매개변수를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

UpdateProcessor

rpc UpdateProcessor(UpdateProcessorRequest) returns (Operation)

단일 프로세서의 매개변수를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

EventDiscoveryService

다음은 이벤트 검색 서비스의 새 버전입니다. 모든 사용을 새 EventDiscoveryService로 이전한 후 EventWatcher가 지원 중단됩니다. 클라이언트가 스트림에서 발생하는 이벤트 업데이트를 검색하는 이벤트 검색 API입니다.

WatchEvents

rpc WatchEvents(WatchEventsRequest) returns (WatchEventsResponse)

지정된 스트림에서 발생하는 이벤트 업데이트를 확인합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

cluster 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.clusters.watch

자세한 내용은 IAM 문서를 참조하세요.

LiveVideoAnalytics

리소스의 핸들러를 설명하는 서비스입니다. 이 서비스를 통해 클라이언트는 스트리밍 입력에서 실시간 동영상 분석 (LVA)을 실행할 수 있습니다.

CreateAnalysis

rpc CreateAnalysis(CreateAnalysisRequest) returns (Operation)

특정 프로젝트 및 위치에 새 분석을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

CreateProcess

rpc CreateProcess(CreateProcessRequest) returns (Operation)

특정 프로젝트 및 위치에 새 프로세스를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

DeleteAnalysis

rpc DeleteAnalysis(DeleteAnalysisRequest) returns (Operation)

단일 분석을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

DeleteProcess

rpc DeleteProcess(DeleteProcessRequest) returns (Operation)

단일 프로세스를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

GetAnalysis

rpc GetAnalysis(GetAnalysisRequest) returns (Analysis)

단일 분석의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

GetProcess

rpc GetProcess(GetProcessRequest) returns (Process)

단일 프로세스의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

ListAnalyses

rpc ListAnalyses(ListAnalysesRequest) returns (ListAnalysesResponse)

특정 프로젝트 및 위치의 분석을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

ListProcesses

rpc ListProcesses(ListProcessesRequest) returns (ListProcessesResponse)

특정 프로젝트 및 위치의 프로세스를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

UpdateAnalysis

rpc UpdateAnalysis(UpdateAnalysisRequest) returns (Operation)

단일 분석의 매개변수를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

UpdateProcess

rpc UpdateProcess(UpdateProcessRequest) returns (Operation)

단일 프로세스의 매개변수를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

RetailService

이 서비스를 통해 클라이언트는 Store Vision 소매 리소스를 관리할 수 있습니다.

SmartDeviceService

리소스 핸들러를 설명하는 서비스

StreamingService

패킷 수신 및 전송을 위한 스트리밍 서비스입니다.

StreamsService

리소스의 핸들러를 설명하는 서비스입니다. Vision API와 Vision AI API는 동일한 팀에서 개발한 두 가지 독립적인 API입니다. Vision API는 사용자가 이미지에 주석을 추가하는 용도이고 Vision AI는 고객이 자체 컴퓨터 비전 애플리케이션을 빌드하는 데 사용하는 엔드 투 엔드 솔루션입니다.

웨어하우스

스트리밍을 위한 미디어 콘텐츠 및 메타데이터를 관리하는 서비스입니다.

AddCollectionItem

rpc AddCollectionItem(AddCollectionItemRequest) returns (AddCollectionItemResponse)

컬렉션에 항목을 추가합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

AnalyzeAsset

rpc AnalyzeAsset(AnalyzeAssetRequest) returns (Operation)

저작물을 분석하여 검색 기능을 강화합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.analyze

자세한 내용은 IAM 문서를 참조하세요.

AnalyzeCorpus

rpc AnalyzeCorpus(AnalyzeCorpusRequest) returns (Operation)

코퍼스를 분석합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.corpora.analyze

자세한 내용은 IAM 문서를 참조하세요.

ClipAsset

rpc ClipAsset(ClipAssetRequest) returns (ClipAssetResponse)

다운로드할 클립을 생성합니다. 이 API는 시간 범위를 사용하고 start_time 이후 및 end_time 이전에 사용 가능한 첫 번째 콘텐츠의 클립을 생성하며, 이 범위를 초과할 수 있습니다. 클립의 총 크기가 100MB를 초과하면 반환된 클립이 잘립니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.clip

자세한 내용은 IAM 문서를 참조하세요.

CreateAnnotation

rpc CreateAnnotation(CreateAnnotationRequest) returns (Annotation)

애셋 내에 주석을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.annotations.create

자세한 내용은 IAM 문서를 참조하세요.

CreateAsset

rpc CreateAsset(CreateAssetRequest) returns (Asset)

자료 내에서 애셋을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.create

자세한 내용은 IAM 문서를 참조하세요.

CreateCollection

rpc CreateCollection(CreateCollectionRequest) returns (Operation)

컬렉션을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

CreateCorpus

rpc CreateCorpus(CreateCorpusRequest) returns (Operation)

프로젝트 내에 자료 모음을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.corpora.create

자세한 내용은 IAM 문서를 참조하세요.

CreateDataSchema

rpc CreateDataSchema(CreateDataSchemaRequest) returns (DataSchema)

자료 내에서 데이터 스키마를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.dataSchemas.create

자세한 내용은 IAM 문서를 참조하세요.

CreateIndex

rpc CreateIndex(CreateIndexRequest) returns (Operation)

코퍼스 아래에 색인을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexes.create

자세한 내용은 IAM 문서를 참조하세요.

CreateIndexEndpoint

rpc CreateIndexEndpoint(CreateIndexEndpointRequest) returns (Operation)

IndexEndpoint를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexEndpoints.create

자세한 내용은 IAM 문서를 참조하세요.

CreateSearchConfig

rpc CreateSearchConfig(CreateSearchConfigRequest) returns (SearchConfig)

자료 내에서 검색 구성을 만듭니다.

유효한 CreateSearchConfigRequest를 만들려면 아래 규칙을 따르세요. --- 일반 규칙 --- 1. Request.search_config_id는 기존 SearchConfig와 연결되어서는 안 됩니다. 2. 요청에는 비어 있지 않은 search_criteria_property 또는 facet_property가 하나 이상 포함되어야 합니다. 3. mapped_fields는 비워서는 안 되며 기존 UGA 키에 매핑해야 합니다. 4. 모든 mapped_fields는 동일한 유형이어야 합니다. 5. 모든 mapped_fields는 동일한 세부사항을 공유해야 합니다. 6. 모든 mapped_fields는 동일한 의미적 SearchConfig 일치 옵션을 공유해야 합니다. 속성별 규칙은 FacetProperty 및 SearchCriteriaProperty의 주석을 참고하세요.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.searchConfigs.create

자세한 내용은 IAM 문서를 참조하세요.

CreateSearchHypernym

rpc CreateSearchHypernym(CreateSearchHypernymRequest) returns (SearchHypernym)

자료 내에서 SearchHypernym을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

DeleteAnnotation

rpc DeleteAnnotation(DeleteAnnotationRequest) returns (Empty)

저작물 내의 주석을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.annotations.delete

자세한 내용은 IAM 문서를 참조하세요.

DeleteAsset

rpc DeleteAsset(DeleteAssetRequest) returns (Operation)

자료 내 애셋을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.delete

자세한 내용은 IAM 문서를 참조하세요.

DeleteCollection

rpc DeleteCollection(DeleteCollectionRequest) returns (Operation)

컬렉션을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

DeleteCorpus

rpc DeleteCorpus(DeleteCorpusRequest) returns (Empty)

빈 경우에만 자료 모음을 삭제합니다. 빈 응답을 반환합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.corpora.delete

자세한 내용은 IAM 문서를 참조하세요.

DeleteDataSchema

rpc DeleteDataSchema(DeleteDataSchemaRequest) returns (Empty)

자료 내의 데이터 스키마를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.dataSchemas.delete

자세한 내용은 IAM 문서를 참조하세요.

DeleteIndex

rpc DeleteIndex(DeleteIndexRequest) returns (Operation)

단일 색인을 삭제합니다. 색인을 삭제하려면 호출자가 색인이 색인 엔드포인트에 배포되지 않았는지 확인해야 합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexes.delete

자세한 내용은 IAM 문서를 참조하세요.

DeleteIndexEndpoint

rpc DeleteIndexEndpoint(DeleteIndexEndpointRequest) returns (Operation)

IndexEndpoint를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexEndpoints.delete

자세한 내용은 IAM 문서를 참조하세요.

DeleteSearchConfig

rpc DeleteSearchConfig(DeleteSearchConfigRequest) returns (Empty)

자료 내의 검색 구성을 삭제합니다.

DeleteSearchConfigRequest가 유효하려면 Request.search_configuration.name이 이미 있어야 합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.searchConfigs.delete

자세한 내용은 IAM 문서를 참조하세요.

DeleteSearchHypernym

rpc DeleteSearchHypernym(DeleteSearchHypernymRequest) returns (Empty)

코퍼스 내의 SearchHypernym을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

DeployIndex

rpc DeployIndex(DeployIndexRequest) returns (Operation)

IndexEndpoint에 색인을 배포합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

indexEndpoint 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexEndpoints.deploy

자세한 내용은 IAM 문서를 참조하세요.

GenerateHlsUri

rpc GenerateHlsUri(GenerateHlsUriRequest) returns (GenerateHlsUriResponse)

HLS 매니페스트의 URI를 생성합니다. 이 API는 시간 범위 모음을 수신하고 요청된 모든 시간 범위를 포함하는 HLS 매니페스트의 URI를 생성합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.generateHlsUri

자세한 내용은 IAM 문서를 참조하세요.

GenerateRetrievalUrl

rpc GenerateRetrievalUrl(GenerateRetrievalUrlRequest) returns (GenerateRetrievalUrlResponse)

애셋을 다운로드할 서명된 URL을 생성합니다. 동영상 창고의 경우 다른 프로젝트에서 Cloud Storage 파일 검색을 허용하는 방법에 관한 UploadAsset의 주석을 참고하세요.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

GetAnnotation

rpc GetAnnotation(GetAnnotationRequest) returns (Annotation)

애셋 내의 주석을 읽습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.annotations.get

자세한 내용은 IAM 문서를 참조하세요.

GetAsset

rpc GetAsset(GetAssetRequest) returns (Asset)

코퍼스 내 애셋을 읽습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.get

자세한 내용은 IAM 문서를 참조하세요.

GetCollection

rpc GetCollection(GetCollectionRequest) returns (Collection)

컬렉션을 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

GetCorpus

rpc GetCorpus(GetCorpusRequest) returns (Corpus)

프로젝트 내의 코퍼스 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.corpora.get

자세한 내용은 IAM 문서를 참조하세요.

GetDataSchema

rpc GetDataSchema(GetDataSchemaRequest) returns (DataSchema)

자료 내 데이터 스키마를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.dataSchemas.get

자세한 내용은 IAM 문서를 참조하세요.

GetIndex

rpc GetIndex(GetIndexRequest) returns (Index)

코퍼스 아래의 단일 색인의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexes.get

자세한 내용은 IAM 문서를 참조하세요.

GetIndexEndpoint

rpc GetIndexEndpoint(GetIndexEndpointRequest) returns (IndexEndpoint)

IndexEndpoint를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexEndpoints.get

자세한 내용은 IAM 문서를 참조하세요.

GetSearchConfig

rpc GetSearchConfig(GetSearchConfigRequest) returns (SearchConfig)

코퍼스 내에서 검색 구성을 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.searchConfigs.get

자세한 내용은 IAM 문서를 참조하세요.

GetSearchHypernym

rpc GetSearchHypernym(GetSearchHypernymRequest) returns (SearchHypernym)

코퍼스 내에서 SearchHypernym을 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

ImportAssets

rpc ImportAssets(ImportAssetsRequest) returns (Operation)

Cloud Storage의 메타 파일에서 애셋 (이미지 및 주석)을 가져옵니다. 메타 파일의 각 행은 이미지 (Cloud Storage URI로 지정됨) 및 주석에 해당합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.corpora.import

자세한 내용은 IAM 문서를 참조하세요.

IndexAsset

rpc IndexAsset(IndexAssetRequest) returns (Operation)

검색을 위해 애셋 하나를 색인 생성합니다. 지원되는 자료 유형: Corpus.Type.VIDEO_ON_DEMAND

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

index 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexes.update

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.index

자세한 내용은 IAM 문서를 참조하세요.

IngestAsset

rpc IngestAsset(IngestAssetRequest) returns (IngestAssetResponse)

애셋의 데이터를 수집합니다. TTL에 따라 이미 만료된 데이터 청크는 처리할 수 없습니다. 이 메서드는 gRPC API를 통해서만 사용할 수 있습니다 (HTTP를 통해 양방향 스트리밍이 지원되지 않음).

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

asset 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.ingest

자세한 내용은 IAM 문서를 참조하세요.

ListAnnotations

rpc ListAnnotations(ListAnnotationsRequest) returns (ListAnnotationsResponse)

저작물 내의 주석 목록을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.annotations.list

자세한 내용은 IAM 문서를 참조하세요.

ListAssets

rpc ListAssets(ListAssetsRequest) returns (ListAssetsResponse)

자료 내 애셋 목록을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.list

자세한 내용은 IAM 문서를 참조하세요.

ListCollections

rpc ListCollections(ListCollectionsRequest) returns (ListCollectionsResponse)

코퍼스 내의 컬렉션을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

ListCorpora

rpc ListCorpora(ListCorporaRequest) returns (ListCorporaResponse)

프로젝트의 모든 코퍼스를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.corpora.list

자세한 내용은 IAM 문서를 참조하세요.

ListDataSchemas

rpc ListDataSchemas(ListDataSchemasRequest) returns (ListDataSchemasResponse)

코퍼스 내의 데이터 스키마 목록을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.dataSchemas.list

자세한 내용은 IAM 문서를 참조하세요.

ListIndexEndpoints

rpc ListIndexEndpoints(ListIndexEndpointsRequest) returns (ListIndexEndpointsResponse)

프로젝트의 모든 IndexEndpoint를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexEndpoints.list

자세한 내용은 IAM 문서를 참조하세요.

ListIndexes

rpc ListIndexes(ListIndexesRequest) returns (ListIndexesResponse)

지정된 자료의 모든 색인을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexes.list

자세한 내용은 IAM 문서를 참조하세요.

ListSearchConfigs

rpc ListSearchConfigs(ListSearchConfigsRequest) returns (ListSearchConfigsResponse)

코퍼스 내의 모든 검색 구성을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.searchConfigs.list

자세한 내용은 IAM 문서를 참조하세요.

ListSearchHypernyms

rpc ListSearchHypernyms(ListSearchHypernymsRequest) returns (ListSearchHypernymsResponse)

코퍼스 내의 SearchHypernyms를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

RemoveCollectionItem

rpc RemoveCollectionItem(RemoveCollectionItemRequest) returns (RemoveCollectionItemResponse)

컬렉션에서 항목을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

RemoveIndexAsset

rpc RemoveIndexAsset(RemoveIndexAssetRequest) returns (Operation)

검색을 위해 저작물의 색인 데이터 1개를 삭제합니다. 지원되는 자료 유형: Corpus.Type.VIDEO_ON_DEMAND

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

index 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexes.update

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.removeIndex

자세한 내용은 IAM 문서를 참조하세요.

SearchAssets

rpc SearchAssets(SearchAssetsRequest) returns (SearchAssetsResponse)

미디어 저작물을 검색합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

corpus 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.search

자세한 내용은 IAM 문서를 참조하세요.

SearchIndexEndpoint

rpc SearchIndexEndpoint(SearchIndexEndpointRequest) returns (SearchIndexEndpointResponse)

배포된 색인 엔드포인트를 검색합니다 (이미지 코퍼스 유형만 해당).

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

indexEndpoint 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexEndpoints.search

자세한 내용은 IAM 문서를 참조하세요.

UndeployIndex

rpc UndeployIndex(UndeployIndexRequest) returns (Operation)

IndexEndpoint에서 색인을 배포 취소합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

indexEndpoint 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexEndpoints.undeploy

자세한 내용은 IAM 문서를 참조하세요.

UpdateAnnotation

rpc UpdateAnnotation(UpdateAnnotationRequest) returns (Annotation)

저작물 내 주석을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.annotations.update

자세한 내용은 IAM 문서를 참조하세요.

UpdateAsset

rpc UpdateAsset(UpdateAssetRequest) returns (Asset)

자료 내 애셋을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.update

자세한 내용은 IAM 문서를 참조하세요.

UpdateCollection

rpc UpdateCollection(UpdateCollectionRequest) returns (Collection)

컬렉션을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

UpdateCorpus

rpc UpdateCorpus(UpdateCorpusRequest) returns (Corpus)

프로젝트의 자료 모음을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.corpora.update

자세한 내용은 IAM 문서를 참조하세요.

UpdateDataSchema

rpc UpdateDataSchema(UpdateDataSchemaRequest) returns (DataSchema)

자료 내 데이터 스키마를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.dataSchemas.update

자세한 내용은 IAM 문서를 참조하세요.

UpdateIndex

rpc UpdateIndex(UpdateIndexRequest) returns (Operation)

자료 아래의 색인을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexes.update

자세한 내용은 IAM 문서를 참조하세요.

UpdateIndexEndpoint

rpc UpdateIndexEndpoint(UpdateIndexEndpointRequest) returns (Operation)

IndexEndpoint를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexEndpoints.update

자세한 내용은 IAM 문서를 참조하세요.

UpdateSearchConfig

rpc UpdateSearchConfig(UpdateSearchConfigRequest) returns (SearchConfig)

자료 내의 검색 구성을 업데이트합니다.

유효한 UpdateSearchConfigRequest를 만들려면 아래 규칙을 따르세요. --- 일반 규칙 --- 1. Request.search_configuration.name이 이미 있어야 합니다. 2. 요청에는 비어 있지 않은 search_criteria_property 또는 facet_property가 하나 이상 포함되어야 합니다. 3. mapped_fields는 비워서는 안 되며 기존 UGA 키에 매핑해야 합니다. 4. 모든 mapped_fields는 동일한 유형이어야 합니다. 5. 모든 mapped_fields는 동일한 세부사항을 공유해야 합니다. 6. 모든 mapped_fields는 동일한 의미적 SearchConfig 일치 옵션을 공유해야 합니다. 속성별 규칙은 FacetProperty 및 SearchCriteriaProperty의 주석을 참고하세요.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.searchConfigs.update

자세한 내용은 IAM 문서를 참조하세요.

UpdateSearchHypernym

rpc UpdateSearchHypernym(UpdateSearchHypernymRequest) returns (SearchHypernym)

자료 내 SearchHypernym을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

UploadAsset

rpc UploadAsset(UploadAssetRequest) returns (Operation)

애셋 Cloud Storage uri를 지정하여 애셋을 업로드합니다. 동영상 창고의 경우 이 API를 호출하는 사용자가 클라우드 스토리지 파일에 대한 읽기 액세스 권한이 있어야 합니다. 업로드되면 GenerateRetrievalUrl API를 통해 검색할 수 있으며, 이 API는 기본적으로 창고와 동일한 프로젝트의 Cloud Storage 파일만 검색할 수 있습니다. 별도의 프로젝트에 있는 Cloud Storage 파일을 검색하려면 Vision AI 서비스 계정을 찾아야 합니다 (IAM으로 이동하여 'Google 제공 역할 부여 포함'을 표시하도록 체크박스를 선택하고 'Cloud Vision AI 서비스 에이전트'를 검색). 그런 다음 해당 서비스 계정에 Cloud Storage 파일의 읽기 액세스 권한을 부여합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.upload

자세한 내용은 IAM 문서를 참조하세요.

ViewCollectionItems

rpc ViewCollectionItems(ViewCollectionItemsRequest) returns (ViewCollectionItemsResponse)

컬렉션 내에서 항목을 봅니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

ViewIndexedAssets

rpc ViewIndexedAssets(ViewIndexedAssetsRequest) returns (ViewIndexedAssetsResponse)

색인 내 애셋 목록을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

index 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.indexes.viewAssets

자세한 내용은 IAM 문서를 참조하세요.

AIEnabledDevicesInputConfig

이 유형에는 필드가 없습니다.

AI 지원 기기 입력 구성을 설명하는 메시지입니다.

AcceleratorType

하드웨어 가속기 유형을 나타냅니다.

열거형
ACCELERATOR_TYPE_UNSPECIFIED 지정되지 않은 가속기 유형입니다. 즉, 가속기가 없습니다.
NVIDIA_TESLA_K80 Nvidia Tesla K80 GPU.
NVIDIA_TESLA_P100 Nvidia Tesla P100 GPU.
NVIDIA_TESLA_V100 Nvidia Tesla V100 GPU.
NVIDIA_TESLA_P4 Nvidia Tesla P4 GPU.
NVIDIA_TESLA_T4 Nvidia Tesla T4 GPU.
NVIDIA_TESLA_A100 Nvidia Tesla A100 GPU.
TPU_V2 TPU v2.
TPU_V3 TPU v3.

AcquireLeaseRequest

임대 획득을 위한 요청 메시지입니다.

필드
series

string

시리즈 이름입니다.

owner

string

소유자 이름입니다.

term

Duration

리스 기간입니다.

lease_type

LeaseType

임대 유형입니다.

AddApplicationStreamInputRequest

애플리케이션에 스트림 입력을 추가하기 위한 메시지입니다.

필드
name

string

필수 항목입니다. 검색할 애플리케이션의 이름입니다. 형식: 'projects/{project}/locations/{location}/applications/{application}'

application_stream_inputs[]

ApplicationStreamInput

추가할 스트림 입력입니다. 스트림 리소스 이름은 각 StreamInput의 키이며 각 애플리케이션 내에서 고유해야 합니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

AddApplicationStreamInputResponse

이 유형에는 필드가 없습니다.

AddApplicationStreamInput 응답 메시지입니다.

AddCollectionItemRequest

AddCollectionItem 요청 메시지입니다.

필드
item

CollectionItem

필수 입력란입니다. 추가할 항목입니다.

AddCollectionItemResponse

AddCollectionItem의 응답 메시지입니다.

필드
item

CollectionItem

이미 추가된 항목

AddRetailProductsToRetailProductSetResponse

이 유형에는 필드가 없습니다.

작업이 완료된 후 AddRetailProductsToRetailProductSet 응답

분석

분석 객체를 설명하는 메시지입니다.

필드
name

string

리소스 이름입니다.

create_time

Timestamp

출력 전용입니다. 생성 타임스탬프입니다.

update_time

Timestamp

출력 전용입니다. 업데이트 타임스탬프입니다.

labels

map<string, string>

키-값 쌍인 라벨입니다.

analysis_definition

AnalysisDefinition

분석의 정의입니다.

input_streams_mapping

map<string, string>

정의의 입력 매개변수에서 실제 스트림으로 매핑합니다. 예를 들어 'input-0'이라는 스트림 소스 연산자가 있고 실제 스트림 'stream-0'에서 수신하려고 한다고 가정해 보겠습니다. 다음 매핑을 추가할 수 있습니다. [input-0: stream-0].

output_streams_mapping

map<string, string>

정의의 출력 매개변수에서 실제 스트림으로 매핑합니다. 예를 들어 'output-0'이라는 스트림 싱크 연산자가 있고 실제 스트림 'stream-0'으로 전송하려고 한다고 가정해 보겠습니다. [output-0: stream-0] 매핑을 추가할 수 있습니다.

disable_event_watch

bool

입력 스트림에서 새 이벤트가 발생할 때 프로세스를 자동으로 시작하는 기능을 사용 중지할지 여부를 나타내는 불리언 플래그입니다. 프로세스를 수동으로 시작하려면 이 필드를 true로 설정해야 합니다.

AnalysisDefinition

전체 분석을 정의합니다.

전체 실시간 분석 파이프라인을 설명합니다. 이를 멀티그래프의 에지 목록 표현으로 생각할 수 있습니다.

이는 사람이 protobuf 텍스트 형식으로 직접 작성하거나 프로그래밍 API (컨텍스트에 따라 Python 또는 JavaScript일 수 있음)에서 생성할 수 있습니다.

필드
analyzers[]

AnalyzerDefinition

분석기 정의

AnalyzeAssetMetadata

AnalyzeAsset의 메타데이터입니다.

필드
analysis_status[]

AnalysisStatus

모든 검색 기능에 대한 분석 상태입니다.

start_time

Timestamp

작업의 시작 시간입니다.

update_time

Timestamp

작업의 업데이트 시간입니다.

AnalysisStatus

각 검색 기능의 분석 상태입니다.

필드
state

State

status_message

string

search_capability

SearchCapability

요청된 검색 기능

검색 기능의 상태입니다.

열거형
STATE_UNSPECIFIED 기본 프로세스 상태는 발생해서는 안 됩니다.
IN_PROGRESS 이 기능은 현재 개발 중입니다.
SUCCEEDED 프로세스가 완료되었습니다.
FAILED 프로세스가 실패했습니다.

AnalyzeAssetRequest

AnalyzeAsset 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 분석할 저작물의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/assets/{asset_id}

AnalyzeAssetResponse

이 유형에는 필드가 없습니다.

AnalyzeAsset의 응답 메시지입니다.

AnalyzeCorpusMetadata

AnalyzeCorpus LRO의 메타데이터 메시지입니다.

필드
metadata

OperationMetadata

작업의 메타데이터입니다.

AnalyzeCorpusRequest

AnalyzeCorpus 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 애셋이 분석될 상위 자료 리소스입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}

AnalyzeCorpusResponse

이 유형에는 필드가 없습니다.

AnalyzeCorpus LRO의 응답 메시지입니다.

AnalyzerDefinition

분석 도구를 정의합니다.

분석기는 표현하는 연산자에 정의된 로직을 사용하여 입력 스트림의 데이터를 처리합니다. 물론 연산자에 선언된 출력 스트림의 데이터도 생성합니다.

필드
analyzer

string

이 분석 도구의 이름입니다.

잠정적으로 [a-z][a-z0-9]*(_[a-z0-9]+)*입니다.

operator

string

이 분석 도구에서 실행하는 연산자의 이름입니다.

지원되는 연산자의 이름과 일치해야 합니다.

inputs[]

StreamInput

입력 스트림

attrs

map<string, AttributeValue>

이 분석 도구가 연산자에 적용하는 속성 값입니다.

속성 이름과 적용하려는 실제 값 간의 매핑을 제공합니다. 속성 이름을 생략하면 사전 구성된 기본값이 사용됩니다.

debug_options

DebugOptions

디버그 옵션

operator_option

OperatorOption

운영자 옵션

DebugOptions

디버깅 목적으로만 사용할 수 있는 옵션입니다.

필드
environment_variables

map<string, string>

환경 변수

OperatorOption

연산자와 관련된 옵션입니다.

필드
tag

string

운영자의 태그입니다.

registry

string

연산자의 레지스트리입니다(예: public, dev).

StreamInput

이 분석기의 입력입니다.

다음 형식의 입력 이름 참조가 허용됩니다. :

예:

출력 인수가 2개인 'SomeOp'이라는 연산자(첫 번째 인수의 이름은 'foo', 두 번째 인수의 이름은 'bar')와 입력 2개를 허용하는 'MyOp'이라는 연산자가 있다고 가정해 보겠습니다.

또한 'SomeOp'를 실행하는 'some-analyzer'라는 분석기와 'MyOp'를 실행하는 'my-analyzer'라는 다른 분석기가 있다고 가정해 보겠습니다.

'my-analyzer'가 'some-analyzer'의 'foo' 출력을 첫 번째 입력으로, 'some-analyzer'의 'bar' 출력을 두 번째 입력으로 사용한다는 것을 나타내려면 이 필드를 다음과 같이 설정하면 됩니다. input = ["some-analyzer:foo", "some-analyzer:bar"]

필드
input

string

위에서 설명한 대로 스트림 입력의 이름입니다.

주석

주석은 저작물의 리소스입니다. 확장 소재의 콘텐츠 키-값 매핑을 나타냅니다.

필드
name

string

주석의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}/annotations/{annotation}

user_specified_annotation

UserSpecifiedAnnotation

사용자가 제공한 주석입니다.

AnnotationCustomizedStruct

주석에서 맞춤설정된 구조체 표현

필드
elements

map<string, AnnotationValue>

요소 키와 요소의 주석 값 간의 매핑입니다.

AnnotationList

주석의 목록 표현입니다.

필드
values[]

AnnotationValue

LIST 데이터 유형 주석의 값입니다.

AnnotationMatchingResult

각 검색 결과 항목의 기준 주석 일치 결과를 저장합니다.

필드
criteria

Criteria

일치에 사용되는 기준입니다. 입력 검색 기준 또는 측정기준 선택에서 변환된 기준일 수 있습니다.

matched_annotations[]

Annotation

기준과 일치하는 주석입니다.

status

Status

일치 결과의 상태입니다. 가능한 값: FAILED_PRECONDITION - 기준을 일치시킬 수 없습니다. OK - 일치가 실행됩니다.

AnnotationValue

데이터 스키마에서 사용할 수 있는 모든 유형을 포함한 주석의 값입니다.

필드

통합 필드 value.

value는 다음 중 하나여야 합니다.

int_value

int64

int 유형 주석의 값입니다.

float_value

float

부동 소수점 유형 주석의 값입니다.

str_value

string

문자열 유형 주석의 값입니다.

datetime_value

string

날짜 시간 유형 주석의 값입니다.

geo_coordinate

GeoCoordinate

지리적 좌표 유형 주석의 값입니다.

proto_any_value

Any

모든 proto 값의 값입니다.

bool_value

bool

불리언 유형 주석의 값입니다.

list_value

AnnotationList

목록 유형 주석의 값입니다.

customized_struct_value

AnnotationCustomizedStruct

맞춤 구조체 유형 주석의 값입니다.

AppPlatformCloudFunctionRequest

Cloud 함수 기반 고객 처리 로직의 경우 고객의 Cloud 함수가 AppPlatformCloudFunctionRequest를 요청으로 수신하고 AppPlatformCloudFunctionResponse를 응답으로 다시 전송해야 합니다. AppPlatform에서 Cloud 함수로 전송되는 요청 메시지입니다.

필드
app_platform_metadata

AppPlatformMetadata

고객이 페이로드 소스를 식별할 수 있는 AppPlatform의 메타데이터입니다.

annotations[]

StructedInputAnnotation

맞춤설정된 Cloud 함수에서 처리할 실제 주석입니다.

StructedInputAnnotation

구조체 형식을 사용하여 다양한 구체적인 주석 protobuf을 나타내는 일반적인 주석 메시지입니다.

필드
ingestion_time_micros

int64

현재 주석의 처리 시간입니다.

annotation

Struct

실제 주석의 구조체 형식입니다.

AppPlatformCloudFunctionResponse

고객의 Cloud 함수에서 AppPlatform으로 전송된 응답 메시지입니다.

필드
annotations[]

StructedOutputAnnotation

AppPlatform으로 다시 반환되는 수정된 주석입니다. 주석 필드가 비어 있으면 AppPlatform에서 해당 주석을 삭제합니다.

annotation_passthrough

bool

이 속성을 true로 설정하면 AppPlatform은 주석이 제출된 파일에서 비어 있는 경우에도 주석을 삭제하는 대신 원본 주석을 사용합니다.

events[]

AppPlatformEventBody

AppPlatform에 다시 반환되는 이벤트 알림입니다. 일반적으로 Pub/Sub 연산자와 같이 이벤트를 처리하는 연산자에 소비/전달되도록 구성됩니다.

StructedOutputAnnotation

구조체 형식을 사용하여 다양한 구체적인 주석 protobuf을 나타내는 일반적인 주석 메시지입니다.

필드
annotation

Struct

실제 주석의 구조체 형식입니다.

AppPlatformEventBody

appPlatform 이벤트의 콘텐츠 메시지

필드
event_message

string

사람이 읽을 수 있는 이벤트 문자열입니다(예: '장면의 인원이 6명을 초과합니다' 또는 '선반이 비어 있습니다').

payload

Struct

Pub/Sub의 경우 메시지 속성에 저장됩니다. ​​pubsub.proto

event_id

string

이벤트를 분류하는 데 사용되는 사용자 정의 이벤트 ID입니다. 전송 간격 내에서 동일한 ID를 가진 동일한 애플리케이션 인스턴스의 이벤트는 중복 삭제되고 첫 번째 이벤트만 전송됩니다. 빈 event_id는 ''로 처리됩니다.

AppPlatformMetadata

앱 플랫폼의 필수 메타데이터 메시지 이 메시지는 일반적으로 고객이 데이터 소스를 식별할 수 있도록 특정 프로세서 출력 주석에 연결됩니다.

필드
application

string

애플리케이션 리소스 이름입니다.

instance_id

string

인스턴스 리소스 ID입니다. 인스턴스는 'instances' 컬렉션 아래에 있는 애플리케이션의 중첩된 리소스입니다.

node

string

애플리케이션 그래프의 노드 이름입니다.

processor

string

애플리케이션 노드의 참조된 프로세서 리소스 이름입니다.

애플리케이션

Application 객체를 설명하는 메시지

필드
name

string

리소스의 이름입니다.

create_time

Timestamp

출력 전용입니다. [출력 전용] 생성 타임스탬프

update_time

Timestamp

출력 전용입니다. [출력 전용] 업데이트 타임스탬프

labels

map<string, string>

키-값 쌍인 라벨입니다.

display_name

string

필수 입력란입니다. 솔루션의 사용자 친화적인 표시 이름입니다.

description

string

이 애플리케이션에 대한 설명입니다.

application_configs

ApplicationConfigs

애플리케이션 그래프 구성

runtime_info

ApplicationRuntimeInfo

출력 전용입니다. 애플리케이션 그래프 런타임 정보입니다. 애플리케이션 상태가 DEPLOYED(배포됨)와 같은 경우에만 존재합니다.

state

State

출력 전용입니다. 애플리케이션 상태입니다.

billing_mode

BillingMode

애플리케이션의 결제 모드입니다.

ApplicationRuntimeInfo

애플리케이션의 런타임 정보를 저장하는 메시지입니다.

필드
deploy_time

Timestamp

엔진이 배포된 시점의 타임스탬프입니다.

global_output_resources[]

GlobalOutputResource

창고 데이터 스키마와 같이 전 세계에서 생성된 리소스입니다.

monitoring_config

MonitoringConfig

이 애플리케이션의 모니터링 관련 구성입니다.

GlobalOutputResource

애플리케이션의 출력 리소스에 관한 메시지입니다.

필드
output_resource

string

출력된 리소스의 전체 리소스 이름입니다.

producer_node

string

출력 리소스 이름을 생성하는 그래프 노드의 이름입니다. 예: output_resource: /projects/123/locations/us-central1/corpora/my-corpus/dataSchemas/my-schema producer_node: occupancy-count

key

string

출력 리소스의 키로, 동일한 프로듀서 노드 내에서 고유해야 합니다. 하나의 프로듀서 노드는 여러 출력 리소스를 출력할 수 있으며, 키는 상응하는 출력 리소스를 일치시키는 데 사용할 수 있습니다.

MonitoringConfig

애플리케이션의 모니터링 관련 구성입니다.

필드
enabled

bool

이 애플리케이션에 모니터링이 사용 설정되어 있는지 여부입니다.

BillingMode

애플리케이션의 결제 모드

열거형
BILLING_MODE_UNSPECIFIED 기본값입니다.
PAYG 사용한 만큼만 지불 결제 모드
MONTHLY 월별 결제 모드

신청 상태

열거형
STATE_UNSPECIFIED 기본값입니다. 이 값은 상태가 생략된 경우에 사용됩니다.
CREATED CREATED 상태입니다.
DEPLOYING DEPLOYING(배포 중) 상태입니다.
DEPLOYED DEPLOYED(배포됨) 상태입니다.
UNDEPLOYING UNDEPLOYING 상태입니다.
DELETED DELETED 상태입니다.
ERROR ERROR 상태입니다.
CREATING CREATING 상태입니다.
UPDATING 상태 업데이트 중
DELETING 삭제 중 상태입니다.
FIXING 상태 수정

ApplicationConfigs

애플리케이션의 그래프를 저장하는 메시지입니다.

필드
nodes[]

Node

애플리케이션 그래프의 노드 목록입니다.

ApplicationInstance

인스턴스 생성에 관한 메시지입니다.

필드
instance_id

string

필수 입력란입니다. 요청하는 객체의 ID입니다.

instance

Instance

필수 입력란입니다. 생성 중인 리소스입니다.

ApplicationNodeAnnotation

애플리케이션 노드에 관한 주석을 설명하는 메시지입니다. 이 메시지는 StreamWithAnnotation.NodeAnnotation의 중복입니다.

필드
node

string

애플리케이션 그래프의 노드 이름입니다.

annotations[]

StreamAnnotation

노드별 스트림 주석입니다.

ApplicationStreamInput

단일 스트림 입력 구성에 관한 메시지입니다.

필드
stream_with_annotation

StreamWithAnnotation

애셋

애셋은 코퍼스의 리소스입니다. 자료 내의 미디어 객체를 나타내며 메타데이터와 다른 리소스 주석을 포함합니다. 저작물에 다양한 지형지물을 적용하여 주석을 생성할 수 있습니다. 사용자가 타겟 저작물과 관련된 주석을 지정할 수 있습니다.

필드
name

string

저작물의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/assets/{asset_id}

ttl

Duration

모든 미디어 애셋, 연결된 메타데이터, 검색 문서가 존재할 수 있는 기간입니다. 설정하지 않으면 상위 자료 리소스의 기본 ttl이 사용됩니다.

asset_gcs_source

AssetGcsSource

출력 전용입니다. 이 저작물과 연결된 원래 Cloud Storage 소스 URI입니다.

AssetSource

저작물의 소스입니다.

필드

통합 필드 source_form.

source_form는 다음 중 하나여야 합니다.

asset_gcs_source

AssetGcsSource

저작물의 소스는 Cloud Storage입니다.

asset_content_data

AssetContentData

애셋의 소스는 콘텐츠 바이트에서 가져옵니다.

AssetContentData

저작물의 콘텐츠입니다.

필드
asset_content_data

bytes

AssetGcsSource

저작물 소스는 Cloud Storage에 있습니다.

필드
gcs_uri

string

Cloud Storage URI

속성 값

연산자 속성의 실제 값을 나타냅니다.

필드
통합 필드 value. 속성 값입니다. value은 다음 중 하나여야 합니다.
i

int64

int.

f

float

부동 소수점 수입니다.

b

bool

bool.

s

bytes

문자열.

AutoscalingMetricSpec

원하는 복제본 수를 계산하기 위한 타겟 리소스 사용량 (CPU 사용량, 가속기의 가동 주기 등)을 정의하는 측정항목 사양입니다.

필드
metric_name

string

필수 입력란입니다. 리소스 측정항목 이름입니다. 지원되는 측정항목:

  • 온라인 예측의 경우:
  • aiplatform.googleapis.com/prediction/online/accelerator/duty_cycle
  • aiplatform.googleapis.com/prediction/online/cpu/utilization
target

int32

지정된 측정항목의 타겟 리소스 사용률 (1~100%)입니다. 실제 사용량이 타겟에서 일정 비율 이상 벗어나면 머신 복제본이 변경됩니다. 값을 제공하지 않으면 기본값은 60 (60%)입니다.

BatchRunProcessRequest

일괄적으로 프로세스를 실행하기 위한 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 생성 중인 모든 프로세스에서 공유하는 상위 리소스입니다.

requests[]

CreateProcessRequest

필수 입력란입니다. 생성 프로세스 요청

options

BatchRunProcessOptions

선택사항입니다. 일괄 처리 옵션

batch_id

string

출력 전용입니다. 배치 ID입니다.

BatchRunProcessOptions

일괄 처리 옵션

필드
retry_count

int32

프로세스당 재시도 횟수입니다. 기본값: 3입니다.

batch_size

int32

배치 크기입니다. 기본값: 5, 최대값: 100

BatchRunProcessResponse

일괄적으로 프로세스를 실행하기 위한 응답 메시지입니다.

필드
batch_id

string

배치 ID입니다.

processes[]

Process

프로세스가 생성되었습니다.

BigQueryConfig

BigQuery 프로세서의 구성 메시지입니다.

필드
table

string

Vision AI Platform에서 주석을 처리할 BigQuery 테이블 리소스입니다.

cloud_function_mapping

map<string, string>

데이터 스키마 기본적으로 Vision AI 애플리케이션은 다음 스키마를 사용하여 대상 BigQuery 테이블에 주석을 작성하려고 시도합니다.

ingestion_time: TIMESTAMP, 원본 데이터의 수집 시간입니다.

application: 주석을 생성하는 애플리케이션의 이름입니다(STRING).

인스턴스: 주석을 생성하는 인스턴스의 ID입니다(STRING).

노드: STRING, 주석을 생성하는 애플리케이션 그래프 노드의 이름입니다.

주석: STRING 또는 JSON. 실제 주석 protobuf은 bytes 필드가 64 인코딩된 문자열인 JSON 문자열로 변환됩니다. 문자열 또는 JSON 유형 열에 모두 쓸 수 있습니다.

주석 데이터를 기존 BigQuery 테이블로 전달하려면 고객이 스키마의 호환성을 확인해야 합니다. 이 맵은 애플리케이션 노드 이름을 해당하는 Cloud 함수 엔드포인트에 매핑하여 주석을 google.cloud.bigquery.storage.v1.AppendRowsRequest로 직접 변환합니다 (avro_rows 또는 proto_rows만 설정해야 함). 구성된 경우 상응하는 애플리케이션 노드에서 생성된 주석은 먼저 Cloud 함수로 전송된 후 BigQuery로 전달됩니다.

기본 테이블 스키마가 적합하지 않은 경우 고객은 CloudFunction을 사용하여 Vision AI 애플리케이션의 주석 출력을 임의의 BigQuery 테이블 스키마로 변환할 수 있습니다. * Cloud 함수는 AppPlatformCloudFunctionRequest를 수신하며 여기서 주석 필드는 Vision AI 주석의 JSON 형식입니다. * 클라우드 함수는 주석 필드에 저장된 AppendRowsRequest가 포함된 AppPlatformCloudFunctionResponse를 반환해야 합니다. * 주석을 삭제하려면 반환된 AppPlatformCloudFunctionResponse에서 주석 필드를 지우면 됩니다.

create_default_table_if_not_exists

bool

이 값이 true이면 지정된 테이블이 없으면 App Platform에서 기본 스키마로 BigQuery 데이터 세트와 BigQuery 테이블을 만듭니다. 시스템에서 원하는 스키마를 알 수 없으므로 Cloud 함수 맞춤 스키마가 지정된 경우에는 이 방법이 작동하지 않습니다. JSON 열은 App Platform에서 만든 기본 테이블에 사용됩니다.

BoolValue

필드
value

bool

채널

채널 객체를 설명하는 메시지입니다.

필드
name

string

리소스의 이름입니다.

create_time

Timestamp

출력 전용입니다. 생성 타임스탬프입니다.

update_time

Timestamp

출력 전용입니다. 업데이트 타임스탬프입니다.

labels

map<string, string>

키-값 쌍인 라벨입니다.

annotations

map<string, string>

클라이언트가 소량의 임의 데이터를 저장할 수 있는 주석

stream

string

필수 입력란입니다. 이 시리즈와 연결된 스트림입니다.

event

string

필수 입력란입니다. 이 시리즈와 연결된 이벤트입니다.

CircleArea

원 면적의 표현입니다.

필드
latitude

double

원 영역 중심의 위도입니다. 도 [-90~90]

longitude

double

원 영역 중심의 경도입니다. 도 [-180~180]

radius_meter

double

원의 반지름(미터)

ClassificationPredictionResult

이미지 및 텍스트 분류의 예측 출력 형식입니다.

필드
ids[]

int64

식별된 AnnotationSpec의 리소스 ID입니다.

display_names[]

string

식별된 AnnotationSpecs의 표시 이름 순서가 ID와 일치합니다.

confidences[]

float

예측된 ID의 정확성에 대한 모델의 신뢰도입니다. 값이 클수록 신뢰도가 높습니다. 순서가 ID와 일치합니다.

ClipAssetRequest

ClipAsset API 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 클립을 요청할 저작물의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/assets/{asset_id}

temporal_partition

TemporalPartition

필수 입력란입니다. 클립을 요청할 기간입니다.

ClipAssetResponse

ClipAsset API의 응답 메시지입니다.

필드
time_indexed_uris[]

TimeIndexedUri

요청된 시간 범위를 다루는 동영상 클립을 다운로드하기 위한 서명된 uri 목록으로, 시간순으로 정렬됩니다.

TimeIndexedUri

해당하는 기간으로 서명된 URI입니다.

필드
temporal_partition

TemporalPartition

URI가 적용되는 동영상의 시간 범위입니다.

uri

string

동영상 클립을 다운로드하기 위한 서명된 URI입니다.

클러스터

클러스터 객체를 설명하는 메시지

필드
name

string

출력 전용. 리소스의 이름입니다.

create_time

Timestamp

출력 전용입니다. 생성 타임스탬프입니다.

update_time

Timestamp

출력 전용입니다. 업데이트 타임스탬프입니다.

labels

map<string, string>

키-값 쌍인 라벨입니다.

annotations

map<string, string>

클라이언트가 소량의 임의 데이터를 저장할 수 있는 주석

dataplane_service_endpoint

string

출력 전용입니다. 데이터 영역 서비스의 DNS 이름

state

State

출력 전용입니다. 클러스터의 현재 상태입니다.

psc_target

string

출력 전용입니다. 비공개 서비스 연결 서비스 대상 이름입니다.

클러스터의 현재 상태입니다.

열거형
STATE_UNSPECIFIED 설정되지 않았습니다.
PROVISIONING PROVISIONING 상태는 클러스터가 생성 중임을 나타냅니다.
RUNNING RUNNING 상태는 클러스터가 생성되었고 완전히 사용 가능한 상태임을 나타냅니다.
STOPPING STOPPING 상태는 클러스터가 삭제 중임을 나타냅니다.
ERROR ERROR 상태는 클러스터를 사용할 수 없음을 나타냅니다. 자동으로 삭제됩니다.

ClusterInfo

필드
streams_count

int32

클러스터의 활성 스트림 수입니다.

processes_count

int32

클러스터에서 활성 상태인 프로세스 수입니다.

컬렉션

컬렉션은 자료의 리소스입니다. 원본 리소스에 대한 참조의 컨테이너 역할을 합니다.

필드
name

string

출력 전용입니다. 컬렉션의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/collections/{collection}

display_name

string

선택사항입니다. 표시할 컬렉션 이름입니다. 이름은 최대 256자(영문 기준)까지 가능합니다.

description

string

선택사항입니다. 컬렉션에 대한 설명입니다. 최대 25,000자(영문 기준)까지 가능합니다.

CollectionItem

CollectionItem은 컬렉션의 항목입니다. 각 항목은 컬렉션의 원본 리소스에 대한 참조입니다.

필드
collection

string

필수 입력란입니다. 이 상품이 속한 컬렉션 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/collections/{collection}

type

Type

필수 입력란입니다. 항목 유형입니다.

item_resource

string

필수 입력란입니다. CollectionItem의 이름입니다. 형식은 위의 type에 따라 다릅니다. ASSET: projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}

유형

CollectionItem 유형

열거형
TYPE_UNSPECIFIED 기본 유형의 항목은 발생해서는 안 됩니다.
ASSET 애셋 유형 항목

CommitRequest

읽기 진행 상황을 명시적으로 커밋하기 위한 메시지입니다.

이 속성은 초기 설정 요청에서 ReceivePacketsControlledMode가 설정된 경우에만 사용할 수 있습니다.

필드
offset

int64

커밋할 오프셋입니다.

ControlledMode

제어 모드에서 수신기의 옵션입니다.

필드
fallback_starting_offset

string

지정된 시작 오프셋을 사용할 수 없는 경우 대체할 논리적 시작점입니다.

다음 값 중 한 가지로 표시됩니다.

'begin': 사용 가능한 가장 오래된 메시지부터 읽습니다.

'end': 향후 메시지만 읽습니다.

통합 필드 starting_offset. 수신을 시작할 오프셋입니다. starting_offset은 다음 중 하나여야 합니다.
starting_logical_offset

string

다음과 같은 논리적 시작점으로 설정할 수 있습니다.

'begin': 사용 가능한 가장 오래된 메시지부터 읽습니다.

'most-recent': 사용 가능한 최신 메시지를 읽습니다.

'end': 향후 메시지만 읽습니다.

'저장됨': 마지막으로 커밋된 오프셋을 지나 1만큼 읽기를 재개합니다. 진행 상황을 재개하는 유일한 옵션입니다. 다른 모든 옵션은 일방적으로 건너뜁니다.

코퍼스

코퍼스는 관리를 위한 미디어 콘텐츠 집합입니다. 자료 내에서 미디어는 동일한 데이터 스키마를 공유합니다. 검색은 단일 자료 내에서 제한됩니다.

필드
name

string

자료의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}

display_name

string

필수 입력란입니다. UI에 표시할 자료 이름입니다. 이름은 최대 32자(영문 기준)까지 가능합니다.

description

string

선택사항입니다. 코퍼스에 대한 설명입니다. 최대 25,000자(영문 기준)까지 가능합니다.

default_ttl

Duration

선택사항입니다. 애셋 수준의 사용자 정의 TTL이 없는 자료의 모든 애셋에 적용되는 기본 TTL 값입니다. STREAM_VIDEO 유형 자료의 경우 이 필드는 필수이며 허용되는 최대 default_ttl은 10년입니다.

type

Type

선택사항입니다. 자료 내 애셋 유형입니다.

search_capability_setting

SearchCapabilitySetting

자료 수준의 기본 검색 기능 설정입니다.

유형

자료 내 애셋 유형입니다.

열거형
TYPE_UNSPECIFIED 기본 유형이며 사용해서는 안 됩니다. 이 기본 유형이 사용되면 자료가 STREAM_VIDEO 자료로 생성됩니다.
STREAM_VIDEO 저작물은 라이브 스트리밍 동영상 저작물입니다.
IMAGE 저작물은 이미지입니다.
VIDEO_ON_DEMAND 저작물은 동영상 저작물입니다.

CreateAnalysisRequest

분석을 만들기 위한 메시지

필드
parent

string

필수 입력란입니다. 상위 요소 값입니다.

analysis_id

string

필수 입력란입니다. 요청하는 객체의 ID입니다.

analysis

Analysis

필수 입력란입니다. 생성 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

CreateAnnotationRequest

CreateAnnotation 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 이 주석이 생성될 상위 리소스입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/assets/{asset_id}

annotation

Annotation

필수 입력란입니다. 만들 주석입니다.

annotation_id

string

선택사항입니다. 주석에 사용할 ID이며, 사용자가 지정하는 경우 주석의 리소스 이름에서 마지막 구성요소가 됩니다. 그렇지 않으면 주석 ID가 시스템에서 생성됩니다.

이 값은 최대 63자(영문 기준)여야 하며 유효한 문자는 /[a-z][0-9]-/입니다. 첫 번째 글자는 문자여야 하며 마지막 글자는 문자 또는 숫자여도 됩니다.

CreateApplicationInstancesRequest

애플리케이션에 스트림 입력을 추가하기 위한 메시지입니다.

필드
name

string

필수 항목입니다. 검색할 애플리케이션의 이름입니다. 형식: 'projects/{project}/locations/{location}/applications/{application}'

application_instances[]

ApplicationInstance

필수 입력란입니다. 생성 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

CreateApplicationInstancesResponse

이 유형에는 필드가 없습니다.

CreateApplicationInstance 응답 메시지입니다.

CreateApplicationRequest

애플리케이션을 만드는 메시지입니다.

필드
parent

string

필수 입력란입니다. 상위 요소 값입니다.

application_id

string

필수 입력란입니다. 요청하는 객체의 ID입니다.

application

Application

필수 입력란입니다. 생성 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

CreateAssetRequest

CreateAssetRequest의 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 이 애셋이 생성될 상위 리소스입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}

asset

Asset

필수 입력란입니다. 만들 애셋입니다.

asset_id

string

선택사항입니다. 애셋에 사용할 ID이며, 사용자가 지정하는 경우 애셋의 리소스 이름에서 마지막 구성요소가 됩니다. 그렇지 않으면 저작물 ID가 시스템에서 생성됩니다.

이 값은 최대 63자(영문 기준)여야 하며 유효한 문자는 /[a-z][0-9]-/입니다. 첫 번째 글자는 문자여야 하며 마지막 글자는 문자 또는 숫자여도 됩니다.

CreateClusterRequest

클러스터 만들기 메시지

필드
parent

string

필수 입력란입니다. 상위 요소 값입니다.

cluster_id

string

필수 입력란입니다. 요청하는 객체의 ID입니다.

cluster

Cluster

필수 입력란입니다. 생성 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

CreateCollectionMetadata

CreateCollectionRequest의 메타데이터 메시지

필드
operation_metadata

OperationMetadata

장기 실행 작업의 공통 메타데이터입니다.

CreateCollectionRequest

CreateCollection의 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 이 컬렉션이 생성될 상위 리소스입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}

collection

Collection

필수 입력란입니다. 생성할 컬렉션 리소스입니다.

collection_id

string

선택사항입니다. 컬렉션에 사용할 ID이며, 사용자가 지정하는 경우 리소스 이름의 마지막 구성요소가 됩니다. 그렇지 않으면 컬렉션 ID가 시스템에서 생성됩니다.

이 값은 최대 55자(영문 기준)여야 하며 유효한 문자는 /[a-z][0-9]-/입니다. 첫 번째 문자는 문자여야 하며 마지막 문자는 문자 또는 숫자여도 됩니다.

CreateCorpusMetadata

CreateCorpus API의 메타데이터입니다.

필드
create_time

Timestamp

자료 모음 생성 작업의 생성 시간입니다.

update_time

Timestamp

자료 만들기 작업의 업데이트 시간입니다.

CreateCorpusRequest

CreateCorpus API의 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 양식: projects/{project_number}/locations/{location_id}

corpus

Corpus

필수 입력란입니다. 생성할 코퍼스입니다.

CreateDataSchemaRequest

CreateDataSchema의 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 이 데이터 스키마가 생성될 상위 리소스입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}

data_schema

DataSchema

필수 입력란입니다. 만들 데이터 스키마입니다.

CreateDraftRequest

초안을 작성하기 위한 메시지입니다.

필드
parent

string

필수 입력란입니다. 상위 요소 값입니다.

draft_id

string

필수 입력란입니다. 요청하는 객체의 ID입니다.

draft

Draft

필수 입력란입니다. 생성 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

CreateEventRequest

이벤트 생성을 위한 메시지입니다.

필드
parent

string

필수 입력란입니다. 상위 요소 값입니다.

event_id

string

필수 입력란입니다. 요청하는 객체의 ID입니다.

event

Event

필수 입력란입니다. 생성 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

CreateIndexEndpointMetadata

CreateIndexEndpoint의 메타데이터 메시지입니다.

필드
operation_metadata

OperationMetadata

장기 실행 작업의 공통 메타데이터입니다.

CreateIndexEndpointRequest

CreateIndexEndpoint 요청 메시지입니다.

필드
parent

string

필수 항목입니다. 형식: projects/{project}/locations/{location}

index_endpoint_id

string

선택사항입니다. IndexEndpoint에 사용할 ID이며, 사용자가 지정하는 경우 IndexEndpoint의 리소스 이름에서 마지막 구성요소가 됩니다. 그렇지 않으면 IndexEndpoint ID가 자동 생성됩니다.

이 값은 최대 63자(영문 기준)여야 하며 유효한 문자는 a-z, 0-9, 대시(-)입니다. 첫 번째 문자는 문자여야 하며 마지막 문자는 문자 또는 숫자여야 합니다.

index_endpoint

IndexEndpoint

필수 입력란입니다. 생성 중인 리소스입니다.

CreateIndexMetadata

CreateIndexRequest의 메타데이터 메시지

필드
operation_metadata

OperationMetadata

장기 실행 작업의 공통 메타데이터입니다.

CreateIndexRequest

색인을 만들기 위한 메시지입니다.

필드
parent

string

필수 입력란입니다. 상위 요소 값입니다. 이 색인이 생성되는 자료의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}

index_id

string

선택사항입니다. 색인의 ID입니다. 이 이름은 색인의 최종 리소스 이름이 됩니다. 사용자가 이 값을 지정하지 않으면 시스템에서 생성합니다.

이 값은 최대 63자(영문 기준)여야 하며 유효한 문자는 /[a-z][0-9]-/입니다. 첫 번째 글자는 문자여야 하며 마지막 글자는 문자 또는 숫자여도 됩니다.

index

Index

필수 입력란입니다. 생성 중인 색인입니다.

CreateOperatorRequest

운영자 만들기 메시지

필드
parent

string

필수 입력란입니다. 상위 요소 값입니다.

operator_id

string

필수 입력란입니다. 요청하는 객체의 ID입니다.

operator

Operator

필수 입력란입니다. 생성 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

CreateProcessRequest

프로세스 생성을 위한 메시지입니다.

필드
parent

string

필수 입력란입니다. 상위 요소 값입니다.

process_id

string

필수 입력란입니다. 요청하는 객체의 ID입니다.

process

Process

필수 입력란입니다. 생성 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

CreateProcessorRequest

프로세서를 만드는 메시지입니다.

필드
parent

string

필수 입력란입니다. 상위 요소 값입니다.

processor_id

string

필수 입력란입니다. 요청하는 객체의 ID입니다.

processor

Processor

필수 입력란입니다. 생성 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

CreateSearchConfigRequest

CreateSearchConfig의 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 이 검색 구성이 생성될 상위 리소스입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}

search_config

SearchConfig

필수 입력란입니다. 만들 검색 구성입니다.

search_config_id

string

필수 입력란입니다. 새 검색 구성에 사용할 ID입니다. SearchConfig의 리소스 이름의 마지막 구성요소가 됩니다. 이 값은 최대 63자(영문 기준)여야 하며 유효한 문자는 /[a-z][0-9]-_/입니다. 첫 번째 문자는 문자여야 하며 마지막 문자는 문자 또는 숫자일 수 있습니다.

CreateSearchHypernymRequest

SearchHypernym 생성을 위한 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 이 SearchHypernym이 생성될 상위 리소스입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}

search_hypernym

SearchHypernym

필수 입력란입니다. 만들 SearchHypernym입니다.

search_hypernym_id

string

선택사항입니다. 검색 상위유명사 ID입니다. 생략하면 임의의 UUID가 생성됩니다.

CreateSeriesRequest

시리즈를 만드는 메시지입니다.

필드
parent

string

필수 입력란입니다. 상위 요소 값입니다.

series_id

string

필수 입력란입니다. 요청하는 객체의 ID입니다.

series

Series

필수 입력란입니다. 생성 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

CreateStreamRequest

스트림을 만들기 위한 메시지입니다.

필드
parent

string

필수 입력란입니다. 상위 요소 값입니다.

stream_id

string

필수 입력란입니다. 요청하는 객체의 ID입니다.

stream

Stream

필수 입력란입니다. 생성 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

기준

현재 검색 결과에 적용된 필터 기준입니다.

필드
field

string

필터링 기준을 적용할 UGA 필드 또는 ML 필드입니다.

fetch_matched_annotations

bool

이 기준에 따라 쿼리와 일치하는 주석을 반환합니다. 이 옵션은 파티션 수준 주석이 있는 포함 기준(제외 기준이 아님)에만 적용됩니다. 다음 데이터 유형을 지원합니다. - INTEGER - FLOAT - STRING (DataSchema.SearchStrategy.EXACT_SEARCH만 해당) - BOOLEAN

통합 필드 value.

value는 다음 중 하나여야 합니다.

text_array

StringArray

필드와 연결된 텍스트 값입니다.

int_range_array

IntRangeArray

필드와 연결된 정수 범위입니다.

float_range_array

FloatRangeArray

필드와 연결된 부동 소수점 범위입니다.

date_time_range_array

DateTimeRangeArray

필드와 연결된 날짜/시간 범위입니다.

geo_location_array

GeoLocationArray

지리적 위치 배열

bool_value

BoolValue

불리언 값입니다.

CustomProcessorSourceInfo

맞춤 프로세서의 소스 정보를 설명합니다.

필드
source_type

SourceType

맞춤 프로세서의 기능을 보유한 원래 제품입니다.

additional_info

map<string, string>

출력 전용입니다. 가져온 맞춤 프로세서와 관련된 추가 정보입니다. 데이터는 프로세서 생성 중에 앱 플랫폼에서 채웁니다.

model_schema

ModelSchema

모델의 서명을 지정하는 모델 스키마 파일입니다. VERTEX_CUSTOM 모델의 경우 인스턴스 스키마가 필요합니다. 프로세서 생성 중에 인스턴스 스키마가 지정되지 않으면 VisionAI Platform이 Vertex에서 가져오려고 시도합니다. 스키마가 없으면 생성에 실패합니다.

통합 필드 artifact_path. 앱 플랫폼이 커스텀 프로세서의 아티팩트를 로드하는 경로입니다. artifact_path은 다음 중 하나여야 합니다.
vertex_model

string

Vertex AI 플랫폼에 호스팅된 원본 모델의 리소스 이름입니다.

product_recognizer_artifact

ProductRecognizerArtifact

제품 인식기의 아티팩트입니다.

ModelSchema

스키마는 OpenAPI 3.0.2 스키마 객체로 정의됩니다.

필드
instances_schema

GcsSource

예측 및 설명 요청에 사용되는 단일 인스턴스의 형식을 정의하는 YAML 파일의 Cloud Storage 위치입니다.

parameters_schema

GcsSource

예측 및 설명 매개변수를 정의하는 YAML 파일의 Cloud Storage 위치입니다.

predictions_schema

GcsSource

단일 예측 또는 설명의 형식을 정의하는 YAML 파일의 Cloud Storage 위치입니다.

ProductRecognizerArtifact

제품 인식기 아티팩트를 설명하는 메시지입니다.

필드
retail_product_recognition_index

string

필수 입력란입니다. RetailProductRecognitionIndex의 리소스 이름입니다. 형식은 'projects/*/locations/*/retailCatalogs/*/retailProductRecognitionIndexes/*'입니다.

vertex_model

string

선택사항입니다. Vertex AI Platform에 호스팅된 임베딩 모델의 리소스 이름입니다.

SourceType

가져온 맞춤 프로세서의 소스 유형입니다.

열거형
SOURCE_TYPE_UNSPECIFIED 소스 유형이 지정되지 않았습니다.
VERTEX_AUTOML Vertex AutoML 제품에서 제공하는 맞춤 프로세서
VERTEX_CUSTOM Vertex의 일반 커스텀 모델에서 가져온 커스텀 프로세서입니다.
PRODUCT_RECOGNIZER 제품 인식기의 소스입니다.

DataSchema

데이터 스키마는 사용자가 지정한 주석이 시스템에서 어떻게 해석되는지 나타냅니다.

필드
name

string

데이터 스키마의 리소스 이름으로, projects/{project_number}/locations/{location}/corpora/{corpus}/dataSchemas/{data_schema} 형식입니다. 여기서 {data_schema} 부분은 아래의 key 필드와 동일해야 합니다.

key

string

필수 입력란입니다. 이 데이터 스키마의 키입니다. 이 키는 사용자가 지정한 주석의 키와 일치해야 하며 자료 내에서 고유해야 합니다. 이 값은 최대 63자(영문 기준)까지 가능하며 유효한 문자는 /[a-z][0-9]-/입니다. 첫 번째 글자는 문자여야 하며 마지막 글자는 문자 또는 숫자여도 됩니다.

schema_details

DataSchemaDetails

키에 매핑되는 스키마 세부정보입니다.

DataSchemaDetails

데이터 스키마 세부정보는 사용자 지정 주석의 키에 해당하는 데이터 유형과 데이터 구조를 나타냅니다.

필드
type

DataType

주석의 유형입니다.

proto_any_config

ProtoAnyConfig

protobuf 모든 유형의 구성입니다.

list_config

ListConfig

목록 데이터 유형의 구성입니다.

customized_struct_config

CustomizedStructConfig

CustomizedStruct 데이터 유형의 구성입니다.

granularity

Granularity

이 DataSchema와 연결된 세부사항입니다.

search_strategy

SearchStrategy

위의 key에 적용할 검색 전략입니다.

CustomizedStructConfig

CUSTOMIZED_STRUCT 데이터 유형의 구성입니다.

필드
field_schemas

map<string, DataSchemaDetails>

직접 하위 요소 데이터 스키마

DataType

주석의 데이터 유형입니다.

열거형
DATA_TYPE_UNSPECIFIED 알 수 없는 유형.
INTEGER 정수 유형입니다. 허용되는 검색 전략: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. IntRangeArray를 통한 쿼리를 지원합니다.
FLOAT 부동 유형입니다. 허용되는 검색 전략: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. FloatRangeArray를 통한 쿼리를 지원합니다.
STRING 문자열 유형입니다. 허용되는 검색 전략: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH, - DataSchema.SearchStrategy.SMART_SEARCH
DATETIME 지원되는 형식: %Y-%m-%dT%H:%M:%E*S%E*z (absl::RFC3339_full) %Y-%m-%dT%H:%M:%E*S %Y-%m-%dT%H:%M%E*z %Y-%m-%dT%H:%M %Y-%m-%dT%H%E*z %Y-%m-%dT%H %Y-%m-%d%E*z %Y-%m-%d %Y-%m %Y 허용되는 검색 전략: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH DateTimeRangeArray를 통한 쿼리를 지원합니다.
GEO_COORDINATE 지리적 좌표 유형입니다. 허용되는 검색 전략: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH. GeoLocationArray를 통한 쿼리를 지원합니다.
PROTO_ANY annotations.proto에서 사용 가능한 proto를 전달하도록 입력합니다. 내부에서만 사용하세요. 사용 가능한 프로토타입 및 해당 검색 동작: - ImageObjectDetectionPredictionResult: display_names 및 NO_SEARCH에서 SMART_SEARCH를 허용합니다. - ClassificationPredictionResult: display_names 및 NO_SEARCH에서 SMART_SEARCH를 허용합니다. - ImageSegmentationPredictionResult: NO_SEARCH를 허용합니다. - VideoActionRecognitionPredictionResult: display_name 및 NO_SEARCH에서 SMART_SEARCH를 허용합니다. - VideoObjectTrackingPredictionResult: display_name 및 NO_SEARCH에서 SMART_SEARCH를 허용합니다. - VideoClassificationPredictionResult: display_name 및 NO_SEARCH에서 SMART_SEARCH를 허용합니다. - OccupancyCountingPredictionResult: stats.full_frame_count.count 및 NO_SEARCH에서 EXACT_SEARCH를 허용합니다. - ObjectDetectionPredictionResult: identified_boxes.entity.label_string 및 NO_SEARCH에서 SMART_SEARCH를 허용합니다.
BOOLEAN 불리언 유형입니다. 허용되는 검색 전략: - DataSchema.SearchStrategy.NO_SEARCH, - DataSchema.SearchStrategy.EXACT_SEARCH.
LIST 목록 유형 - 목록의 각 요소는 정확히 동일한 데이터 스키마여야 합니다. 그러지 않으면 잘못된 인수가 됩니다. - 목록 수준에서는 검색 전략을 설정할 수 없습니다. 리프 노드 수준에서는 가능합니다. - 요소는 다른 목록이 될 수 없습니다 (목록의 목록 없음). - 요소는 CUSTOMIZED_STRUCT일 수 있으며 최대 레이어 수는 10개입니다.
CUSTOMIZED_STRUCT 구조체 유형입니다. - SearchStrategy: * CUSTOMIZED_STRUCT인 데이터 스키마는 검색 전략을 설정할 수 없습니다. * 리프 노드 요소는 요소의 SearchStrategy 제한사항에 따라 검색 전략을 설정할 수 있습니다. - 중첩된 레이어 제한: * CUSTOMIZED_STRUCT인 데이터 스키마는 필드가 CUSTOMIZED_STRUCT일 수도 있지만 전체 레이어 제한은 10입니다.

세부사항

이 DataSchema 아래의 주석 세부사항입니다.

열거형
GRANULARITY_UNSPECIFIED 지정되지 않은 세부사항입니다.
GRANULARITY_ASSET_LEVEL 애셋 수준 세분성 (주석에 파티션 정보가 포함되어서는 안 됨)
GRANULARITY_PARTITION_LEVEL 파티션 수준 세부사항 (주석에 파티션 정보가 포함되어야 함)

ListConfig

LIST 데이터 유형의 구성입니다.

필드
value_schema

DataSchemaDetails

목록에 있는 값의 데이터 스키마입니다.

ProtoAnyConfig

PROTO_ANY 데이터 유형의 구성입니다.

필드
type_uri

string

proto 메시지의 유형 URI입니다.

SearchStrategy

key의 주석 값에 대한 검색 전략입니다.

필드
search_strategy_type

SearchStrategyType

위의 key에 적용할 검색 전략의 유형입니다. 허용되는 search_strategy_type는 데이터 유형에 따라 다르며 DataSchemaDetails.DataType에 설명되어 있습니다. 데이터 유형에 지원되지 않는 search_strategy_type를 지정하면 INVALID_ARGUMENT 오류가 발생합니다.

SearchStrategyType

주석 키에 적용할 검색 전략의 유형입니다.

열거형

DataType

지원되는 모든 데이터 유형

열거형
DATA_TYPE_UNSPECIFIED DataType의 기본값입니다.
VIDEO H264와 같은 동영상 데이터 유형입니다.
IMAGE 이미지 데이터 유형입니다.
PROTO 일반적으로 일반 데이터 blob에 사용되는 Protobuf 데이터 유형입니다.
PLACEHOLDER 모든 데이터 유형을 지원하는 범용 입력 프로세서에 적용할 수 있는 자리표시자 데이터 유형입니다. 이는 인스턴스 배포 중에 인스턴스화되고 구체적인 기본 DataType로 대체됩니다.

DateTimeRange

기간 유형입니다.

필드
start

DateTime

시작 날짜 시간입니다.

end

DateTime

데이터 종료 시간입니다.

DateTimeRangeArray

날짜/시간 범위 값 목록입니다.

필드
date_time_ranges[]

DateTimeRange

기간(날짜 및 시간)

DedicatedResources

DeployedModel 전용이며 더 높은 수준의 수동 구성이 필요한 리소스에 대한 설명입니다.

필드
machine_spec

MachineSpec

필수 항목입니다. 변경할 수 없습니다. 예측에 사용되는 단일 머신의 사양입니다.

min_replica_count

int32

필수 입력란입니다. 변경할 수 없습니다. 이 DeployedModel이 항상 배포되는 최소 머신 복제본 수입니다. 값은 1 이상이어야 합니다.

DeployedModel에 대한 트래픽이 증가하면 더 많은 복제본에 동적으로 배포될 수 있으며, 트래픽이 감소하면 이러한 추가 복제본 중 일부가 해제될 수 있습니다.

max_replica_count

int32

변경할 수 없습니다. 이 DeployedModel에 대한 트래픽이 증가할 때 이 DeployedModel이 배포될 수 있는 최대 복제본 수입니다. 요청된 값이 너무 크면 배포에 오류가 발생하지만 배포에 성공하면 서비스 중단을 제외하고 모델을 해당 수의 복제본으로 확장할 수 있습니다. DeployedModel에 대한 트래픽이 복제본이 최대한 처리할 수 있는 수준을 초과하면 트래픽의 일부가 삭제됩니다. 이 값을 제공하지 않으면 min_replica_count이 기본값으로 사용됩니다.

이 필드의 값은 Vertex CPU 및 GPU 할당량에 대한 청구에 영향을 미칩니다. 구체적으로 max_replica_count * 선택한 머신 유형의 코어 수) 및 (max_replica_count * 선택한 머신 유형의 복제본당 GPU 수)가 청구됩니다.

autoscaling_metric_specs[]

AutoscalingMetricSpec

변경할 수 없습니다. 리소스 사용률 측정항목 (CPU 사용률, 가속기의 듀티 사이클 등) 목표 값을 재정의하는 측정항목 사양입니다 (설정하지 않으면 기본값 60). 측정항목당 최대 1개의 항목이 허용됩니다.

machine_spec.accelerator_count가 0보다 크면 자동 확장은 CPU 사용률과 가속기의 듀티 사이클 측정항목을 모두 기반으로 하며, 어느 한 측정항목이 목표 값을 초과하면 확장하고 두 측정항목이 모두 목표 값 미만이면 축소합니다. 두 측정항목의 기본 타겟 값은 60입니다.

machine_spec.accelerator_count이 0이면 자동 확장은 CPU 사용률 측정항목을 기반으로 하며, 명시적으로 설정하지 않은 경우 기본 타겟 값 60이 적용됩니다.

예를 들어 온라인 예측의 경우 목표 CPU 사용률을 80으로 재정의하려면 autoscaling_metric_specs.metric_nameaiplatform.googleapis.com/prediction/online/cpu/utilization로, autoscaling_metric_specs.target80로 설정해야 합니다.

DeleteAnalysisRequest

분석 삭제 메시지

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

DeleteAnnotationRequest

DeleteAnnotation API의 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 삭제할 주석의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}/annotations/{annotation}

DeleteApplicationInstancesRequest

애플리케이션에서 스트림 입력을 삭제하기 위한 메시지입니다.

필드
name

string

필수 항목입니다. 검색할 애플리케이션의 이름입니다. 형식: 'projects/{project}/locations/{location}/applications/{application}'

instance_ids[]

string

필수 입력란입니다. 요청하는 객체의 ID입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

DeleteApplicationInstancesResponse

이 유형에는 필드가 없습니다.

DeleteApplicationInstance 응답 메시지입니다.

DeleteApplicationRequest

애플리케이션 삭제 메시지

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

force

bool

선택사항입니다. true로 설정하면 이 애플리케이션의 인스턴스 및 초안도 삭제됩니다. 그렇지 않으면 애플리케이션에 인스턴스와 초안이 없는 경우에만 요청이 작동합니다.

DeleteAssetMetadata

이 유형에는 필드가 없습니다.

metadata 필드에 삽입되는 DeleteAsset API의 메타데이터입니다.

DeleteAssetRequest

DeleteAsset 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 삭제할 저작물의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}

DeleteClusterRequest

클러스터를 삭제하기 위한 메시지입니다.

필드
name

string

필수 입력란입니다. 리소스의 이름

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

force

bool

선택사항입니다. true로 설정하면 클러스터의 모든 하위 리소스가 삭제됩니다. 그렇지 않으면 클러스터에 하위 요소가 없는 경우에만 요청이 작동합니다.

DeleteCollectionMetadata

DeleteCollectionRequest의 메타데이터 메시지

필드
operation_metadata

OperationMetadata

장기 실행 작업의 공통 메타데이터입니다.

DeleteCollectionRequest

DeleteCollectionRequest 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 삭제할 컬렉션의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/collections/{collection}

DeleteCorpusRequest

DeleteCorpus 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 삭제할 자료의 리소스 이름입니다.

DeleteDataSchemaRequest

DeleteDataSchema 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 삭제할 데이터 스키마의 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/dataSchemas/{data_schema_id}

DeleteDraftRequest

초안 삭제 메시지

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

DeleteEventRequest

이벤트 삭제 메시지

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

DeleteIndexEndpointMetadata

DeleteIndexEndpoint의 메타데이터 메시지입니다.

필드
operation_metadata

OperationMetadata

장기 실행 작업의 공통 메타데이터입니다.

DeleteIndexEndpointRequest

DeleteIndexEndpoint 요청 메시지입니다.

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

DeleteIndexMetadata

이 유형에는 필드가 없습니다.

DeleteIndexRequest의 메타데이터 메시지

DeleteIndexRequest

DeleteIndex 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 삭제할 색인의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/indexes/{index}

DeleteOperatorRequest

운영자 삭제 메시지

필드
name

string

필수 입력란입니다. 리소스의 이름

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

DeleteProcessRequest

프로세스 삭제 메시지

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

DeleteProcessorRequest

프로세서 삭제 메시지

필드
name

string

필수 입력란입니다. 리소스의 이름

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

DeleteSearchConfigRequest

DeleteSearchConfig 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 삭제할 검색 구성의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/searchConfigs/{search_config}

DeleteSearchHypernymRequest

SearchHypernym 삭제 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 삭제할 SearchHypernym의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/searchHypernyms/{search_hypernym}

DeleteSeriesRequest

시리즈 삭제 메시지

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

DeleteStreamRequest

스트림 삭제 메시지

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

DeployApplicationRequest

애플리케이션 배포 메시지

필드
name

string

필수 항목입니다. 검색할 애플리케이션의 이름입니다. 형식: 'projects/{project}/locations/{location}/applications/{application}'

validate_only

bool

설정하면 요청을 검증하고 애플리케이션 그래프를 미리 봅니다. 하지만 실제로 배포하지는 않습니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

enable_monitoring

bool

선택사항입니다. 배포 시 애플리케이션의 모니터링을 사용 설정할지 여부입니다.

DeployApplicationResponse

이 유형에는 필드가 없습니다.

RPC 요청 메시지 DeployApplication 응답 메시지입니다.

DeployIndexMetadata

DeployIndex의 메타데이터 메시지입니다.

필드
operation_metadata

OperationMetadata

장기 실행 작업의 공통 메타데이터입니다.

deployed_index

string

출력 전용입니다. 배포 중인 색인입니다.

DeployIndexRequest

DeployIndex 요청 메시지입니다.

필드
index_endpoint

string

필수 입력란입니다. 색인이 배포되는 IndexEndpoint입니다. 형식: projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}

deployed_index

DeployedIndex

필수 입력란입니다. 배포할 색인입니다.

DeployIndexResponse

이 유형에는 필드가 없습니다.

작업이 완료된 후 DeployIndex 응답

DeployRetailProductRecognitionIndexResponse

이 유형에는 필드가 없습니다.

DeployRetailProductRecognitionIndex 응답 메시지입니다.

DeployedIndex

색인 배포입니다.

필드
index

string

필수 입력란입니다. 배포된 색인의 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/indexes/{index_id}

DeployedIndexReference

DeployedIndex를 가리킵니다.

필드
index_endpoint

string

변경할 수 없습니다. IndexEndpoint의 리소스 이름입니다.

초안

Draft 객체를 설명하는 메시지

필드
name

string

리소스의 이름입니다.

create_time

Timestamp

출력 전용입니다. [출력 전용] 생성 타임스탬프

update_time

Timestamp

출력 전용입니다. [출력 전용] 생성 타임스탬프

labels

map<string, string>

키-값 쌍인 라벨입니다.

display_name

string

필수 입력란입니다. 솔루션의 사용자 친화적인 표시 이름입니다.

description

string

이 애플리케이션에 대한 설명입니다.

draft_application_configs

ApplicationConfigs

애플리케이션으로 업데이트되지 않은 애플리케이션 구성 초안입니다.

EagerMode

이 유형에는 필드가 없습니다.

eager 모드에서 수신자의 옵션입니다.

이벤트

Event 객체를 설명하는 메시지입니다.

필드
name

string

리소스의 이름입니다.

create_time

Timestamp

출력 전용입니다. 생성 타임스탬프입니다.

update_time

Timestamp

출력 전용입니다. 업데이트 타임스탬프입니다.

labels

map<string, string>

키-값 쌍인 라벨입니다.

annotations

map<string, string>

클라이언트가 소량의 임의 데이터를 저장할 수 있는 주석

alignment_clock

Clock

스트림을 결합하는 데 사용되는 시계입니다.

grace_period

Duration

이벤트를 정리할 수 있는 유예 기간입니다. 컨트롤러가 이벤트를 삭제하기 전에 기다리는 시간입니다. 이 기간 동안 이벤트에 활성 채널이 있는 경우 grace_period 이후의 이벤트 삭제는 무시됩니다.

시계

스트림을 결합하는 데 사용되는 시계입니다.

열거형
CLOCK_UNSPECIFIED 시계가 지정되지 않았습니다.
CAPTURE 데이터가 캡처될 때 타임스탬프를 사용합니다. 클라이언트는 시계를 동기화해야 합니다.
INGEST 데이터가 수신될 때 타임스탬프를 사용합니다.

EventUpdate

이벤트 업데이트 메시지입니다.

필드
stream

string

이벤트가 연결된 스트림의 이름입니다.

event

string

이벤트 이름입니다.

series

string

시리즈의 이름입니다.

update_time

Timestamp

이벤트 업데이트가 발생한 시점의 타임스탬프입니다.

offset

int64

메시지 수신을 확인하는 데 사용되는 메시지의 오프셋입니다.

EventUpdateFilter

EventUpdateFilter는 관찰자가 수신하려는 이벤트 업데이트를 지정할 수 있는 필터입니다.

필드

통합 필드 start_time.

start_time는 다음 중 하나여야 합니다.

special_mode

SpecialMode

특정 타임스탬프 이외의 특수 모드

specific_time

Timestamp

이벤트 업데이트가 발생한 후의 특정 타임스탬프입니다.

SpecialMode

특정 타임스탬프 이외의 특수 모드

열거형
SPECIAL_MODE_UNSPECIFIED 지정되지 않은 특수 모드입니다.
BEGINNING BEGINNING(시작) 특수 모드는 현재 사용 가능한 모든 이벤트와 수신되는 이벤트 업데이트를 의미합니다.
LATEST LATEST(최신) 특수 모드는 최신 이벤트 및 수신 중인 이벤트 업데이트만 표시합니다.

EventUpdateType

이벤트 업데이트 유형입니다. 향후 다른 사용 사례에 맞게 확장될 수 있습니다(예: EVENT_DETACHED_FROM_STREAM 등).

열거형
EVENT_UPDATE_TYPE_UNSPECIFIED 이벤트 업데이트 유형이 지정되지 않았습니다.
EVENT_AVAILABLE_ON_STREAM 스트림에서 이벤트를 읽을 수 있습니다.
EVENT_HEARTBEAT gRPC 연결의 활성을 추적하는 데 사용되는 하트비트 메시지입니다.

ExportRetailProductRecognitionIndexCoverageResponse

이 유형에는 필드가 없습니다.

RetailProductRecognitionIndex 노출 영역 파일 내보내기에 대한 응답 메시지입니다.

FacetBucket

측정기준 값, 선택 상태, 메타데이터를 보유합니다.

필드
selected

bool

하나의 측정기준 버킷이 선택되었는지 여부입니다. 이 필드는 사용자의 측정기준 선택을 나타냅니다. SearchVideosRequest의 프런트엔드에서 설정합니다.

통합 필드 bucket_value. 패싯과 연결된 버킷입니다. 예를 들어 측정기준 '팀'의 버킷은 '49ers', 'patriots' 등이 될 수 있고, 측정기준 '선수'의 버킷은 'tom brady', 'drew brees' 등이 될 수 있습니다. bucket_value은 다음 중 하나일 수 있습니다.
value

FacetValue

특이 값

range

Range

범위 값입니다.

범위

면 분할이 적용되는 값 범위[start, end)입니다.

필드
start

FacetValue

범위의 시작입니다. 존재하지 않는 것은 일부 경계 (예: -inf)를 나타냅니다.

end

FacetValue

범위의 끝입니다. 존재하지 않는 것은 일부 경계 (예: inf)를 나타냅니다.

FacetBucketType

측정기준 버킷의 다양한 유형

열거형
FACET_BUCKET_TYPE_UNSPECIFIED 알 수 없는 유형.
FACET_BUCKET_TYPE_VALUE 값 유형입니다.
FACET_BUCKET_TYPE_DATETIME 날짜/시간 유형입니다.
FACET_BUCKET_TYPE_FIXED_RANGE 범위 유형을 수정했습니다.
FACET_BUCKET_TYPE_CUSTOM_RANGE 맞춤 범위 유형

FacetGroup

백엔드와 프런트엔드 간에 전달되는 측면 버킷 그룹입니다.

필드
facet_id

string

측정기준 그룹의 고유 ID입니다.

display_name

string

패싯의 표시 이름입니다. UI에서 측정기준 렌더링에 사용합니다.

buckets[]

FacetBucket

패싯과 연결된 버킷입니다. 예를 들어 '팀' 측정기준의 경우 버킷은 49ers, patriots 등이 될 수 있습니다.

bucket_type

FacetBucketType

Facet bucket type

fetch_matched_annotations

bool

이 속성이 true이면 이 측정기준 그룹의 선택에 대해 쿼리 일치 주석을 반환합니다. 이 옵션은 파티션 수준 주석을 기반으로 하는 측정기준에만 적용됩니다. 다음과 같은 측정기준 값을 지원합니다. - INTEGER - STRING (DataSchema.SearchStrategy.EXACT_SEARCH만 해당)

FacetProperty

패싯의 중앙 구성입니다.

필드
mapped_fields[]

string

사용자가 검색 결과를 세분화하는 데 사용할 측정기준인 상품 속성의 이름입니다. mapped_fields는 UserSpecifiedDataSchema 키와 일치합니다.

예를 들어 사용자는 동일한 키(예: player:adam, player:bob, player:charles)를 사용하여 여러 UGA를 추가할 수 있습니다. mapped_fields가 여러 개 지정된 경우 값을 최종 패싯 값으로 병합합니다. 예를 들어 home_team: a, home_team:b, away_team:a, away_team:c인 경우 facet_field = [home_team, away_team]이면 facet_value는 [a, b, c]가 됩니다.

1:1 측정기준 측정기준 (mapped_fields.size() == 1)이고 mapped_field가 상위 SearchConfig.name과 같은 경우가 아니라면 상위 요소에 동일한 필드에 매핑되는 SearchCriteriaProperty도 포함되어야 합니다. mapped_fields는 비어 있지 않아야 합니다.

display_name

string

패싯의 표시 이름입니다. UI에서 측정기준 렌더링에 사용합니다.

result_size

int64

하나의 패싯에 대해 반환할 최대 고유 버킷 수입니다. '선수'와 같이 카디널리티가 높은 측정기준의 경우 버킷 수가 클 수 있습니다. 사용자에게 가장 관련성이 높은 상위 n개만 반환합니다. 0보다 작거나 같은 경우 서버에서 적절한 result_size를 결정합니다.

bucket_type

FacetBucketType

패싯 버킷 유형(예: 값, 범위)

통합 필드 range_facet_config.

range_facet_config는 다음 중 하나여야 합니다.

fixed_range_bucket_spec

FixedRangeBucketSpec

고정 범위 측정기준 버킷 구성을 수정했습니다.

custom_range_bucket_spec

CustomRangeBucketSpec

맞춤 범위 측정기준 버킷 구성

datetime_bucket_spec

DateTimeBucketSpec

기간 측정기준 버킷 구성입니다.

CustomRangeBucketSpec

버킷 유형이 CUSTOM_RANGE인 경우 값을 버케팅하는 방법을 지정합니다. 정수 버킷 값을 예로 들면 엔드포인트가 0, 10, 100, 1,000인 경우 [-inf, 0), [0, 10), [10, 100), [100, 1000), [1000, inf) 패싯이 생성됩니다. 특히: - 엔드포인트는 오름차순으로 나열해야 합니다. 그러지 않으면 SearchConfig API에서 측정기준 구성을 거부합니다. - 엔드포인트가 1개 미만이면 잘못된 사양입니다.

필드
endpoints[]

FacetValue

현재 이 필드에는 정수 유형만 지원됩니다.

DateTimeBucketSpec

버킷 유형이 DATE인 경우 날짜 값을 버케팅하는 방법을 지정합니다.

필드
granularity

Granularity

날짜 유형 측면의 세부사항입니다.

세부사항

날짜/시간 버킷의 세부사항 열거형입니다.

열거형
GRANULARITY_UNSPECIFIED 지정되지 않은 세부사항입니다.
YEAR 단위는 연도입니다.
MONTH 단위는 월입니다.
DAY 단위는 일입니다.

FixedRangeBucketSpec

버킷 유형이 FIXED_RANGE인 경우 값을 버케팅하는 방법을 지정합니다. 동일한 세부사항으로 여러 버킷을 만들려면 FixedRangeBucketSpec을 사용하세요. 정숫값 버킷을 예로 들면 bucket_start = 0, bucket_granularity = 10, bucket_count = 5인 경우 이 패싯은 [-inf, 0), [0, 10), [10, 20), [20, 30), [30, inf) 버킷을 통해 집계됩니다. 특히 bucket_count <= 1은 잘못된 사양입니다.

필드
bucket_start

FacetValue

버킷의 하한. 참고: 현재 이 필드에는 정수 유형만 지원됩니다.

bucket_granularity

FacetValue

버킷 세부사항 참고: 현재 이 필드에는 정수 유형만 지원됩니다.

bucket_count

int32

총 버킷 수이며

FacetValue

제네릭 유형이 있는 단일 값의 정의입니다.

필드

통합 필드 value.

value는 다음 중 하나여야 합니다.

string_value

string

문자열 유형 값입니다.

integer_value

int64

정수 유형 값입니다.

datetime_value

DateTime

날짜/시간 유형 값입니다.

FloatRange

부동 소수점 범위 유형입니다.

필드
start

float

부동 소수점 범위의 시작입니다.

end

float

부동 소수점 범위의 끝입니다.

FloatRangeArray

부동 소수점 범위 값 목록입니다.

필드
float_ranges[]

FloatRange

부동 소수점 범위 값입니다.

GcsOutputConfig

GcsOutputConfig를 설명하는 메시지

필드
gcs_path

string

Vision AI Platform에서 주석을 처리할 Cloud Storage 경로입니다.

GcsSource

입력 콘텐츠의 Google Cloud Storage 위치입니다.

필드
uris[]

string

필수 입력란입니다. Google Cloud Storage 경로 참조

GeneralObjectDetectionConfig

이 유형에는 필드가 없습니다.

일반 객체 감지 프로세서의 구성 메시지입니다.

GenerateHlsUriRequest

GenerateHlsUri API의 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 클립을 요청할 저작물의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/assets/{asset_id}

temporal_partitions[]

TemporalPartition

클립을 요청할 기간입니다. get_live_view이 True로 설정된 경우 무시됩니다. 요청된 총 시간 범위는 24시간 미만이어야 합니다.

live_view_enabled

bool

최대 3분 길이의 백로그 데이터가 포함된 저작물의 라이브 스트림을 독점적으로 표시하는 옵션입니다.

GenerateHlsUriResponse

GenerateHlsUri API의 응답 메시지입니다.

필드
uri

string

요청된 시간에 해당하는 HLS 매니페스트를 다운로드하기 위한 서명된 URI입니다.

temporal_partitions[]

TemporalPartition

스트림에 표시되는 순서대로 반환되는 콘텐츠의 시간적 파티션 목록입니다.

GenerateRetrievalUrlRequest

GenerateRetrievalUrl API의 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 서명된 URL을 요청할 저작물의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/assets/{asset_id}

GenerateRetrievalUrlResponse

GenerateRetrievalUrl API의 응답 메시지입니다.

필드
signed_uri

string

저작물의 콘텐츠를 다운로드할 수 있는 서명된 URL입니다.

GenerateStreamHlsTokenRequest

스트림 HLS 콘텐츠에 액세스하기 위한 인증 토큰을 가져오기 위한 요청 메시지입니다.

필드
stream

string

필수 입력란입니다. 스트림의 이름입니다.

GenerateStreamHlsTokenResponse

GenerateStreamHlsToken의 응답 메시지입니다.

필드
token

string

생성된 JWT 토큰

호출자는 이 토큰을 HTTP 요청의 승인 헤더에 삽입하여 HLS 재생목록 매니페스트와 동영상 청크를 가져와야 합니다. 예: curl -H "Authorization: Bearer $TOKEN" https://domain.com/test-stream.playback/master.m3u8

expiration_time

Timestamp

토큰의 만료 시간입니다.

GeoCoordinate

위치 좌표 표현

필드
latitude

double

위도 좌표입니다. 도 [-90~90]

longitude

double

경도 좌표입니다. 도 [-180~180]

GeoLocationArray

위치 목록입니다.

필드
circle_areas[]

CircleArea

원 영역 목록입니다.

GetAnalysisRequest

분석을 가져오는 메시지입니다.

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

GetAnnotationRequest

GetAnnotation API에 대한 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 검색할 주석의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}/annotations/{annotation}

GetApplicationRequest

애플리케이션을 가져오는 메시지

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

GetAssetRequest

GetAsset 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 검색할 애셋의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}

GetClusterRequest

클러스터를 가져오기 위한 메시지입니다.

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

GetCollectionRequest

GetCollectionRequest 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 검색할 컬렉션의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/collections/{collection}

GetCorpusRequest

GetCorpus 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 검색할 자료의 리소스 이름입니다.

GetDataSchemaRequest

GetDataSchema 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 검색할 데이터 스키마의 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/dataSchemas/{data_schema_id}

GetDraftRequest

초안을 가져오는 메시지

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

GetEventRequest

이벤트를 가져오는 메시지입니다.

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

GetIndexEndpointRequest

GetIndexEndpoint 요청 메시지입니다.

필드
name

string

필수 입력란입니다. IndexEndpoint 리소스의 이름입니다.

GetIndexRequest

색인을 가져오기 위한 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 색인 리소스의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/indexes/{index}

GetInstanceRequest

인스턴스를 가져오는 메시지입니다.

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

GetProcessRequest

프로세스를 가져오기 위한 메시지입니다.

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

GetProcessorRequest

프로세서를 가져오는 메시지입니다.

필드
name

string

필수 항목입니다. 리소스의 이름입니다.

GetSearchConfigRequest

GetSearchConfig 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 검색할 검색 구성의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/searchConfigs/{search_config}

GetSearchHypernymRequest

SearchHypernym 가져오기 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 검색할 SearchHypernym의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/searchHypernyms/{search_hypernym}

ImageObjectDetectionPredictionResult

이미지 객체 감지의 예측 출력 형식입니다.

필드
ids[]

int64

식별된 AnnotationSpec의 리소스 ID로, 신뢰 점수순으로 내림차순으로 정렬됩니다. 전체 리소스 이름 대신 ID 세그먼트입니다.

display_names[]

string

식별된 AnnotationSpecs의 표시 이름 순서가 ID와 일치합니다.

confidences[]

float

예측된 ID의 정확성에 대한 모델의 신뢰도입니다. 값이 클수록 신뢰도가 높습니다. 순서가 ID와 일치합니다.

bboxes[]

ListValue

발견된 AnnotationSpecs를 정확하게 나타내는 경계 상자(이미지 위의 직사각형) ID와 일치하는 순서로 제공됩니다. 각 경계 상자는 상자의 극한 좌표를 나타내는 4개의 숫자 xMin, xMax, yMin, yMax의 배열입니다. 좌표는 이미지 크기를 기준으로 하며 0,0 지점은 이미지 왼쪽 상단에 있습니다.

ImageQuery

검색 엔드포인트 요청의 이미지 쿼리입니다.

필드

통합 필드 image.

image는 다음 중 하나여야 합니다.

input_image

bytes

원시 바이트의 입력 이미지입니다.

asset

string

저작물의 리소스 이름입니다. IMAGE 자료 유형에서만 지원됩니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/assets/{asset_id}

ImageSegmentationPredictionResult

이미지 세분화를 위한 예측 출력 형식입니다.

필드
category_mask

string

마스크의 각 픽셀이 원본 이미지의 픽셀이 속할 것으로 예측된 카테고리를 나타내는 PNG 이미지입니다. 이 이미지의 크기는 원본 이미지와 동일합니다. AnntoationSpec과 색상 간의 매핑은 모델의 메타데이터에서 확인할 수 있습니다. 모델은 가장 가능성이 높은 카테고리를 선택하며, 카테고리 중 어느 것도 신뢰도 임곗값에 도달하지 않으면 픽셀이 배경으로 표시됩니다.

confidence_mask

string

8비트 무손실 PNG로 인코딩된 1채널 이미지입니다. 이미지 크기는 원본 이미지와 동일합니다. 특정 픽셀의 경우 색상이 어두울수록 해당 픽셀의 categoryMask에 있는 카테고리의 정확성에 대한 신뢰도가 낮습니다. 검은색은 확신이 없음을, 흰색은 완전한 확신을 의미합니다.

ImportAssetsMetadata

ImportAssets LRO의 메타데이터 메시지입니다.

필드
metadata

OperationMetadata

작업의 메타데이터입니다.

ImportAssetsRequest

ImportAssets의 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 애셋이 가져올 상위 자료 리소스입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}

통합 필드 source. 소스 source은 다음 중 하나여야 합니다.
assets_gcs_uri

string

이 파일에는 가져올 모든 저작물 정보가 포함되어 있습니다. * 파일은 JSONL 형식입니다. * 각 행은 하나의 저작물에 해당합니다. * 각 줄은 InputImageAsset 프로토로 변환됩니다.

ImportAssetsResponse

이 유형에는 필드가 없습니다.

ImportAssets LRO의 응답 메시지입니다.

ImportRetailProductsResponse

이 유형에는 필드가 없습니다.

작업이 완료된 후 ImportProducts 응답

색인

색인은 텍스트 모음의 리소스입니다. 여기에는 색인이 생성된 애셋 및 주석 버전이 포함됩니다. 엔드포인트에 배포하면 사용자가 색인을 검색할 수 있습니다.

필드
name

string

출력 전용입니다. 색인 리소스의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/indexes/{index_id}

display_name

string

선택사항입니다. 색인의 사용자 지정 표시 이름(선택사항)입니다.

description

string

선택사항입니다. 색인에 대한 설명(선택사항)입니다.

state

State

출력 전용입니다. 색인의 상태입니다.

create_time

Timestamp

출력 전용입니다. 생성 타임스탬프입니다.

update_time

Timestamp

출력 전용입니다. 업데이트 타임스탬프입니다.

deployed_indexes[]

DeployedIndexReference

출력 전용입니다. 배포된 색인 인스턴스에 대한 참조입니다. VIDEO_ON_DEMAND 자료의 색인에는 배포된 색인이 최대 1개 있을 수 있습니다. 이미지 코퍼스의 색인에는 여러 개의 배포된 색인이 있을 수 있습니다.

통합 필드 asset_filter. 이 색인에 애셋을 선택하는 방법을 지정합니다. 지정하지 않으면 기본값은 entire_corpus입니다. UpdateIndex의 동작: update_mask에 asset_filter 필드 경로 중 하나가 포함된 경우 분석된 데이터 및 주석을 포함하여 최신 저작물로 색인이 다시 빌드됩니다. asset_filter은 다음 중 하나여야 합니다.
entire_corpus

bool

코퍼스의 모든 애셋을 포함합니다.

색인이 전체 기간 동안 순환할 수 있는 다양한 상태를 나타내는 열거형입니다.

열거형
STATE_UNSPECIFIED 기본값입니다. 사용해서는 안 됩니다.
CREATING CREATING 상태입니다.
CREATED CREATED 상태입니다.
UPDATING 상태가 UPDATING입니다.

IndexAssetMetadata

IndexAsset의 메타데이터입니다.

필드
indexing_status
(deprecated)

IndexingStatus

이 저작물의 색인 생성 상태입니다.

status

IndexingStatus

이 저작물의 색인 생성 상태입니다.

start_time

Timestamp

작업의 시작 시간입니다.

update_time

Timestamp

작업의 업데이트 시간입니다.

IndexingStatus

저작물의 색인 생성 상태입니다.

필드
state

State

이 저작물의 색인 생성 상태입니다.

status_message

string

상태를 설명하는 자세한 메시지입니다.

이 저작물의 색인을 생성하기 위한 상태 enum입니다.

열거형
STATE_UNSPECIFIED 기본 프로세스 상태는 발생해서는 안 됩니다.
IN_PROGRESS 색인 생성이 진행 중입니다.
SUCCEEDED 프로세스가 완료되었습니다.
FAILED 프로세스가 실패했습니다.

IndexAssetRequest

IndexAsset 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 색인 생성할 저작물의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/assets/{asset_id}

index

string

선택사항입니다. 색인의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/indexes/{index}

IndexAssetResponse

이 유형에는 필드가 없습니다.

IndexAsset의 응답 메시지입니다.

IndexEndpoint

IndexEndpoint 리소스를 나타내는 메시지입니다. ImageIndexes가 여기에 배포됩니다.

필드
name

string

출력 전용입니다. IndexEndpoint의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/indexEndpoints/{index_endpoint_id}

display_name

string

선택사항입니다. IndexEndpoint의 표시 이름입니다. 최대 32자(영문 기준)까지 가능합니다.

description

string

선택사항입니다. IndexEndpoint에 대한 설명입니다. 최대 25,000자(영문 기준)까지 가능합니다.

deployed_index

DeployedIndex

출력 전용입니다. 이 IndexEndpoint에 배포된 색인입니다.

state

State

출력 전용입니다. IndexEndpoint 상태입니다.

labels

map<string, string>

선택사항입니다. 리소스에 적용된 라벨은 다음 요구사항을 충족해야 합니다.

  • 각 리소스는 여러 개의 라벨(최대 64개)을 가질 수 있습니다.
  • 각 라벨은 키-값 쌍이어야 합니다.
  • 키는 비워 둘 수 없으며 최소 길이는 1자이고 최대 길이는 63자입니다. 값은 비워 둘 수 있으며 최대 길이는 63자(영문 기준)입니다.
  • 키와 값에는 소문자, 숫자, 밑줄, 대시만 사용할 수 있습니다. 모든 문자는 UTF-8 인코딩을 사용해야 하며 국제 문자가 허용됩니다.
  • 라벨의 키 부분은 고유해야 합니다. 그러나 여러 리소스에 동일한 키를 사용할 수 있습니다.
  • 키는 소문자나 국제 문자로 시작해야 합니다.

자세한 내용은 Google Cloud 문서를 참고하세요.

create_time

Timestamp

출력 전용입니다. 타임스탬프를 만듭니다.

update_time

Timestamp

출력 전용입니다. 업데이트 타임스탬프.

IndexEndpoint 단계

열거형
STATE_UNSPECIFIED 기본값입니다. 사용해서는 안 됩니다.
CREATING CREATING 상태입니다.
CREATED CREATED 상태입니다.
UPDATING 상태가 UPDATING입니다.
FAILED 상태가 FAILED입니다.

IndexedAsset

IndexedAsset은 색인이 빌드되는 애셋입니다.

필드
index

string

필수 입력란입니다. 색인이 생성된 애셋이 속한 색인입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/indexes/{index}

asset

string

필수 입력란입니다. 저작물의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/assets/{asset_id}

create_time

Timestamp

출력 전용입니다. 생성 타임스탬프입니다.

update_time

Timestamp

출력 전용입니다. 업데이트 타임스탬프입니다.

IndexingStatus

저작물의 색인 생성 상태입니다.

필드
state

State

출력 전용입니다. 이 저작물의 색인 생성 상태입니다.

status_message

string

상태를 설명하는 자세한 메시지입니다.

이 저작물의 색인을 생성하기 위한 상태 enum입니다.

열거형
STATE_UNSPECIFIED 기본 프로세스 상태는 발생해서는 안 됩니다.
IN_PROGRESS 색인 생성이 진행 중입니다.
SUCCEEDED 프로세스가 완료되었습니다.
FAILED 프로세스가 실패했습니다.

IngestAssetRequest

IngestAsset API의 요청 메시지입니다.

필드

통합 필드 streaming_request.

streaming_request는 다음 중 하나여야 합니다.

config

Config

데이터에 대한 정보와 데이터가 속한 애셋 리소스 이름을 제공합니다. 첫 번째 IngestAssetRequest 메시지는 Config 메시지만 포함해야 합니다.

time_indexed_data

TimeIndexedData

처리할 데이터입니다.

구성

데이터 구성

필드
asset

string

필수 입력란입니다. 처리된 데이터가 속한 애셋의 리소스 이름입니다.

통합 필드 data_type.

data_type는 다음 중 하나여야 합니다.

video_type

VideoType

동영상 데이터의 정보를 입력합니다.

VideoType

동영상 데이터의 정보를 입력합니다.

필드
container_format

ContainerFormat

동영상 데이터의 컨테이너 형식입니다.

ContainerFormat

동영상의 컨테이너 형식입니다.

열거형
CONTAINER_FORMAT_UNSPECIFIED 기본 유형이며 사용해서는 안 됩니다.
CONTAINER_FORMAT_MP4 Mp4 컨테이너 형식

TimeIndexedData

데이터와 이 데이터에 해당하는 기간을 포함합니다.

필드
data

bytes

처리할 데이터입니다.

temporal_partition

TemporalPartition

데이터의 기간입니다.

IngestAssetResponse

IngestAsset API의 응답 메시지입니다.

필드
successfully_ingested_partition

TemporalPartition

성공적으로 처리된 데이터의 기간입니다.

인스턴스

인스턴스 객체를 설명하는 메시지

필드
name

string

출력 전용. 리소스의 이름

create_time

Timestamp

출력 전용입니다. [출력 전용] 생성 타임스탬프

update_time

Timestamp

출력 전용입니다. [출력 전용] 업데이트 타임스탬프

labels

map<string, string>

키-값 쌍인 라벨입니다.

display_name

string

필수 입력란입니다. 솔루션의 사용자 친화적인 표시 이름입니다.

description

string

이 인스턴스에 대한 설명입니다.

instance_type

InstanceType

현재 인스턴스의 인스턴스 유형입니다.

input_resources[]

InputResource

현재 애플리케이션 인스턴스의 입력 리소스입니다. 예: input_resources: visionai.googleapis.com/v1/projects/123/locations/us-central1/clusters/456/streams/stream-a

output_resources[]

OutputResource

하나의 애플리케이션 인스턴스와 연결된 모든 출력 리소스입니다.

state

State

인스턴스의 상태입니다.

InputResource

하나의 애플리케이션 인스턴스에 사용되는 입력 리소스의 메시지입니다.

필드
consumer_node

string

입력 리소스를 수신하는 그래프 노드의 이름입니다. 예: input_resource: visionai.googleapis.com/v1/projects/123/locations/us-central1/clusters/456/streams/input-stream-a consumer_node: stream-input

input_resource_binding

string

입력 결합이 1개만 있는 경우 현재 입력 리소스를 사용할 특정 입력 리소스 결합은 무시할 수 있습니다.

annotations

ResourceAnnotations

리소스 주석을 포함합니다.

통합 필드 input_resource_information. 필수 입력란입니다. 애플리케이션 인스턴스에 대한 입력을 지정합니다. input_resource_information은 다음 중 하나여야 합니다.
input_resource

string

직접 입력 리소스 이름입니다. 인스턴스 유형이 STREAMING_PREDICTION인 경우 입력 리소스의 형식은 'projects/123/locations/us-central1/clusters/456/streams/stream-a'입니다. 인스턴스 유형이 Cloud Storage 입력 컨테이너의 BATCH_PREDICTION인 경우 입력 리소스는 'gs://bucket-a' 형식입니다.

annotated_stream
(deprecated)

StreamWithAnnotation

입력 리소스가 VisionAI 스트림인 경우 대신 annotated_stream을 사용하여 연결된 주석을 지정할 수 있습니다.

OutputResource

하나의 애플리케이션 인스턴스에서 사용되는 출력 리소스의 메시지입니다.

필드
output_resource

string

현재 애플리케이션 인스턴스의 출력 리소스 이름입니다.

producer_node

string

출력 리소스 이름을 생성하는 그래프 노드의 이름입니다. 예: output_resource: /projects/123/locations/us-central1/clusters/456/streams/output-application-789-stream-a-occupancy-counting producer_node: occupancy-counting

output_resource_binding

string

현재 OutputResource를 생성하는 특정 출력 리소스 결합입니다.

is_temporary

bool

출력 전용입니다. 출력 리소스가 임시인지 여부입니다. 즉, 리소스가 애플리케이션 배포 중에 생성됩니다. 임시 리소스는 애플리케이션을 배포 해제하는 동안 삭제됩니다.

autogen

bool

출력 전용입니다. 출력 리소스가 Vision AI 앱 플랫폼에서 자동으로 생성되는지 여부입니다.

인스턴스 상태

열거형
STATE_UNSPECIFIED 기본값입니다. 이 값은 상태가 생략된 경우에 사용됩니다.
CREATING CREATING 상태입니다.
CREATED CREATED 상태입니다.
DEPLOYING DEPLOYING(배포 중) 상태입니다.
DEPLOYED DEPLOYED(배포됨) 상태입니다.
UNDEPLOYING UNDEPLOYING 상태입니다.
DELETED DELETED 상태입니다.
ERROR ERROR 상태입니다.
UPDATING 상태 업데이트 중
DELETING 삭제 중 상태입니다.
FIXING 상태 수정

IntRange

정수 범위 유형입니다.

필드
start

int64

int 범위의 시작입니다.

end

int64

int 범위의 끝입니다.

IntRangeArray

정수 범위 값 목록입니다.

필드
int_ranges[]

IntRange

정수 범위 값

ListAnalysesRequest

분석 목록 요청 메시지

필드
parent

string

필수 입력란입니다. ListAnalysesRequest의 상위 값

page_size

int32

요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

결과 필터링

order_by

string

결과 정렬 방법에 대한 힌트

ListAnalysesResponse

분석 나열에 대한 응답 메시지입니다.

필드
analyses[]

Analysis

분석 목록

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListAnnotationsRequest

GetAnnotation API에 대한 요청 메시지입니다.

필드
parent

string

이 주석 컬렉션을 소유한 상위 요소입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}

page_size

int32

반환할 최대 주석 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 주석이 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

이전 ListAnnotations 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListAnnotations에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

filter

string

반환된 목록에 적용된 필터입니다. partition.temporal_partition.start_time, partition.temporal_partition.end_time, key 필드에 대해서만 필터링을 지원합니다. IMAGE 유형의 자료에는 key만 지원됩니다. 타임스탬프는 RFC-3339 형식으로 지정되며 필드당 하나의 제한사항만 연결 문자로 결합하여 적용할 수 있습니다. 형식: "partition.temporal_partition.start_time > "2012-04-21T11:30:00-04:00" AND partition.temporal_partition.end_time < "2012-04-22T11:30:00-04:00" AND key = "example_key""

ListAnnotationsResponse

ListAnnotations API의 요청 메시지입니다.

필드
annotations[]

Annotation

지정된 확장 소재의 주석입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListApplicationsRequest

애플리케이션 목록을 요청하는 메시지입니다.

필드
parent

string

필수 입력란입니다. ListApplicationsRequest의 상위 값입니다.

page_size

int32

요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

필터링 결과입니다.

order_by

string

결과를 정렬하는 방법에 대한 힌트입니다.

ListApplicationsResponse

애플리케이션 나열에 대한 응답 메시지입니다.

필드
applications[]

Application

애플리케이션 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListAssetsRequest

ListAssets 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 이 애셋 컬렉션을 소유한 상위 요소입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}

page_size

int32

반환할 최대 확장 소재 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 확장 소재가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

이전 ListAssets 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListAssets에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

filter

string

반환된 목록에 적용된 필터입니다. 다음 필터링만 지원됩니다. 콘텐츠가 업로드된 확장 소재를 반환하는 'assets_with_contents = true', 콘텐츠가 없는 확장 소재를 반환하는 'assets_with_contents = false'.

ListAssetsResponse

ListAssets의 응답 메시지입니다.

필드
assets[]

Asset

지정된 자료의 애셋입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListCollectionsRequest

ListCollections 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 상위 자료입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}

page_size

int32

반환할 최대 컬렉션 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 컬렉션이 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

이전 ListCollectionsRequest 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListCollectionsRequest에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListCollectionsResponse

ListCollections의 응답 메시지입니다.

필드
collections[]

Collection

지정된 자료의 컬렉션입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListCorporaRequest

ListCorpora 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 자료집을 나열할 프로젝트의 리소스 이름입니다.

page_size

int32

요청한 페이지 크기입니다. API에서 요청한 것보다 적은 결과를 반환할 수 있습니다. 음수인 경우 INVALID_ARGUMENT 오류가 반환됩니다. 지정하지 않거나 0인 경우 API는 기본 크기인 10을 선택합니다. 요청된 페이지 크기가 최대 크기보다 크면 API는 최대 크기인 20을 사용합니다.

page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다. 일반적으로 이전 Warehouse.ListCorpora 호출의 ListCorporaResponse.next_page_token를 통해 가져옵니다.

filter

string

반환된 자료 목록에 적용된 필터입니다. type=<Corpus.Type>, type!=<Corpus.Type> 제한사항만 지원됩니다.

ListCorporaResponse

ListCorpora의 응답 메시지입니다.

필드
corpora[]

Corpus

프로젝트의 코퍼스입니다.

next_page_token

string

결과의 다음 페이지를 검색하는 토큰입니다. ListCorporaRequest.page_token에 전달하여 해당 페이지를 가져옵니다.

ListDataSchemasRequest

ListDataSchemas 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 이 데이터 스키마 컬렉션을 소유한 상위 항목입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}

page_size

int32

반환할 최대 데이터 스키마 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 데이터 스키마가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

이전 ListDataSchemas 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListDataSchemas에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListDataSchemasResponse

ListDataSchemas의 응답 메시지입니다.

필드
data_schemas[]

DataSchema

지정된 자료의 데이터 스키마입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListDraftsRequest

답안 초안 목록을 요청하는 메시지입니다.

필드
parent

string

필수 입력란입니다. ListDraftsRequest의 상위 값입니다.

page_size

int32

요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

필터링 결과입니다.

order_by

string

결과를 정렬하는 방법에 대한 힌트입니다.

ListDraftsResponse

답안 초안을 나열하는 것에 대한 응답 메시지입니다.

필드
drafts[]

Draft

초안 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListIndexEndpointsRequest

ListIndexEndpoints 요청 메시지입니다.

필드
parent

string

필수 항목입니다. 형식: projects/{project}/locations/{location}

page_size

int32

선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 페이지 크기 50이 사용됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

선택사항입니다. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

선택사항입니다. 반환된 목록에 적용된 필터입니다. deployed_image_index.image_index 필드에 대한 필터링만 지원됩니다. 하지만 이미지 색인 대신 자료집으로 필터링하려면 deployed_image_index.corpus를 사용하면 됩니다. 그러면 지정된 자료집 내에 deployed_image_index.image_index가 있는 모든 엔드포인트가 반환됩니다. 이미지 색인의 기본 필터는 다음과 같습니다. deployed_image_index.image_index = "projects/123/locations/us-central1/corpora/my_corpus/imageIndexes/my_image_index" 코퍼스의 기본 필터는 다음과 같습니다. deployed_image_index.corpus = "projects/123/locations/us-central1/corpora/my_corpus"

ListIndexEndpointsResponse

ListIndexEndpoints의 응답 메시지입니다.

필드
index_endpoints[]

IndexEndpoint

IndexEndpoint 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

ListIndexesRequest

등록정보 색인을 요청하는 메시지입니다.

필드
parent

string

필수 입력란입니다. 이 색인 컬렉션을 소유한 상위 코퍼스입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}

page_size

int32

반환할 색인의 최대 개수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 색인이 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

이전 ListIndexes 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListIndexes에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListIndexesResponse

ListIndexes의 응답 메시지입니다.

필드
indexes[]

Index

지정된 코퍼스의 색인입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListInstancesRequest

인스턴스 목록을 요청하기 위한 메시지입니다.

필드
parent

string

필수 입력란입니다. ListInstancesRequest의 상위 값입니다.

page_size

int32

요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

필터링 결과입니다.

order_by

string

결과를 정렬하는 방법에 대한 힌트입니다.

ListInstancesResponse

인스턴스 나열에 대한 응답 메시지입니다.

필드
instances[]

Instance

인스턴스 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListPrebuiltProcessorsRequest

사전 빌드된 프로세서를 나열하기 위한 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 상위 경로

ListPrebuiltProcessorsResponse

사전 빌드된 프로세서를 나열하기 위한 응답 메시지입니다.

필드
processors[]

Processor

프로세서 목록입니다.

ListProcessesRequest

프로세스 목록을 요청하는 메시지입니다.

필드
parent

string

필수 입력란입니다. ListProcessesRequest의 상위 값입니다.

page_size

int32

요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

결과 필터링

order_by

string

결과 정렬 방법에 대한 힌트

ListProcessesResponse

프로세스 나열에 대한 응답 메시지입니다.

필드
processes[]

Process

프로세스 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListProcessorsRequest

프로세서 목록을 요청하는 메시지입니다.

필드
parent

string

필수 입력란입니다. ListProcessorsRequest의 상위 값입니다.

page_size

int32

요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.

page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

filter

string

필터링 결과입니다.

order_by

string

결과를 정렬하는 방법에 대한 힌트입니다.

ListProcessorsResponse

프로세서 나열에 대한 응답 메시지입니다.

필드
processors[]

Processor

프로세서 목록입니다.

next_page_token

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListSearchConfigsRequest

ListSearchConfigs 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 이 검색 구성 컬렉션을 소유한 상위 항목입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}

page_size

int32

반환할 최대 검색 구성 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 페이지 크기 50이 사용됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

이전 ListSearchConfigs 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListSearchConfigs에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListSearchConfigsResponse

ListSearchConfigs의 응답 메시지입니다.

필드
search_configs[]

SearchConfig

지정된 자료의 검색 구성입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListSearchHypernymsRequest

SearchHypernyms 등록정보 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 이 SearchHypernyms 컬렉션을 소유한 상위 요소입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}

page_size

int32

반환된 최대 SearchHypernyms 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 페이지 크기 50이 사용됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

이전 SearchHypernym 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 SearchHypernym에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListSearchHypernymsResponse

SearchHypernyms를 나열하기 위한 응답 메시지입니다.

필드
search_hypernyms[]

SearchHypernym

지정된 자료의 SearchHypernyms입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

MachineSpec

단일 머신의 사양입니다.

필드
machine_type

string

변경할 수 없습니다. 머신 유형입니다.

예측에 지원되는 머신 유형 목록을 참고하세요.

맞춤 학습에 지원되는 머신 유형 목록을 참고하세요.

[DeployedModel][] 의 경우 이 필드는 선택사항이며 기본값은 n1-standard-2입니다. [BatchPredictionJob][] 의 경우 또는 [WorkerPoolSpec][] 의 일부인 경우 이 필드는 필수입니다.

accelerator_type

AcceleratorType

변경할 수 없습니다. accelerator_count에 따라 머신에 연결할 수 있는 가속기 유형입니다.

accelerator_count

int32

머신에 연결할 가속기 수입니다.

MediaWarehouseConfig

MediaWarehouseConfig를 설명하는 메시지

필드
corpus

string

미디어 창고 자료의 리소스 이름입니다. 형식: projects/${project_id}/locations/${location_id}/corpora/${corpus_id}

region
(deprecated)

string

지원 중단되었습니다.

ttl

Duration

모든 미디어 애셋, 연결된 메타데이터, 검색 문서가 존재할 수 있는 기간입니다.

ModelType

Vision AI App Platform에서 지원되는 모든 모델 유형

열거형
MODEL_TYPE_UNSPECIFIED 프로세서 유형 UNSPECIFIED
IMAGE_CLASSIFICATION 모델 유형 이미지 분류
OBJECT_DETECTION 모델 유형 객체 감지
VIDEO_CLASSIFICATION 모델 유형 동영상 분류
VIDEO_OBJECT_TRACKING 모델 유형 객체 추적
VIDEO_ACTION_RECOGNITION 모델 유형: 동작 인식
OCCUPANCY_COUNTING 모델 유형 객실 점유율 집계
PERSON_BLUR 모델 유형: 사람 흐리게 처리
VERTEX_CUSTOM 모델 유형 Vertex Custom

노드

노드 객체를 설명하는 메시지입니다.

필드
name

string

필수 입력란입니다. 노드의 고유한 이름입니다.

display_name

string

노드의 사용자 친화적인 표시 이름입니다.

node_config

ProcessorConfig

노드 구성

processor

string

프로세서 이름은 선택한 프로세서 리소스를 참조합니다.

parents[]

InputEdge

상위 노드 입력 노드에는 상위 노드가 없어야 합니다. V1 알파1/베타의 경우 미디어 창고 노드만 여러 개의 상위 노드를 가질 수 있으며 다른 유형의 노드는 상위 노드가 하나만 있습니다.

통합 필드 stream_output_config.

stream_output_config는 다음 중 하나여야 합니다.

output_all_output_channels_to_stream

bool

기본적으로 노드의 출력은 다운스트림 노드에서만 사용할 수 있습니다. 애플리케이션 노드에서 직접 출력을 사용하려면 먼저 출력을 Vision AI 스트림으로 전송해야 합니다.

output_all_output_channels_to_stream을 true로 설정하면 앱 플랫폼은 현재 노드의 모든 출력을 Vision AI 스트림 리소스 (출력 채널당 하나의 스트림)로 자동 전송합니다. 출력 스트림 리소스는 배포 중에 App Platform에서 자동으로 생성되고 애플리케이션 배포 해제 후에는 삭제됩니다. 이 구성은 모든 애플리케이션 인스턴스에 적용됩니다.

인스턴스 리소스의 output_resources 섹션을 구성하여 인스턴스 수준에서 출력 스트림을 재정의할 수 있습니다. producer_node는 현재 노드여야 하며, output_resource_binding는 출력 채널 이름이어야 합니다 (프로세서의 출력 채널이 1개만 있는 경우 비워 둡니다). output_resource는 대상 출력 스트림이어야 합니다.

InputEdge

노드를 향하는 한 개의 에지를 설명하는 메시지입니다.

필드
parent_node

string

상위 노드의 이름입니다.

parent_output_channel

string

상위 노드의 연결된 출력 아티팩트입니다. 대상 프로세서에 출력 아티팩트가 1개만 있는 경우 생략할 수 있습니다.

connected_input_channel

string

현재 노드 프로세서의 연결된 입력 채널입니다. 대상 프로세서에 입력 채널이 1개만 있는 경우 생략할 수 있습니다.

NormalizedPolygon

정규화된 다각형

필드
normalized_vertices[]

NormalizedVertex

경계 다각형의 정규화된 꼭짓점입니다. 이미지의 왼쪽 상단은 [0, 0]입니다.

NormalizedPolyline

연결된 직선 구간으로 구성된 곡선을 나타내는 정규화된 폴리라인

필드
normalized_vertices[]

NormalizedVertex

직선으로 연결된 일련의 꼭짓점입니다.

NormalizedVertex

꼭짓점은 이미지의 2D 점을 나타냅니다. 참고: 정규화된 꼭짓점 좌표는 원본 이미지를 기준으로 하며 범위는 0에서 1 사이입니다.

필드
x

float

X 좌표입니다.

y

float

Y 좌표이며

ObjectDetectionPredictionResult

일반 객체 감지의 예측 출력 형식입니다.

필드
current_time

Timestamp

현재 타임스탬프입니다.

identified_boxes[]

IdentifiedBox

식별된 상자의 목록입니다.

항목

객체 감지 예측 결과의 주석에 대한 항목 정보입니다.

필드
label_id

int64

라벨 ID입니다.

label_string

string

사람이 읽을 수 있는 라벨 문자열입니다.

IdentifiedBox

식별된 상자에는 위치와 객체의 항목이 포함됩니다.

필드
box_id

int64

이 상자의 고유 ID입니다.

normalized_bounding_box

NormalizedBoundingBox

정규화된 좌표의 경계 상자입니다.

confidence_score

float

이 상자와 연결된 신뢰도 점수입니다.

entity

Entity

이 상자의 항목입니다.

NormalizedBoundingBox

정규화된 좌표의 경계 상자입니다.

필드
xmin

float

x 좌표의 최솟값입니다.

ymin

float

y 좌표의 최솟값입니다.

width

float

경계 상자의 너비입니다.

height

float

경계 상자의 높이입니다.

OccupancyCountConfig

OccupancyCountConfig를 설명하는 메시지입니다.

필드
enable_people_counting

bool

사람의 노출 수를 집계할지 여부와 관계없이 출력 수는 '사람'을 키로 사용합니다.

enable_vehicle_counting

bool

차량의 노출 수를 집계할지 여부와 관계없이 출력 수는 'vehicle'을 키로 갖습니다.

enable_dwelling_time_tracking

bool

장면 또는 특정 영역 내에서 개별 물체의 체류 시간을 추적할지 여부입니다.

OccupancyCountingPredictionResult

객실 점유자 수 집계를 위한 예측 결과 프로토입니다.

필드
current_time

Timestamp

현재 타임스탬프입니다.

identified_boxes[]

IdentifiedBox

식별된 상자의 목록입니다.

stats

Stats

감지 통계

track_info[]

TrackInfo

관련 정보를 추적합니다. 이 타임스탬프에 게시된 모든 트랙입니다. 추적이 사용 설정된 경우에만 존재합니다.

dwell_time_info[]

DwellTimeInfo

머무름 시간 관련 정보 시작 및 종료 시간 타임스탬프가 있는 특정 구역에서 실행 중인 모든 트랙

DwellTimeInfo

인원 집계 운영자의 주석에 대한 체류 시간 정보입니다.

필드
track_id

string

트랙을 식별하는 고유 ID입니다. 프레임 전체에서 일관되어야 합니다.

zone_id

string

객체가 머무르거나 대기 중인 영역의 고유 ID입니다.

dwell_start_time

Timestamp

구역에서 거주 객체가 식별된 시작 시간입니다.

dwell_end_time

Timestamp

거주 객체가 영역을 벗어난 종료 시간입니다.

항목

인원 집계 작업자의 주석에 대한 항목 정보입니다.

필드
label_id

int64

라벨 ID입니다.

label_string

string

사람이 읽을 수 있는 라벨 문자열입니다.

IdentifiedBox

식별된 상자에는 위치와 객체의 항목이 포함됩니다.

필드
box_id

int64

이 상자의 고유 ID입니다.

normalized_bounding_box

NormalizedBoundingBox

정규화된 좌표의 경계 상자입니다.

score

float

이 상자와 연결된 신뢰도 점수입니다.

entity

Entity

이 상자의 항목입니다.

track_id

int64

트랙을 식별하는 고유 ID입니다. 프레임 전체에서 일관되어야 합니다. 추적이 사용 설정된 경우에만 존재합니다.

NormalizedBoundingBox

정규화된 좌표의 경계 상자입니다.

필드
xmin

float

x 좌표의 최솟값입니다.

ymin

float

y 좌표의 최솟값입니다.

width

float

경계 상자의 너비입니다.

height

float

경계 상자의 높이입니다.

통계

인원/차량 수 집계 운영자의 주석에 대한 통계 정보입니다.

필드
full_frame_count[]

ObjectCount

전체 프레임의 개수입니다.

crossing_line_counts[]

CrossingLineCount

교차 선 수

active_zone_counts[]

ActiveZoneCount

활성 영역 수입니다.

AccumulatedObjectCount

인원/차량 수 집계 연산자의 주석에 대한 객체 정보 및 누적 수입니다.

필드
start_time

Timestamp

누적된 수의 시작 시간입니다.

object_count

ObjectCount

누적된 개수의 객체 수입니다.

ActiveZoneCount

활성 영역 수에 관한 메시지입니다.

필드
annotation

StreamAnnotation

사용자의 활성 영역 주석입니다.

counts[]

ObjectCount

구간의 개수입니다.

CrossingLineCount

교차 선 수에 관한 메시지입니다.

필드
annotation

StreamAnnotation

사용자의 선 주석입니다.

positive_direction_counts[]

ObjectCount

오른손잡이 규칙을 따르는 방향입니다.

negative_direction_counts[]

ObjectCount

오른손 법칙과 반대되는 방향입니다.

accumulated_positive_direction_counts[]

AccumulatedObjectCount

누적된 양수 개수입니다.

accumulated_negative_direction_counts[]

AccumulatedObjectCount

누적된 음수 개수입니다.

ObjectCount

인원/차량 수 집계 운영자의 주석에 대한 객체 정보 및 즉시 수입니다.

필드
entity

Entity

이 객체의 항목입니다.

count

int32

객체 수입니다.

TrackInfo

인원 집계 운영자의 주석에 대한 트랙 정보입니다.

필드
track_id

string

트랙을 식별하는 고유 ID입니다. 프레임 전체에서 일관되어야 합니다.

start_time

Timestamp

이 트랙의 시작 타임스탬프입니다.

OperationMetadata

장기 실행 작업의 메타데이터를 나타냅니다.

필드
create_time

Timestamp

출력 전용입니다. 작업이 생성된 시간입니다.

end_time

Timestamp

출력 전용입니다. 작업 실행이 완료된 시간입니다.

target

string

출력 전용입니다. 작업 대상에 대한 서버 정의 리소스 경로입니다.

verb

string

출력 전용입니다. 작업에 의해 실행된 동사의 이름입니다.

status_message

string

출력 전용입니다. 상태에 대한 인간이 읽을 수 있는 상태입니다(존재하는 경우).

requested_cancellation

bool

출력 전용입니다. 사용자가 작업 취소를 요청했는지를 나타냅니다. 성공적으로 취소된 작업은 Code.CANCELLED에 해당하는 google.rpc.Status.code가 1인 [Operation.error][] 값을 갖습니다.

api_version

string

출력 전용입니다. 작업을 시작하는 데 사용되는 API 버전입니다.

파티션

하위 애셋 수준 주석의 시간 및 공간에서 파티션을 지정하는 파티션입니다.

필드
temporal_partition

TemporalPartition

시간에 따른 애셋 파티션

spatial_partition

SpatialPartition

공간에서 애셋의 파티션

relative_temporal_partition

RelativeTemporalPartition

시간에 따른 애셋 파티션

RelativeTemporalPartition

상대 시간으로 애셋 파티션 VIDEO_ON_DEMAND 자료 유형에서 지원됩니다.

필드
start_offset

Duration

파티션의 시작 시간 오프셋입니다.

end_offset

Duration

파티션의 종료 시간 오프셋입니다.

SpatialPartition

공간에서 애셋의 파티션

필드
x_min

int64

최소 x 좌표 값입니다.

y_min

int64

최소 y 좌표 값입니다.

x_max

int64

최대 x 좌표 값입니다.

y_max

int64

최대 y 좌표 값입니다.

TemporalPartition

UTC 에포크 시간으로 표시된 애셋의 파티션입니다. STREAM_VIDEO 자료 유형에서 지원됩니다.

필드
start_time

Timestamp

파티션의 시작 시간입니다.

end_time

Timestamp

파티션의 종료 시간입니다.

PersonBlurConfig

FaceBlurConfig를 설명하는 메시지입니다.

필드
person_blur_type

PersonBlurType

사람 흐리게 처리 유형입니다.

faces_only

bool

프로세서에서 전체 객체 이외의 얼굴만 흐리게 처리할지 여부입니다.

PersonBlurType

사람 흐리게 처리 유형

열거형
PERSON_BLUR_TYPE_UNSPECIFIED 인물 흐리게 처리 유형 UNSPECIFIED
FULL_OCCULUSION FaceBlur 유형 전체 오클루전
BLUR_FILTER FaceBlur 유형 흐리게 처리 필터입니다.

PersonVehicleDetectionConfig

PersonVehicleDetectionConfig를 설명하는 메시지

필드
enable_people_counting

bool

enable_people_counting 및 enable_vehicle_counting 필드 중 하나 이상을 true로 설정해야 합니다. 사람의 노출 수를 집계할지 여부와 관계없이 출력 수는 '사람'을 키로 사용합니다.

enable_vehicle_counting

bool

차량의 노출 수를 집계할지 여부와 관계없이 출력 수는 'vehicle'을 키로 갖습니다.

PersonalProtectiveEquipmentDetectionConfig

PersonalProtectiveEquipmentDetectionConfig를 설명하는 메시지

필드
enable_face_coverage_detection

bool

얼굴 가리개 감지를 사용 설정할지 여부입니다.

enable_head_coverage_detection

bool

머리 가리개 감지를 사용 설정할지 여부입니다.

enable_hands_coverage_detection

bool

손 가리기 감지를 사용 설정할지 여부입니다.

PersonalProtectiveEquipmentDetectionOutput

개인 보호 장비 감지 연산자의 출력 형식입니다.

필드
current_time

Timestamp

현재 타임스탬프입니다.

detected_persons[]

DetectedPerson

DetectedPersons 목록입니다.

DetectedPerson

Detected Person에는 감지된 사람과 관련된 ppe 및 보호 정보가 포함됩니다.

필드
person_id

int64

감지된 사람의 ID입니다.

detected_person_identified_box

PersonIdentifiedBox

감지된 사람 식별 상자의 정보입니다.

detected_ppe_identified_boxes[]

PPEIdentifiedBox

감지된 사람의 정보와 관련된 PPE 식별 상자입니다.

face_coverage_score

float

신체 부위별 노출도 점수입니다. 얼굴의 노출 범위 점수입니다.

eyes_coverage_score

float

눈의 노출 점수입니다.

head_coverage_score

float

헤드의 적용 범위 점수입니다.

hands_coverage_score

float

손의 노출 점수입니다.

body_coverage_score

float

본문의 노출 점수입니다.

feet_coverage_score

float

피트의 노출 점수입니다.

NormalizedBoundingBox

정규화된 좌표의 경계 상자입니다.

필드
xmin

float

x 좌표의 최솟값입니다.

ymin

float

y 좌표의 최솟값입니다.

width

float

경계 상자의 너비입니다.

height

float

경계 상자의 높이입니다.

PPEEntity

PPE 감지 예측 결과의 주석에 대한 항목 정보입니다.

필드
ppe_label_id

int64

라벨 ID입니다.

ppe_label_string

string

사람이 읽을 수 있는 라벨 문자열입니다 (예: 헬멧, 장갑, 마스크).

ppe_supercategory_label_string

string

사람이 읽을 수 있는 슈퍼 카테고리 라벨 문자열입니다 (예: head_cover, hands_cover, face_cover).

ppe_entity_id

int64

항목 ID입니다.

PPEIdentifiedBox

PPEIdentified 상자에는 PPE의 위치와 항목 정보가 포함됩니다.

필드
box_id

int64

이 상자의 고유 ID입니다.

normalized_bounding_box

NormalizedBoundingBox

정규화된 좌표의 경계 상자입니다.

confidence_score

float

이 상자와 연결된 신뢰도 점수입니다.

ppe_entity

PPEEntity

PPE(개인 보호 장비) 항목 정보

PersonEntity

사람 감지 예측 결과의 주석에 대한 항목 정보입니다.

필드
person_entity_id

int64

항목 ID입니다.

PersonIdentifiedBox

PersonIdentified 상자에는 사람의 위치와 항목 정보가 포함됩니다.

필드
box_id

int64

이 상자의 고유 ID입니다.

normalized_bounding_box

NormalizedBoundingBox

정규화된 좌표의 경계 상자입니다.

confidence_score

float

이 상자와 연결된 신뢰도 점수입니다.

person_entity

PersonEntity

사용자 항목 정보입니다.

처리

프로세스 객체를 설명하는 메시지입니다.

필드
name

string

리소스 이름입니다.

create_time

Timestamp

출력 전용입니다. 생성 타임스탬프입니다.

update_time

Timestamp

출력 전용입니다. 업데이트 타임스탬프입니다.

analysis

string

필수 입력란입니다. 기존 분석 리소스에 대한 참조입니다.

attribute_overrides[]

string

선택사항입니다. 분석 도구의 속성 재정의 각 재정의 항목의 형식: "{analyzer_name}:{attribute_key}={value}"

run_status

RunStatus

선택사항입니다. 프로세스 상태입니다.

run_mode

RunMode

선택사항입니다. 프로세스의 실행 모드입니다.

event_id

string

선택사항입니다. 입력/출력 스트림의 이벤트 ID입니다. 이는 분석에 StreamSource/StreamSink 연산자가 있고 읽기/쓰기할 이벤트를 수동으로 지정하려는 경우에 유용합니다.

프로세서

Processor 객체를 설명하는 메시지 다음 ID: 19

필드
name

string

리소스의 이름입니다.

create_time

Timestamp

출력 전용입니다. [출력 전용] 생성 타임스탬프입니다.

update_time

Timestamp

출력 전용입니다. [출력 전용] 업데이트 타임스탬프입니다.

labels

map<string, string>

키-값 쌍인 라벨입니다.

display_name

string

필수 입력란입니다. 프로세서의 사용자 친화적인 표시 이름입니다.

description

string

프로세서의 기능을 설명하는 예시 문장

processor_type

ProcessorType

출력 전용입니다. 프로세서 유형

model_type

ModelType

모델 유형

custom_processor_source_info

CustomProcessorSourceInfo

고객이 만든 프로세서의 소스 정보입니다.

state

ProcessorState

출력 전용입니다. 프로세서의 상태입니다.

processor_io_spec

ProcessorIOSpec

출력 전용입니다. [출력용만 해당] 프로세서의 입력 / 출력 사양입니다. 각 프로세서 유형에는 고객이 변경할 수 없는 고정 입력 / 출력 사양이 있습니다.

configuration_typeurl

string

출력 전용입니다. 애플리케이션에서 해당 구성을 사용하여 프로세서의 동작을 맞춤설정할 수 있습니다.

supported_annotation_types[]

StreamAnnotationType

supports_post_processing

bool

프로세서가 후처리를 지원하는지 여부를 나타냅니다.

ProcessorState

열거형
PROCESSOR_STATE_UNSPECIFIED 지정되지 않은 프로세서 상태입니다.
CREATING 프로세서가 생성되고 있습니다 (아직 사용할 수 없음).
ACTIVE 프로세서가 준비되었으며 사용할 수 있습니다.
DELETING 프로세서가 삭제되고 있습니다 (아직 사용할 수 없음).
FAILED 프로세서가 삭제되었거나 생성에 실패했습니다 .

ProcessorType

유형

열거형
PROCESSOR_TYPE_UNSPECIFIED 프로세서 유형 UNSPECIFIED
PRETRAINED 프로세서 유형 PRETRAINED 사전 학습된 프로세서는 객실 점유자 수 집계나 사람 흐리게 처리와 같은 최신 비전 데이터 처리 기능을 사용하여 Vision AI 앱 플랫폼에서 개발합니다. 사전 학습된 프로세서는 일반적으로 공개적으로 제공됩니다.
CUSTOM 프로세서 유형 CUSTOM. 맞춤 프로세서는 고객이 업로드하거나 다른 Google Cloud 플랫폼 (예: Vertex AI)에서 가져온 특수 프로세서입니다. 맞춤 프로세서는 크리에이터에게만 표시됩니다.
CONNECTOR 프로세서 유형 커넥터 커넥터 프로세서는 애플리케이션의 I/O를 실행하는 특수 프로세서입니다. 데이터를 처리하지는 않지만 데이터를 다른 프로세서로 전송하거나 다른 프로세서로부터 데이터를 수신합니다.

ProcessorConfig

다음 ID: 28

필드

통합 필드 processor_config.

processor_config는 다음 중 하나여야 합니다.

video_stream_input_config

VideoStreamInputConfig

스트림 입력 프로세서의 구성입니다.

ai_enabled_devices_input_config

AIEnabledDevicesInputConfig

AI 지원 입력 기기의 구성입니다.

media_warehouse_config

MediaWarehouseConfig

미디어 창고 프로세서의 구성입니다.

person_blur_config

PersonBlurConfig

사람 흐리게 처리 프로세서의 구성입니다.

occupancy_count_config

OccupancyCountConfig

숙박 인원 수 프로세서의 구성입니다.

person_vehicle_detection_config

PersonVehicleDetectionConfig

사람 차량 감지 프로세서의 구성입니다.

vertex_automl_vision_config

VertexAutoMLVisionConfig

Vertex AutoML Vision 프로세서의 구성입니다.

vertex_automl_video_config

VertexAutoMLVideoConfig

Vertex AutoML 동영상 프로세서의 구성입니다.

vertex_custom_config

VertexCustomConfig

Vertex 맞춤 프로세서의 구성입니다.

general_object_detection_config

GeneralObjectDetectionConfig

일반 객체 감지 프로세서의 구성입니다.

big_query_config

BigQueryConfig

BigQuery 프로세서의 구성입니다.

personal_protective_equipment_detection_config

PersonalProtectiveEquipmentDetectionConfig

personal_protective_equipment_detection_config의 구성

ProcessorIOSpec

프로세서의 입력 / 출력 사양을 설명하는 메시지입니다.

필드
graph_input_channel_specs[]

GraphInputChannelSpec

input_channel_specs가 있는 프로세서의 경우 프로세서가 다른 프로세서에 명시적으로 연결되어야 합니다.

graph_output_channel_specs[]

GraphOutputChannelSpec

현재 프로세서의 출력 아티팩트 사양입니다.

instance_resource_input_binding_specs[]

InstanceResourceInputBindingSpec

애플리케이션 인스턴스에서 제공해야 하는 입력 리소스입니다.

instance_resource_output_binding_specs[]

InstanceResourceOutputBindingSpec

프로세서가 인스턴스당 생성하는 출력 리소스입니다. 여기에 명시적으로 나열된 출력 바인딩 외에도 모든 프로세서의 GraphOutputChannels를 스트림 리소스에 바인딩할 수 있습니다. 그러면 바인드 이름은 GraphOutputChannel의 이름과 동일합니다.

GraphInputChannelSpec

입력 채널 사양 메시지

필드
name

string

현재 입력 채널의 이름입니다.

data_type

DataType

현재 입력 채널의 데이터 유형입니다. 이 필드에 값이 2개 이상 있으면 이 입력 채널을 이러한 서로 다른 데이터 유형 중 하나에 연결할 수 있음을 의미합니다.

accepted_data_type_uris[]

string

지정된 경우 이러한 세부 데이터 유형만 프로세서에 연결할 수 있습니다. 예를 들어 MEDIA의 경우 jpeg 스트림, PROTO 유형의 경우 PredictionResult 프로토가 있습니다. 지정하지 않으면 모든 프로토가 허용됩니다.

required

bool

프로세서에 현재 입력 채널이 필요한지 여부입니다. 예를 들어 필수 동영상 입력과 선택적 오디오 입력이 있는 프로세서의 경우 동영상 입력이 누락되면 애플리케이션이 거부되지만 동영상 입력이 있는 한 오디오 입력은 누락될 수 있습니다.

max_connection_allowed

int64

이 입력 채널에 연결할 수 있는 입력 에지의 수입니다. 0은 무제한을 의미합니다.

GraphOutputChannelSpec

출력 채널 사양 메시지

필드
name

string

현재 출력 채널의 이름입니다.

data_type

DataType

현재 출력 채널의 데이터 유형입니다.

data_type_uri

string

InstanceResourceInputBindingSpec

인스턴스 리소스 채널 사양에 관한 메시지입니다. 외부 리소스는 애플리케이션 그래프에 표현되지 않는 가상 노드입니다. 각 프로세서는 외부 그래프 사양을 표현하므로 고객이 외부 소스 또는 대상을 재정의할 수 있습니다.

필드
name

string

입력 바인딩의 이름으로, 프로세서 내에서 고유합니다.

통합 필드 resource_type.

resource_type는 다음 중 하나여야 합니다.

config_type_uri

string

Googleapis 리소스를 포함하는 구성 프로토입니다. 즉, type.googleapis.com/google.cloud.vision.v1.StreamWithAnnotation

resource_type_uri

string

Googleapis 리소스의 직접 유형 URL입니다(예: type.googleapis.com/google.cloud.vision.v1.Asset).

InstanceResourceOutputBindingSpec

필드
name

string

출력 바인딩의 이름으로, 프로세서 내에서 고유합니다.

resource_type_uri

string

허용되는 출력 리소스의 리소스 유형 URI입니다.

explicit

bool

출력 리소스를 인스턴스에 명시적으로 설정해야 하는지 여부입니다. false인 경우 필요한 경우 프로세서가 자동으로 생성합니다.

RemoveApplicationStreamInputRequest

애플리케이션에서 스트림 입력을 삭제하기 위한 메시지입니다.

필드
name

string

필수 항목입니다. 검색할 애플리케이션의 이름입니다. 형식: 'projects/{project}/locations/{location}/applications/{application}'

target_stream_inputs[]

TargetStreamInput

삭제할 대상 스트림입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

TargetStreamInput

삭제할 대상 streamInput에 관한 메시지입니다.

필드
stream

string

RemoveApplicationStreamInputResponse

이 유형에는 필드가 없습니다.

RemoveApplicationStreamInput 응답 메시지

RemoveCollectionItemRequest

RemoveCollectionItem 요청 메시지입니다.

필드
item

CollectionItem

필수 입력란입니다. 삭제할 항목입니다.

RemoveCollectionItemResponse

RemoveCollectionItem 요청 메시지입니다.

필드
item

CollectionItem

이미 삭제된 항목입니다.

RemoveIndexAssetMetadata

RemoveIndexAsset의 메타데이터입니다.

필드
indexing_status

IndexingStatus

이 저작물의 색인 생성 상태입니다.

start_time

Timestamp

작업의 시작 시간입니다.

update_time

Timestamp

작업의 업데이트 시간입니다.

RemoveIndexAssetRequest

RemoveIndexAsset 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 색인 생성할 저작물의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/assets/{asset_id}

index

string

선택사항입니다. 색인의 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/indexes/{index}

RemoveIndexAssetResponse

이 유형에는 필드가 없습니다.

RemoveIndexAsset의 응답 메시지입니다.

RemoveRetailProductsFromRetailProductSetResponse

작업이 완료된 후 RemoveRetailProductsFromRetailProductSet 응답

ResourceAnnotations

리소스에 대한 일반적인 주석을 설명하는 메시지입니다.

필드
application_annotations[]

StreamAnnotation

전체 애플리케이션에 적용되는 주석입니다.

node_annotations[]

ApplicationNodeAnnotation

애플리케이션의 특정 노드에 적용할 주석입니다. 동일한 유형의 주석이 애플리케이션과 노드 모두에 적용되면 전역 애플리케이션 주석과 함께 노드 주석이 추가됩니다. 예를 들어 전체 애플리케이션에 활성 영역 주석이 하나 있고, 점유 분석 프로세서에 활성 영역 주석이 하나 있는 경우 점유 분석 프로세서에는 활성 영역이 2개 정의됩니다.

RetailBatchAnalyzeResponse

BatchAnalyze의 응답 메시지입니다.

RetailEntity

태그 텍스트에서 구문 또는 숫자일 수 있는 항목입니다. 제품명, 정가, 회원가와 같은 알려진 항목 유형입니다.

필드
type

string

항목 유형입니다(예: '제품명', '정상가', '회원가').

mention_text

string

항목의 텍스트 값입니다(예: '2.99달러'). 항목이 태그에 없으면 이 필드는 비어 있습니다.

confidence

float

항목 예측의 신뢰도입니다.

region

RetailNormalizedBoundingBox

태그 지역 내 항목의 위치 지역입니다.

normalized_text_value

string

개체 유형에 대해 사전 정의된 표준의 정규화된 텍스트 값입니다. 추출된 값을 변환할 수 없는 경우에는 없음

RetailNormalizedBoundingBox

경계 상자 좌표는 이미지의 너비와 높이를 기준으로 합니다. 예를 들어 이미지가 100x200이고 NormalizedBoundingBox가 <xmin = 0.1 xmax = 0.5 ymin = 0.2 ymax = 0.9>이면 경계 상자 좌표는 (10, 40)~ (50, 180)입니다. 경계 상자의 일부가 이미지 외부에 있을 수 있습니다.

필드
x_min

float

왼쪽 상단의 가로 좌표입니다.

x_max

float

오른쪽 하단의 가로 좌표입니다.

y_min

float

왼쪽 상단의 세로 좌표입니다.

y_max

float

오른쪽 하단의 세로 좌표입니다.

RetailObjectDetectionAnnotation

이미지에서 객체 영역과 감지 주석을 설명합니다.

필드
bounding_box

RetailNormalizedBoundingBox

객체 인스턴스의 정규화된 경계 상자입니다.

confidence

float

0.0~1.0 사이의 신뢰도 점수입니다. 값이 클수록 결과에 대한 신뢰도가 높습니다.

RetailOperationMetadata

소매 서비스의 작업 메타데이터입니다.

필드
operation_metadata

OperationMetadata

장기 실행 작업의 공통 메타데이터입니다.

partial_failures[]

Status

출력 전용입니다. 부분적인 실패가 발생했습니다. 예를 들어 읽을 수 없는 단일 이미지 파일입니다. 상태 세부정보 필드에는 표준 Google Cloud 오류 세부정보가 포함됩니다.

operation_metrics

OperationMetrics

출력 전용입니다. 작업에 대한 측정항목입니다.

OperationMetrics

작업에 관한 기록된 측정항목입니다.

필드
counters

map<string, int32>

카운터 이름에서 개수로 매핑

RetailPredictResults

BatchAnalyze의 결과 형식입니다.

필드
image_uri

string

입력의 이미지 URI입니다.

product_recognition_annotations[]

RetailProductRecognitionAnnotation

제품 인식 주석

tag_recognition_annotations[]

RetailTagRecognitionAnnotation

태그 인식 주석

RetailProduct

RetailProduct 리소스를 나타내는 메시지입니다.

필드
name

string

출력 전용입니다. RetailProduct 리소스의 이름입니다.

gtins[]

string

제품의 국제거래단품식별코드 (GTIN)입니다.

normalized_gtins[]

string

출력 전용입니다. 입력 GTIN에서 표준 GTIN-14 형식으로 정규화된 버전입니다.

third_party_ids[]

RetailThirdPartyId

소매업체 또는 제조업체에서 사용하는 서드 파티 식별자입니다.

locale

string

BCP-47 코드(예: en-US, de-DE)로 표시되는 제품 정보의 언어입니다. 제품 라벨과 브랜드의 언어는 언어의 언어와 일치해야 합니다.

brand

string

현지화된 제품 브랜드입니다.

title

string

현지화된 제품 제목입니다.

product_uri

string

제품의 방문 페이지입니다.

resource_state

RetailResourceState

출력 전용입니다. RetailProduct의 상태입니다.

labels

map<string, string>

RetailProducts를 구성하는 사용자 정의 메타데이터가 있는 라벨입니다.

라벨 키와 값은 64자 (유니코드 코드 포인트) 이하여야 하며 소문자, 숫자, 밑줄, 대시만 포함할 수 있습니다. 국제 문자는 허용됩니다.

create_time

Timestamp

출력 전용입니다. 생성 타임스탬프입니다.

update_time

Timestamp

출력 전용입니다. 업데이트 타임스탬프입니다.

RetailProductImageSimilarity

색인 세트의 제품 이미지에 대한 유사성 점수입니다.

필드
visual_similarity_score

float

이 제품 이미지와의 시각적 유사성 점수입니다.

detected_text_similarity_score

float

쿼리 제품 이미지에서 감지된 텍스트와 이 제품 이미지에서 모델이 감지한 텍스트 간의 유사성 점수입니다.

product_title_text_similarity_score

float

쿼리 제품 이미지에서 감지된 텍스트와 이 제품 이미지의 사람이 선별한 제품명 간의 유사성 점수입니다.

similarity_score

float

이 제품 이미지에 대한 최종 결합 유사성 점수입니다.

RetailProductRecognitionAnnotation

이미지에서 제품 영역과 제품 인식 주석을 설명합니다.

필드
product_region

RetailObjectDetectionAnnotation

이 제품 인스턴스에 대한 감지 정보 (경계 상자, 신뢰도 등)입니다.

recognition_results[]

RetailProductRecognitionResult

제품 인식 결과입니다. 신뢰도는 내림차순으로 정렬됩니다.

detected_text

string

이 product_region에서 모델에 의해 감지된 텍스트입니다.

RetailProductRecognitionResult

단일 제품 인식 결과입니다.

필드
product_metadata

RetailProduct

인식된 제품의 메타데이터입니다.

confidence

float

0.0~1.0 사이의 신뢰도 점수입니다. 값이 클수록 결과에 대한 신뢰도가 높습니다.

image_similarity[]

RetailProductImageSimilarity

이 결과의 각 제품 이미지에 대한 유사성 점수 세부정보입니다.

RetailResourceState

리소스의 상태입니다.

열거형
RETAIL_RESOURCE_STATE_UNSPECIFIED 기본값입니다. 사용해서는 안 됩니다.
RETAIL_RESOURCE_STATE_CREATING CREATING 상태입니다.
RETAIL_RESOURCE_STATE_CREATED CREATED 상태입니다.
RETAIL_RESOURCE_STATE_UPDATING 상태가 UPDATING입니다.
RETAIL_RESOURCE_STATE_DELETED DELETED 상태입니다.
RETAIL_RESOURCE_STATE_ERROR ERROR 상태입니다.

RetailTagRecognitionAnnotation

프로토는 이 태그 인스턴스가 차지하는 이미지 영역과 추출된 텍스트 정보를 포함하여 태그의 인식 결과를 설명합니다.

필드
tag_region

RetailObjectDetectionAnnotation

이 태그 인스턴스에 관한 감지 정보 (경계 상자, 신뢰도 등)입니다.

tag_text

string

이 태그 인스턴스의 텍스트입니다.

entities[]

RetailEntity

태그에서 감지된 항목의 목록입니다.

RetailThirdPartyId

소매업체 또는 제조업체에서 사용하는 서드 파티 식별자를 나타냅니다 (예: SKU 또는 MPN)를 입력합니다.

필드
id

string

소매업체 또는 제조업체에서 사용하는 서드 파티 ID (예: SKU 또는 MPN)를 입력합니다.

owner

string

서드 파티 식별자를 '소유'하는 법인(예: 이 제품을 판매하는 제조업체 또는 소매업체)입니다.

RunMode

RunMode는 프로세스를 실행할 모드를 나타냅니다.

열거형
RUN_MODE_UNSPECIFIED 모드가 지정되지 않았습니다.
LIVE 실시간 모드 즉, 실시간 동영상 소스를 처리하기 위해 프로세스가 실행되며 패킷 손실이 발생할 수 있습니다.
SUBMISSION 제출 모드 즉, 패킷이 누락되지 않고 경계가 지정된 동영상 파일을 처리하기 위해 프로세스가 실행됩니다. 완료 상태가 추적됩니다.

RunStatus

프로세스의 상태를 설명하는 메시지입니다.

필드
state

State

프로세스의 상태입니다.

reason

string

상태가 된 이유입니다.

상태는 프로세스의 실행 상태를 나타냅니다.

열거형
STATE_UNSPECIFIED 상태가 지정되지 않았습니다.
INITIALIZING INITIALIZING은 프로세스가 예약되었지만 아직 실제 트래픽을 처리할 준비가 되었다는 의미입니다.
RUNNING RUNNING은 프로세스가 실행 중이고 트래픽을 처리하고 있음을 의미합니다.
COMPLETED COMPLETED는 특히 스트리밍이 아닌 사용 사례에서 프로세스가 처리를 완료했음을 의미합니다.
FAILED FAILED는 프로세스가 처리를 완료하지 못함을 의미합니다.

SchemaKeySortingStrategy

데이터 스키마 키를 기준으로 정렬하는 방법을 지정하는 전략입니다.

필드
options[]

Option

앞의 옵션은 뒤의 옵션보다 우선순위가 높습니다.

옵션

데이터 스키마 키 1개 옵션

필드
data_schema_key

string

정렬하는 데 사용되는 데이터입니다.

sort_decreasing

bool

내림차순으로 정렬할지 아니면 오름차순으로 정렬할지입니다. 기본적으로 결과는 오름차순으로 정렬됩니다.

aggregate_method

AggregateMethod

현재 데이터 스키마 키의 집계 메서드입니다.

AggregateMethod

하나의 결과에 동일한 키를 가진 값이 여러 개 있는 경우 정렬에 사용되는 값을 지정합니다. 기본적으로 결과가 내림차순으로 정렬된 경우 AGGREGATE_METHOD_LARGEST가 사용되고, 결과가 오름차순으로 정렬된 경우 AGGREGATE_METHOD_SMALLEST가 사용됩니다.

열거형
AGGREGATE_METHOD_UNSPECIFIED 지정되지 않은 집계 메서드는 위에서 언급한 대로 덮어쓰기됩니다.
AGGREGATE_METHOD_LARGEST 정렬할 가장 큰 (사전순 또는 숫자) 값을 가져옵니다.
AGGREGATE_METHOD_SMALLEST 정렬할 최소 (사전순 또는 숫자) 값을 가져옵니다.

SearchAssetsRequest

SearchAssets 요청 메시지입니다.

필드
corpus

string

필수 입력란입니다. 검색할 상위 말뭉치입니다. 형식: `projects/{project_id}/locations/{location_id}/corpora/{corpus_id}`

page_size

int32

이 페이지에 반환할 결과의 개수입니다. 0이면 서버에서 적절한 page_size를 결정합니다.

page_token

string

다음 페이지를 가져오는 연속 토큰입니다. 비어 있으면 첫 번째 페이지를 가져오는 중임을 의미합니다.

content_time_ranges

DateTimeRangeArray

일치하는 동영상 콘텐츠가 포함되어야 하는 시간 범위입니다. 범위를 지정하지 않으면 시간 제한이 없습니다. 이 필드는 아래 기준과 동일하게 취급되지만 자주 사용되므로 편의를 위해 별도로 정의됩니다. end_time이 미래인 경우 요청이 수신된 시간으로 제한됩니다.

criteria[]

Criteria

검색 결과에 적용되는 기준입니다.

exclusion_criteria[]

Criteria

검색 결과에서 제외할 기준입니다. fetch_matched_annotations은 무시됩니다.

facet_selections[]

FacetGroup

가장 최근의 측정기준 선택 상태를 저장합니다. 여기에는 사용자가 선택한 측정기준 그룹만 표시됩니다. 선택 상태는 선택 또는 선택 해제 중 하나입니다. 선택한 측정기준 버킷만 검색 기준으로 사용됩니다.

result_annotation_keys[]

string

각 검색 결과와 함께 검색하고 반환할 주석을 지정하는 주석 키 목록입니다. 주석 세분화는 GRANULARITY_ASSET_LEVEL이어야 하며 검색 전략은 NO_SEARCH가 아니어야 합니다.

search_query

string

전 세계 검색어입니다. 사용자가 값이 속한 필드를 지정하지 않고도 저작물을 검색할 수 있습니다.

통합 필드 sort_spec. 정렬 사양 이 필드가 지정되지 않으면 기본적으로 다음과 같이 처리됩니다. - STREAM_VIDEO: 검색 결과가 시작 시간순으로 정렬됩니다. sort_spec은 다음 중 하나여야 합니다.
schema_key_sorting_strategy

SchemaKeySortingStrategy

데이터 스키마 키 아래의 값을 기준으로 정렬합니다.

SearchAssetsResponse

SearchAssets의 응답 메시지입니다.

필드
search_result_items[]

SearchResultItem

반환된 검색 결과입니다.

next_page_token

string

다음 페이지 연속 토큰입니다.

facet_results[]

FacetGroup

사용자가 이미 선택한 상품 속성 값과 업데이트된 상품 속성 검색 결과가 포함된 특정 검색어의 상품 속성 검색 결과입니다.

SearchCapability

검색 기능의 기능 및 메타데이터입니다.

필드
type

Type

사용 설정할 검색 기능입니다.

유형

애셋에 대해 다양한 검색을 실행할 수 있는 기능

열거형
TYPE_UNSPECIFIED 지정되지 않은 검색 기능이며 사용하면 안 됩니다.

SearchCapabilitySetting

검색 기능을 사용 설정하기 위한 설정입니다.

필드
search_capabilities[]

SearchCapability

사용 설정할 검색 기능의 메타데이터입니다.

SearchConfig

SearchConfig는 검색 동작 및 검색 결과에 영향을 미치는 다양한 속성을 저장합니다.

필드
name

string

검색 구성의 리소스 이름입니다. CustomSearchCriteria의 경우 search_config가 검색 연산자 이름입니다. 패싯의 경우 search_config는 패싯 측정기준 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/searchConfigs/{search_config}

facet_property

FacetProperty

FacetDimension 및 관련 사양을 설정합니다.

search_criteria_property

SearchCriteriaProperty

맞춤 SearchCriteria와 하나 이상의 UGA 키 간에 매핑을 만듭니다.

SearchCriteriaProperty

맞춤 검색 기준의 중앙 구성

필드
mapped_fields[]

string

각 mapped_field는 UGA 키에 해당합니다. 이 속성의 작동 방식을 이해하려면 다음 예를 살펴보세요. SearchConfig 테이블에서 사용자가 다음 항목을 추가합니다. search_config { name: "person" search_criteria_property { mapped_fields: "player" mapped_fields: "coach" } }

이제 사용자가 다음과 같은 쿼리를 실행하면 됩니다. criteria { field: "person" text_array { txt_values: "Tom Brady" txt_values: "Bill Belichick" } }

MWH 검색은 (player=Tom Brady || coach=Tom Brady || player=Bill Belichick || coach=Bill Belichick)인 검색 문서를 반환합니다.

SearchHypernym

검색 리소스: SearchHypernym 예를 들어 { hypernym: "vehicle" hyponyms: ["sedan", "truck"] }. 즉, SMART_SEARCH 모드에서 'vehicle'을 검색하면 'sedan' 또는 'truck'이 주석으로 포함된 결과도 반환됩니다.

필드
name

string

SearchHypernym의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/searchHypernyms/{search_hypernym}

hypernym

string

상위 용어입니다.

hyponyms[]

string

상위 용어가 매핑되는 하위 용어입니다.

SearchIndexEndpointRequest

SearchIndexEndpoint 요청 메시지입니다.

필드
index_endpoint

string

필수 입력란입니다. 검색할 색인 엔드포인트입니다. 형식: `projects/{project_id}/locations/{location_id}/indexEndpoints/{index_endpoint_id}'

criteria[]

Criteria

검색 결과에 적용되는 기준입니다.

exclusion_criteria[]

Criteria

검색 결과에서 제외할 기준입니다. fetch_matched_annotations은 무시됩니다.

page_size

int32

요청한 페이지 크기입니다. API에서 요청한 것보다 적은 결과를 반환할 수 있습니다. 음수인 경우 INVALID_ARGUMENT 오류가 반환됩니다. 지정하지 않거나 0인 경우 API는 기본 크기인 10을 선택합니다. 요청된 페이지 크기가 최대 크기보다 크면 API는 최대 크기인 100을 선택합니다.

page_token

string

다음 페이지를 가져오는 연속 토큰입니다. 비어 있으면 첫 번째 페이지를 가져오는 중임을 의미합니다.

통합 필드 query. oneof 전 세계 검색어입니다. query은 다음 중 하나여야 합니다.
image_query

ImageQuery

이미지 전용 검색어입니다.

text_query

string

텍스트 전용 쿼리입니다.

SearchIndexEndpointResponse

SearchIndexEndpoint의 응답 메시지입니다.

필드
search_result_items[]

SearchResultItem

반환된 검색 결과입니다.

next_page_token

string

다음 페이지 연속 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

SearchResultItem

검색 결과에 애셋 이름과 해당 시간 범위가 포함됩니다.

필드
asset

string

저작물의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/assets/{asset_id}

segments[]
(deprecated)

TemporalPartition

일치하는 애셋 세그먼트입니다. 지원 중단됨: 단수형 segment 필드를 사용하세요.

segment

TemporalPartition

일치하는 애셋 세그먼트입니다.

relevance

double

SearchResultItem의 사용자 검색 요청 관련성입니다. 현재 Image Warehouse에서만 사용할 수 있으며 기본적으로 코사인 유사성을 나타냅니다. 향후 검색 요청에서 요청된 '내적' 또는 '주제 관련성'과 같은 다른 측정항목이 될 수 있습니다.

requested_annotations[]

Annotation

검색 요청의 result_annotation_keys로 지정된 검색 결과 주석입니다.

annotation_matching_results[]

AnnotationMatchingResult

이 검색 결과 항목과 연결된 기준 또는 속성 선택 기반 주석 일치 결과입니다. fetch_matched_annotations=true인 criteria 또는 facet_selections의 결과만 포함합니다.

StreamAnnotation

메시지

필드
id

string

주석의 ID입니다. 특정 컨텍스트에서 사용될 때 고유해야 합니다. 예를 들어 Vision AI 애플리케이션의 하나의 입력 스트림에 대한 모든 주석이 여기에 해당합니다.

display_name

string

주석의 사용자 친화적인 이름입니다.

source_stream

string

Vision AI 스트림 리소스 이름입니다.

type

StreamAnnotationType

주석의 실제 유형입니다.

통합 필드 annotation_payload.

annotation_payload는 다음 중 하나여야 합니다.

active_zone

NormalizedPolygon

ACTIVE_ZONE 유형의 주석

crossing_line

NormalizedPolyline

CROSSING_LINE 유형의 주석

StreamAnnotationType

가능한 모든 유형의 스트림 주석을 설명하는 enum입니다.

열거형
STREAM_ANNOTATION_TYPE_UNSPECIFIED UNSPECIFIED 유형을 사용합니다.
STREAM_ANNOTATION_TYPE_ACTIVE_ZONE active_zone 주석은 이미지/동영상 기반 스트림의 콘텐츠 위에 다각형을 정의합니다. 후속 처리는 활성 영역 내의 콘텐츠에만 집중합니다.
STREAM_ANNOTATION_TYPE_CROSSING_LINE crossing_line 주석은 이미지/동영상 기반 Vision AI 스트림의 콘텐츠 위에 다중선 객체를 정의하며, 선에서 발생하는 이벤트가 캡처됩니다. 예를 들어 인원/차량 수 분석 프로세서에서 선을 넘는 사람의 수를 들 수 있습니다.

StreamAnnotations

반복되는 StreamAnnotation의 래퍼입니다.

필드
stream_annotations[]

StreamAnnotation

주석이 여러 개 있습니다.

StreamWithAnnotation

애플리케이션별 주석이 있는 Vision AI 스트림을 설명하는 메시지입니다. 이 메시지 내의 모든 StreamAnnotation 객체는 고유한 ID를 가져야 합니다.

필드
stream

string

Vision AI 스트림 리소스 이름입니다.

application_annotations[]

StreamAnnotation

전체 애플리케이션에 적용되는 주석입니다.

node_annotations[]

NodeAnnotation

애플리케이션의 특정 노드에 적용할 주석입니다. 동일한 유형의 주석이 애플리케이션과 노드 모두에 적용되면 전역 애플리케이션 주석과 함께 노드 주석이 추가됩니다. 예를 들어 전체 애플리케이션에 활성 영역 주석이 하나 있고, 점유 분석 프로세서에 활성 영역 주석이 하나 있는 경우 점유 분석 프로세서에는 활성 영역이 2개 정의됩니다.

NodeAnnotation

애플리케이션 노드에 관한 주석을 설명하는 메시지입니다.

필드
node

string

애플리케이션 그래프의 노드 이름입니다.

annotations[]

StreamAnnotation

노드별 스트림 주석입니다.

StringArray

문자열 유형 값의 목록입니다.

필드
txt_values[]

string

문자열 유형 값

UndeployApplicationRequest

애플리케이션을 배포 해제하기 위한 메시지입니다.

필드
name

string

필수 항목입니다. 검색할 애플리케이션의 이름입니다. 형식: 'projects/{project}/locations/{location}/applications/{application}'

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

UndeployApplicationResponse

UndeployApplication 응답 메시지입니다.

UndeployIndexMetadata

UndeployIndex의 메타데이터 메시지입니다.

필드
operation_metadata

OperationMetadata

장기 실행 작업의 공통 메타데이터입니다.

deployed_index

string

출력 전용입니다. 배포가 취소되는 색인입니다.

UndeployIndexRequest

UndeployIndexEndpoint 요청 메시지입니다.

필드
index_endpoint

string

필수 입력란입니다. 배포 해제가 적용될 IndexEndpoint 리소스의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}

UndeployIndexResponse

이 유형에는 필드가 없습니다.

작업이 완료되면 UndeployIndex 응답

UndeployRetailProductRecognitionIndexResponse

UndeployRetailProductRecognitionIndex 응답 메시지입니다.

UpdateAnalysisRequest

분석 업데이트 메시지

필드
update_mask

FieldMask

필수 입력란입니다. 필드 마스크는 Analysis 리소스에서 업데이트로 덮어쓸 필드를 지정하는 데 사용됩니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 사용자가 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

analysis

Analysis

필수 입력란입니다. 업데이트 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

UpdateAnnotationRequest

UpdateAnnotation API의 요청 메시지입니다.

필드
annotation

Annotation

필수 입력란입니다. 업데이트할 주석입니다. 주석의 name 필드는 업데이트할 주석을 식별하는 데 사용됩니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}/annotations/{annotation}

update_mask

FieldMask

업데이트할 필드 목록입니다.

UpdateApplicationInstancesRequest

ApplicationInstance 업데이트 메시지입니다.

필드
name

string

필수 항목입니다. 검색할 애플리케이션의 이름입니다. 형식: 'projects/{project}/locations/{location}/applications/{application}'

application_instances[]

UpdateApplicationInstance

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

allow_missing

bool

이 값이 true이면 대상 리소스가 존재하지 않는 경우 업데이트 요청에서 리소스를 하나 만듭니다. 이때 field_mask는 무시됩니다.

UpdateApplicationInstance

필드
update_mask

FieldMask

선택사항입니다. 필드 마스크는 답안 리소스에서 업데이트로 덮어쓸 필드를 지정하는 데 사용됩니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 사용자가 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

instance

Instance

필수 입력란입니다. 업데이트 중인 리소스입니다.

instance_id

string

필수 입력란입니다. 인스턴스의 ID입니다.

UpdateApplicationInstancesResponse

UpdateApplicationInstances 응답 메시지입니다.

UpdateApplicationRequest

애플리케이션 업데이트 메시지

필드
update_mask

FieldMask

선택사항입니다. 필드 마스크는 애플리케이션 리소스에서 업데이트로 덮어쓸 필드를 지정하는 데 사용됩니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 사용자가 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

application

Application

필수 입력란입니다. 업데이트 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

UpdateApplicationStreamInputRequest

애플리케이션에 대한 스트림 입력을 업데이트하기 위한 메시지입니다.

필드
name

string

필수 항목입니다. 검색할 애플리케이션의 이름입니다. 형식: 'projects/{project}/locations/{location}/applications/{application}'

application_stream_inputs[]

ApplicationStreamInput

업데이트할 스트림 입력입니다. 스트림 리소스 이름은 각 StreamInput의 키이며 각 애플리케이션 내에서 고유해야 합니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

allow_missing

bool

이 값이 true이면 UpdateApplicationStreamInput은 타겟 스트림이 애플리케이션에 포함되어 있지 않더라도 애플리케이션에 스트림 입력을 삽입합니다.

UpdateApplicationStreamInputResponse

AddApplicationStreamInput 응답 메시지입니다.

UpdateAssetRequest

UpdateAsset 요청 메시지입니다.

필드
asset

Asset

필수 입력란입니다. 업데이트할 저작물입니다.

저작물의 name 필드는 업데이트할 저작물을 식별하는 데 사용됩니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}

update_mask

FieldMask

업데이트할 필드 목록입니다.

UpdateCollectionRequest

UpdateCollectionRequest 요청 메시지입니다.

필드
collection

Collection

필수 입력란입니다. 업데이트할 컬렉션입니다.

컬렉션의 name 필드는 업데이트할 컬렉션을 식별하는 데 사용됩니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/collections/{collection}

update_mask

FieldMask

업데이트할 필드 목록입니다. - update_mask를 설정 해제하거나 update_mask를 단일 '*'로 설정하는 경우에만 업데이트 가능한 모든 필드가 collection에 제공된 값으로 업데이트됩니다. - display_name 값을 빈 문자열로 업데이트하려면 collection에서 빈 문자열로 설정하고 update_mask를 'display_name'으로 설정합니다. collection의 다른 업데이트 가능한 문자열 필드에도 동일하게 적용됩니다.

UpdateCorpusRequest

UpdateCorpus 요청 메시지입니다.

필드
corpus

Corpus

필수 입력란입니다. 서버의 리소스를 대체하는 자료입니다.

update_mask

FieldMask

업데이트할 필드 목록입니다.

UpdateDataSchemaRequest

UpdateDataSchema 요청 메시지입니다.

필드
data_schema

DataSchema

필수 입력란입니다. 데이터 스키마의 name 필드는 업데이트할 데이터 스키마를 식별하는 데 사용됩니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/dataSchemas/{data_schema}

update_mask

FieldMask

업데이트할 필드 목록입니다.

UpdateDraftRequest

답안 초안을 업데이트하라는 메시지입니다.

필드
update_mask

FieldMask

선택사항입니다. 필드 마스크는 답안 리소스에서 업데이트로 덮어쓸 필드를 지정하는 데 사용됩니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 사용자가 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

draft

Draft

필수 입력란입니다. 업데이트 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

allow_missing

bool

이 필드가 true이면 UpdateDraftRequest가 대상 리소스가 없는 경우 리소스를 하나 만듭니다. 이때 field_mask는 무시됩니다.

UpdateIndexEndpointMetadata

UpdateIndexEndpoint의 메타데이터 메시지입니다.

필드
operation_metadata

OperationMetadata

장기 실행 작업의 공통 메타데이터입니다.

UpdateIndexEndpointRequest

UpdateIndexEndpoint 요청 메시지입니다.

필드
index_endpoint

IndexEndpoint

필수 입력란입니다. 업데이트 중인 리소스입니다.

update_mask

FieldMask

필수 입력란입니다. 필드 마스크는 IndexEndpoint 리소스에서 업데이트로 덮어쓸 필드를 지정하는 데 사용됩니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 리소스의 필드가 덮어쓰기됩니다. 빈 필드 마스크는 허용되지 않습니다. 마스크가 '*'인 경우 리소스가 완전히 대체됩니다.

UpdateIndexMetadata

UpdateIndexRequest의 메타데이터 메시지

필드
operation_metadata

OperationMetadata

장기 실행 작업의 공통 메타데이터입니다.

UpdateIndexRequest

UpdateIndex 요청 메시지입니다.

필드
index

Index

필수 입력란입니다. 업데이트 중인 리소스입니다.

update_mask

FieldMask

필수 입력란입니다. 필드 마스크는 색인 리소스에서 업데이트로 덮어쓸 필드를 지정하는 데 사용됩니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 리소스의 필드가 덮어쓰기됩니다. 빈 필드 마스크는 허용되지 않습니다. 마스크가 '*'인 경우 색인의 전체 업데이트와 색인 데이터의 전체 재빌드가 트리거됩니다.

UpdateProcessRequest

프로세스 업데이트 메시지

필드
update_mask

FieldMask

필수 입력란입니다. 필드 마스크는 업데이트로 Process 리소스에서 덮어쓸 필드를 지정하는 데 사용됩니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 사용자가 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

process

Process

필수 입력란입니다. 업데이트 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

UpdateProcessorRequest

프로세서 업데이트 메시지

필드
update_mask

FieldMask

선택사항입니다. 필드 마스크는 업데이트로 프로세서 리소스에서 덮어쓸 필드를 지정하는 데 사용됩니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 사용자가 마스크를 제공하지 않으면 모든 필드를 덮어씁니다.

processor

Processor

필수 입력란입니다. 업데이트 중인 리소스입니다.

request_id

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

UpdateSearchConfigRequest

UpdateSearchConfig 요청 메시지입니다.

필드
search_config

SearchConfig

필수 입력란입니다. 업데이트할 검색 구성입니다.

검색 구성의 name 필드는 업데이트할 리소스를 식별하는 데 사용됩니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/searchConfigs/{search_config}

update_mask

FieldMask

업데이트할 필드 목록입니다. 설정하지 않으면 모든 필드 경로가 업데이트/덮어쓰기됩니다.

UpdateSearchHypernymRequest

SearchHypernym 업데이트 요청 메시지입니다.

필드
search_hypernym

SearchHypernym

필수 입력란입니다. 업데이트할 SearchHypernym입니다. 검색 상위어의 name 필드는 업데이트할 검색 상위어를 식별하는 데 사용됩니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/searchHypernyms/{search_hypernym}

update_mask

FieldMask

업데이트할 필드 목록입니다. 설정하지 않으면 모든 필드 경로가 업데이트/덮어쓰기됩니다.

UploadAssetMetadata

UploadAsset의 메타데이터입니다.

필드
start_time

Timestamp

작업의 시작 시간입니다.

update_time

Timestamp

작업의 업데이트 시간입니다.

UploadAssetRequest

UploadAsset 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 업로드할 저작물의 리소스 이름입니다. 형식: projects/{project_number}/locations/{location_id}/corpora/{corpus_id}/assets/{asset_id}

asset_source

AssetSource

저작물의 소스입니다.

UploadAssetResponse

이 유형에는 필드가 없습니다.

UploadAsset의 응답 메시지입니다.

UserSpecifiedAnnotation

사용자가 제공한 주석입니다.

필드
key

string

필수 입력란입니다. 주석의 키입니다. 키는 CreateDataSchema에 의해 유형으로 설정되어야 합니다.

value

AnnotationValue

주석의 값입니다. 값은 데이터 스키마에 따라 유형으로 변환할 수 있어야 합니다.

partition

Partition

하위 애셋 수준 주석의 시간 및 공간에서 파티션 정보입니다.

VertexAutoMLVideoConfig

VertexAutoMLVideoConfig를 설명하는 메시지입니다.

필드
confidence_threshold

float

기준점보다 점수가 높은 항목만 반환됩니다. 값이 0.0이면 감지된 모든 항목을 반환합니다.

blocked_labels[]

string

이 필드에 지정된 라벨은 반환되지 않습니다.

max_predictions

int32

출력 프레임당 최대 이 수만큼의 예측이 반환됩니다. 값 0은 감지된 모든 항목을 반환하는 것을 의미합니다.

bounding_box_size_limit

float

크기가 이 한도보다 큰 경계 상자만 반환됩니다. 객체 추적만 해당 값 0.0은 감지된 모든 항목을 반환함을 의미합니다.

VertexAutoMLVisionConfig

Vertex AutoML Vision 프로세서의 구성 메시지입니다.

필드
confidence_threshold

float

기준점보다 점수가 높은 항목만 반환됩니다. 값 0.0은 감지된 모든 항목을 반환함을 의미합니다.

max_predictions

int32

출력 프레임당 최대 이 수만큼의 예측이 반환됩니다. 값 0은 감지된 모든 항목을 반환하는 것을 의미합니다.

VertexCustomConfig

VertexCustomConfig를 설명하는 메시지

필드
max_prediction_fps

int32

초당 최대 예측 프레임 수입니다. 이 속성은 연산자가 Vertex AI 엔드포인트에 예측 요청을 전송하는 속도를 설정합니다. 기본값은 0입니다. 즉, 최대 예측 FPS 한도가 없습니다. 운영자는 입력 fps로 예측 요청을 전송합니다.

dedicated_resources

DedicatedResources

DeployedModel 전용이며 더 높은 수준의 수동 구성이 필요한 리소스에 대한 설명입니다.

post_processing_cloud_function

string

이 필드가 비어 있지 않으면 예측 결과가 후처리를 위해 지정된 클라우드 함수로 전송됩니다. * Cloud 함수는 AppPlatformCloudFunctionRequest를 수신하며 여기서 주석 필드는 proto PredictResponse의 JSON 형식입니다. * Cloud 함수는 주석 필드에 저장된 PredictResponse가 포함된 AppPlatformCloudFunctionResponse를 반환해야 합니다. * 예측 출력을 삭제하려면 반환된 AppPlatformCloudFunctionResponse에서 페이로드 필드를 지우면 됩니다.

attach_application_metadata

bool

이 값이 true이면 맞춤 모델에서 수신한 예측 요청에 다음 스키마의 메타데이터도 포함됩니다. 'appPlatformMetadata': { 'ingestionTime': DOUBLE; (UNIX 타임스탬프) 'application': STRING; 'instanceId': STRING; 'node': STRING; 'processor': STRING; }

VideoActionRecognitionPredictionResult

동영상 동작 인식의 예측 출력 형식입니다.

필드
segment_start_time

Timestamp

작업이 식별된 동영상 시간 세그먼트의 시작 시간입니다(양 끝값 포함).

segment_end_time

Timestamp

동작이 식별된 동영상 시간 세그먼트의 종료 시간입니다(종료 시간 포함). 특히 시작 시간이 종료 시간과 동일하면 특정 동영상 프레임에서 식별이 이루어짐을 의미합니다.

actions[]

IdentifiedAction

기간에 식별된 모든 작업입니다.

IdentifiedAction

각 IdentifiedAction은 AnnotationSpec ID, display_name, 관련 신뢰도 점수로 지정된 작업의 하나의 특정 식별입니다.

필드
id

string

식별된 AnnotationSpec의 리소스 ID입니다.

display_name

string

식별된 AnnotationSpec의 표시 이름입니다.

confidence

float

이 식별의 수정과 관련된 모델의 신뢰도입니다. 값이 클수록 신뢰도가 높습니다.

VideoClassificationPredictionResult

동영상 분류의 예측 출력 형식입니다.

필드
segment_start_time

Timestamp

분류가 식별된 동영상 시간 세그먼트의 시작(양 끝값 포함)입니다.

segment_end_time

Timestamp

분류가 식별된 동영상 시간 세그먼트의 종료 시간입니다(종료 시간 포함). 특히 시작 시간이 종료 시간과 동일하면 특정 동영상 프레임에서 식별이 이루어짐을 의미합니다.

classifications[]

IdentifiedClassification

기간에 식별된 모든 분류입니다.

IdentifiedClassification

각 IdentifiedClassification은 AnnotationSpec ID 및 display_name으로 지정된 분류의 특정 식별과 관련 신뢰도 점수입니다.

필드
id

string

식별된 AnnotationSpec의 리소스 ID입니다.

display_name

string

식별된 AnnotationSpec의 표시 이름입니다.

confidence

float

이 식별의 수정과 관련된 모델의 신뢰도입니다. 값이 클수록 신뢰도가 높습니다.

VideoObjectTrackingPredictionResult

동영상 객체 추적의 예측 출력 형식입니다.

필드
segment_start_time

Timestamp

현재 식별이 발생하는 동영상 시간 세그먼트의 시작(해당 값 포함)입니다.

segment_end_time

Timestamp

현재 식별이 발생한 동영상 시간 세그먼트의 종료 시간입니다(종료 시간 포함). 특히 시작 시간이 종료 시간과 동일하면 특정 동영상 프레임에서 식별이 발생했음을 의미합니다.

objects[]

DetectedObject

지정된 기간에 감지된 모든 객체입니다.

BoundingBox

감지된 객체의 경계 상자입니다. 즉, 동영상 프레임 위에 있는 직사각형으로, 발견된 AnnotationSpec을 정확하게 나타냅니다. 좌표는 프레임 크기를 기준으로 하며 0,0 지점은 프레임의 왼쪽 상단에 있습니다.

필드
x_min

float

경계 상자의 맨 왼쪽 좌표입니다.

x_max

float

경계 상자의 가장 오른쪽 좌표입니다.

y_min

float

경계 상자의 최상위 좌표입니다.

y_max

float

경계 상자의 가장 아래 좌표입니다.

DetectedObject

각 DetectedObject는 AnnotationSpec ID 및 display_name, 경계 상자, 연결된 신뢰도 점수, 해당 track_id로 지정된 객체의 하나의 특정 식별입니다.

필드
id

string

식별된 AnnotationSpec의 리소스 ID입니다.

display_name

string

식별된 AnnotationSpec의 표시 이름입니다.

bounding_box

BoundingBox

Boundingbox

confidence

float

이 식별의 수정과 관련된 모델의 신뢰도입니다. 값이 클수록 신뢰도가 높습니다.

track_id

int64

일반적으로 인접한 여러 프레임에서 동일한 객체가 식별될 수 있습니다. 특정 객체가 감지된 프레임 세트는 트랙을 형성합니다. 이 track_id를 사용하여 감지된 객체의 모든 프레임을 추적할 수 있습니다.

VideoStreamInputConfig

동영상 스트림 입력 구성을 설명하는 메시지입니다. 이 메시지는 builtin:stream-input 프로세서의 자리표시자로만 사용해야 하며 실제 스트림 바인딩은 상응하는 API를 사용하여 지정해야 합니다.

필드
streams[]
(deprecated)

string

streams_with_annotation[]
(deprecated)

StreamWithAnnotation

ViewCollectionItemsRequest

ViewCollectionItems 요청 메시지입니다.

필드
collection

string

필수 입력란입니다. 볼 컬렉션입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/collections/{collection}

page_size

int32

반환할 최대 컬렉션 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 컬렉션이 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

이전 ViewCollectionItemsRequest 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ViewCollectionItemsRequest에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ViewCollectionItemsResponse

ViewCollectionItems의 응답 메시지입니다.

필드
items[]

CollectionItem

지정된 컬렉션의 항목입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ViewIndexedAssetsRequest

ViewIndexedAssets 요청 메시지입니다.

필드
index

string

필수 입력란입니다. 이 확장 소재 컬렉션을 소유한 색인입니다. 형식: projects/{project_number}/locations/{location}/corpora/{corpus}/indexes/{index}

page_size

int32

반환할 최대 확장 소재 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 확장 소재가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

이전 ViewIndexedAssets 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ViewIndexedAssets에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

filter

string

반환된 목록에 적용된 필터입니다. 지정된 ID가 있는 확장 소재를 반환하는 'asset_id = xxxx'와 같은 필터링만 지원됩니다. 'asset_id = xxxx, yyyy, zzzz': 지정된 ID가 있는 애셋을 반환합니다.

ViewIndexedAssetsResponse

ViewIndexedAssets의 응답 메시지입니다.

필드
indexed_assets[]

IndexedAsset

지정된 색인의 애셋입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

WatchEventsRequest

WatchEventsRequest에는 관찰자 식별 정보와 관찰자가 관심을 갖는 이벤트의 필터가 포함됩니다.

필드
cluster

string

리소스의 상위 요소입니다.

watcher_id

string

고유 ID는 스트림 시청자를 식별합니다.

streams[]

string

시청할 스트림의 이름 또는 스트림 세트입니다.

event_update_filter

EventUpdateFilter

관찰자가 수신할 이벤트 업데이트를 지정할 수 있는 필터입니다.

heartbeat_interval_second

float

HeartbeatIntervalSecond는 gRPC 스트리밍 서버에서 반환된 하트비트 응답의 간격 (초)을 정의합니다. 기본값 0은 하트비트가 반환되지 않음을 의미합니다.

WatchEventsResponse

각 응답 메시지에는 이벤트 업데이트가 하나 포함됩니다.

필드
update_type

EventUpdateType

이벤트 업데이트 유형입니다.

stream

string

이벤트가 연결된 스트림의 이름입니다.

event

string

이벤트 이름입니다.

series

string

시리즈의 이름입니다.

update_time

Timestamp

이벤트 업데이트가 발생한 시점의 타임스탬프입니다.