Method: projects.locations.collections.dataObjects.aggregate

Aggregiert Datenobjekte.

HTTP-Anfrage

POST https://vectorsearch.googleapis.com/v1beta/{parent}/dataObjects:aggregate

Pfadparameter

Parameter
parent

string

Erforderlich. Der Ressourcenname der Sammlung, für die die Abfrage ausgeführt werden soll. Format: projects/{project}/locations/{location}/collections/{collection}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "filter": {
    object
  },
  "aggregate": enum (AggregationMethod)
}
Felder
filter

object (Struct format)

Optional. Ein JSON-Filterausdruck, z.B. {"genre": {"$eq": "sci-fi"}}, dargestellt als google.protobuf.Struct.
aggregate

enum (AggregationMethod)

Erforderlich. Die Aggregationsmethode, die auf die Abfrage angewendet werden soll.

Antworttext

Antwortnachricht für DataObjectSearchService.AggregateDataObjects.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "aggregateResults": [
    {
      object
    }
  ]
}
Felder
aggregateResults[]

object (Struct format)

Die zusammengefassten Ergebnisse der Abfrage.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource parent:

  • vectorsearch.dataObjects.query

Weitere Informationen finden Sie in der IAM-Dokumentation.

AggregationMethod

Aggregationsmethoden.

Enums
AGGREGATION_METHOD_UNSPECIFIED Sollte nicht verwendet werden.
COUNT Zählt die Anzahl der Datenobjekte, die dem Filter entsprechen.