Vector Search API

Vector Search API는 차세대 벡터 검색, 추천, 생성형 AI 애플리케이션을 지원하도록 설계된 완전 관리형의 고성능 확장형 벡터 데이터베이스를 제공합니다. 간단하고 직관적인 인터페이스를 통해 데이터와 해당 벡터 임베딩을 저장, 색인 생성, 쿼리할 수 있습니다. 벡터 검색을 사용하면 데이터의 커스텀 스키마를 정의하고, 연결된 메타데이터가 있는 객체를 삽입하고, 데이터에서 임베딩을 자동으로 생성하고, 빠른 근사 최근접 이웃 (ANN) 검색을 수행하여 의미상 유사한 항목을 대규모로 찾을 수 있습니다.

서비스: vectorsearch.googleapis.com

이 서비스를 호출하려면 Google에서 제공하는 클라이언트 라이브러리를 사용하는 것이 좋습니다. 애플리케이션에서 자체 라이브러리를 사용하여 이 서비스를 호출해야 한다면 API 요청을 실행할 때 다음 정보를 사용해야 합니다.

탐색 문서

탐색 문서는 기계 가독형 사양이며 REST API를 설명하고 사용하는 데 참고할 수 있습니다. 또한 클라이언트 라이브러리, IDE 플러그인, 기타 Google API와 상호작용하는 도구를 빌드하는 데 사용됩니다. 하나의 서비스는 여러 개의 탐색 문서를 제공할 수 있습니다. 이 서비스는 다음 탐색 문서를 제공합니다.

서비스 엔드포인트

서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기준 URL입니다. 하나의 서비스는 여러 서비스 엔드포인트를 포함할 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.

  • https://vectorsearch.googleapis.com

REST 리소스: v1.projects.locations

메서드
get GET /v1/{name}
위치 정보를 가져옵니다.
list GET /v1/{name}/locations
이 서비스에 지원되는 위치 정보를 나열합니다.

REST 리소스: v1.projects.locations.collections

메서드
create POST /v1/{parent}/collections
특정 프로젝트와 위치에 새 컬렉션을 만듭니다.
delete DELETE /v1/{name}
단일 컬렉션을 삭제합니다.
exportDataObjects POST /v1/{name}:exportDataObjects
컬렉션에서 DataObjects를 내보내는 장기 실행 작업을 시작합니다.
get GET /v1/{name}
단일 컬렉션의 세부정보를 가져옵니다.
importDataObjects POST /v1/{name}:importDataObjects
DataObjects를 컬렉션으로 가져오는 장기 실행 작업을 시작합니다.
list GET /v1/{parent}/collections
특정 프로젝트와 위치의 컬렉션을 나열합니다.
patch PATCH /v1/{collection.name}
단일 컬렉션의 파라미터를 업데이트합니다.

REST 리소스: v1.projects.locations.collections.dataObjects

메서드
aggregate POST /v1/{parent}/dataObjects:aggregate
데이터 객체를 집계합니다.
batchCreate POST /v1/{parent}/dataObjects:batchCreate
dataObject 배치를 만듭니다.
batchDelete POST /v1/{parent}/dataObjects:batchDelete
dataObject를 일괄 삭제합니다.
batchSearch POST /v1/{parent}/dataObjects:batchSearch
데이터 객체를 일괄 검색합니다.
batchUpdate POST /v1/{parent}/dataObjects:batchUpdate
dataObjects를 일괄 업데이트합니다.
create POST /v1/{parent}/dataObjects
dataObject를 만듭니다.
delete DELETE /v1/{name}
dataObject를 삭제합니다.
get GET /v1/{name}
데이터 객체를 가져옵니다.
patch PATCH /v1/{dataObject.name}
dataObject를 업데이트합니다.
query POST /v1/{parent}/dataObjects:query
데이터 객체를 쿼리합니다.
search POST /v1/{parent}/dataObjects:search
데이터 객체를 검색합니다.

REST 리소스: v1.projects.locations.collections.indexes

메서드
create POST /v1/{parent}/indexes
특정 프로젝트와 위치에 새 색인을 만듭니다.
delete DELETE /v1/{name}
단일 색인을 삭제합니다.
get GET /v1/{name}
단일 색인의 세부정보를 가져옵니다.
list GET /v1/{parent}/indexes
특정 프로젝트 및 위치의 색인을 나열합니다.
patch PATCH /v1/{index.name}
단일 색인의 파라미터를 업데이트합니다.

REST 리소스: v1.projects.locations.operations

메서드
cancel POST /v1/{name}:cancel
장기 실행 작업에 대한 비동기 취소를 시작합니다.
delete DELETE /v1/{name}
장기 실행 작업을 삭제합니다.
get GET /v1/{name}
장기 실행 작업의 최신 상태를 가져옵니다.
list GET /v1/{name}/operations
요청에 지정된 필터와 일치하는 작업을 나열합니다.

REST 리소스: v1beta.projects.locations

메서드
get GET /v1beta/{name}
위치 정보를 가져옵니다.
list GET /v1beta/{name}/locations
이 서비스에 지원되는 위치 정보를 나열합니다.

REST 리소스: v1beta.projects.locations.collections

메서드
create POST /v1beta/{parent}/collections
특정 프로젝트와 위치에 새 컬렉션을 만듭니다.
delete DELETE /v1beta/{name}
단일 컬렉션을 삭제합니다.
exportDataObjects POST /v1beta/{name}:exportDataObjects
컬렉션에서 DataObjects를 내보내는 장기 실행 작업을 시작합니다.
get GET /v1beta/{name}
단일 컬렉션의 세부정보를 가져옵니다.
importDataObjects POST /v1beta/{name}:importDataObjects
DataObjects를 컬렉션으로 가져오는 장기 실행 작업을 시작합니다.
list GET /v1beta/{parent}/collections
특정 프로젝트와 위치의 컬렉션을 나열합니다.
patch PATCH /v1beta/{collection.name}
단일 컬렉션의 파라미터를 업데이트합니다.

REST 리소스: v1beta.projects.locations.collections.dataObjects

메서드
aggregate POST /v1beta/{parent}/dataObjects:aggregate
데이터 객체를 집계합니다.
batchCreate POST /v1beta/{parent}/dataObjects:batchCreate
dataObject 배치를 만듭니다.
batchDelete POST /v1beta/{parent}/dataObjects:batchDelete
dataObjects를 일괄 삭제합니다.
batchSearch POST /v1beta/{parent}/dataObjects:batchSearch
데이터 객체를 일괄 검색합니다.
batchUpdate POST /v1beta/{parent}/dataObjects:batchUpdate
dataObjects를 일괄 업데이트합니다.
create POST /v1beta/{parent}/dataObjects
dataObject를 만듭니다.
delete DELETE /v1beta/{name}
dataObject를 삭제합니다.
get GET /v1beta/{name}
데이터 객체를 가져옵니다.
patch PATCH /v1beta/{dataObject.name}
dataObject를 업데이트합니다.
query POST /v1beta/{parent}/dataObjects:query
데이터 객체를 쿼리합니다.
search POST /v1beta/{parent}/dataObjects:search
데이터 객체를 검색합니다.

REST 리소스: v1beta.projects.locations.collections.indexes

메서드
create POST /v1beta/{parent}/indexes
특정 프로젝트와 위치에 새 색인을 만듭니다.
delete DELETE /v1beta/{name}
단일 색인을 삭제합니다.
get GET /v1beta/{name}
단일 색인의 세부정보를 가져옵니다.
list GET /v1beta/{parent}/indexes
특정 프로젝트 및 위치의 색인을 나열합니다.
patch PATCH /v1beta/{index.name}
단일 색인의 파라미터를 업데이트합니다.

REST 리소스: v1beta.projects.locations.dataStores

메서드
create POST /v1beta/{parent}/dataStores
특정 프로젝트와 위치에 새 데이터 스토어를 만듭니다.
delete DELETE /v1beta/{name}
단일 DataStore를 삭제합니다.
get GET /v1beta/{name}
단일 데이터 스토어의 세부정보를 가져옵니다.
importDocuments POST /v1beta/{name}:importDocuments
장기 실행 작업을 시작하여 문서를 DataStore로 가져옵니다.
list GET /v1beta/{parent}/dataStores
특정 프로젝트와 위치의 데이터 스토어를 나열합니다.
patch PATCH /v1beta/{dataStore.name}
단일 DataStore의 파라미터를 업데이트합니다.
purgeDocuments POST /v1beta/{name}:purgeDocuments
장기 실행 작업을 시작하여 DataStore에서 문서를 영구 삭제합니다.

REST 리소스: v1beta.projects.locations.dataStores.documents

메서드
get GET /v1beta/{name}
문서를 가져옵니다.
list GET /v1beta/{parent}/documents
DataStore의 문서를 나열합니다.
search POST /v1beta/{parent}/documents:search
단일 DataStore의 문서를 검색합니다.

REST 리소스: v1beta.projects.locations.operations

메서드
cancel POST /v1beta/{name}:cancel
장기 실행 작업에 대한 비동기 취소를 시작합니다.
delete DELETE /v1beta/{name}
장기 실행 작업을 삭제합니다.
get GET /v1beta/{name}
장기 실행 작업의 최신 상태를 가져옵니다.
list GET /v1beta/{name}/operations
요청에 지정된 필터와 일치하는 작업을 나열합니다.