Vector Search API

Vector Search API 提供全托管式、高性能且可伸缩的向量数据库,旨在为新一代搜索、推荐和生成式 AI 应用提供支持。借助它,您可以通过简单直观的界面存储、索引和查询数据及其对应的向量嵌入。借助 Vector Search,您可以为数据定义自定义架构、插入具有关联元数据的对象、自动从数据生成嵌入,并执行快速的近似最近邻 (ANN) 搜索,以大规模查找语义上相似的项。

服务:vectorsearch.googleapis.com

如要调用此服务,我们建议您使用 Google 提供的客户端库。如果您的应用需要使用您自己的库来调用此服务,则在发出 API 请求时应使用以下信息。

发现文档

发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档:

服务端点

服务端点是指定 API 服务的网络地址的基本网址。一项服务可能有多个服务端点。此服务具有以下服务端点,下面的所有 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
启动长时间运行的操作,以从集合中导出 DataObject。
get GET /v1/{name}
获取单个集合的详细信息。
importDataObjects POST /v1/{name}:importDataObjects
启动长时间运行的操作,以将 DataObject 导入到集合中。
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
批量更新 dataObject。
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
列出给定项目和位置中的索引。

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
启动长时间运行的操作,以从集合中导出 DataObject。
get GET /v1beta/{name}
获取单个集合的详细信息。
importDataObjects POST /v1beta/{name}:importDataObjects
启动长时间运行的操作,以将 DataObject 导入到集合中。
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
批量删除 dataObject。
batchSearch POST /v1beta/{parent}/dataObjects:batchSearch
批量搜索数据对象。
batchUpdate POST /v1beta/{parent}/dataObjects:batchUpdate
批量更新 dataObject。
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
列出给定项目和位置中的索引。

REST 资源:v1beta.projects.locations.operations

方法
cancel POST /v1beta/{name}:cancel
对长时间运行的操作启动异步取消。
delete DELETE /v1beta/{name}
删除长时间运行的操作。
get GET /v1beta/{name}
获取长时间运行的操作的最新状态。
list GET /v1beta/{name}/operations
列出与请求中指定的过滤条件匹配的操作。