Method: projects.locations.collections.dataObjects.batchSearch

Realiza búsquedas por lotes de objetos de datos.

Solicitud HTTP

POST https://vectorsearch.googleapis.com/v1/{parent}/dataObjects:batchSearch

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el nombre del recurso de la colección en la que se realizará la búsqueda. Formato: projects/{project}/locations/{location}/collections/{collection}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "searches": [
    {
      object (Search)
    }
  ],
  "combine": {
    object (CombineResultsOptions)
  }
}
Campos
searches[]

object (Search)

Obligatorio. Es una lista de solicitudes de búsqueda que se ejecutarán en paralelo.
combine

object (CombineResultsOptions)

Es opcional. Son las opciones para combinar los resultados de las operaciones de búsqueda por lotes.

Cuerpo de la respuesta

Es una respuesta de una operación de búsqueda por lotes.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "results": [
    {
      object (SearchDataObjectsResponse)
    }
  ]
}
Campos
results[]

object (SearchDataObjectsResponse)

Solo salida. Es una lista de respuestas de búsqueda, una por cada solicitud en el lote. Si se usa un clasificador, se muestra una sola lista clasificada de resultados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • vectorsearch.dataObjects.search

Para obtener más información, consulta la documentación de IAM.

CombineResultsOptions

Son las opciones para combinar los resultados de las operaciones de búsqueda por lotes.

Representación JSON 
{
  "ranker": {
    object (Ranker)
  },
  "outputFields": {
    object (OutputFields)
  },
  "topK": integer
}
Campos
ranker

object (Ranker)

Obligatorio. Es el clasificador que se usará para combinar los resultados.
outputFields

object (OutputFields)

Es opcional. Máscara que especifica qué campos se mostrarán.
topK

integer

Es opcional. Es la cantidad de resultados que se mostrarán. Si no se configura, se usará un valor predeterminado.

Ranker

Define un clasificador para combinar los resultados de varias búsquedas.

Representación JSON 
{

  // Union field ranker can be only one of the following:
  "rrf": {
    object (ReciprocalRankFusion)
  }
  // End of list of possible types for union field ranker.
}
Campos
Campo de unión ranker. Es el método de clasificación que se usará. ranker puede ser solo uno de los parámetros siguientes:
rrf

object (ReciprocalRankFusion)

Clasificación de fusión de clasificación recíproca.

ReciprocalRankFusion

Define el algoritmo de fusión de clasificación recíproca (RRF) para la clasificación de resultados.

Representación JSON 
{
  "weights": [
    number
  ]
}
Campos
weights[]

number

Obligatorio. Son las ponderaciones que se aplicarán a cada conjunto de resultados de búsqueda durante la fusión.