Method: projects.locations.collections.dataObjects.aggregate

데이터 객체를 집계합니다.

HTTP 요청

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 쿼리할 컬렉션의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/collections/{collection}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "filter": {
    object
  },
  "aggregate": enum (AggregationMethod)
}
필드
filter

object (Struct format)

선택사항입니다. JSON 필터 표현식(예: {"genre": {"$eq": "sci-fi"}})으로, google.protobuf.Struct로 표현됩니다.
aggregate

enum (AggregationMethod)

필수 항목입니다. 쿼리에 적용할 집계 방법입니다.

응답 본문

DataObjectSearchService.AggregateDataObjects의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "aggregateResults": [
    {
      object
    }
  ]
}
필드
aggregateResults[]

object (Struct format)

쿼리의 집계된 결과입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • vectorsearch.dataObjects.query

자세한 내용은 IAM 문서를 참조하세요.

AggregationMethod

집계 방법

열거형
AGGREGATION_METHOD_UNSPECIFIED 사용해서는 안 됩니다.
COUNT 필터와 일치하는 데이터 객체의 수를 셉니다.