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 列出与请求中指定的过滤条件匹配的操作。 |