CrowdingSpec

혼잡도 사양입니다. 크라우딩은 동일한 필드 값을 공유하는 결과 수를 제한하여 검색 결과의 다양성을 개선합니다. 예를 들어 maxCount가 3이고 모드가 DROP_CROWDED_RESULTS인 색상 필드의 크라우딩은 모든 페이지에서 동일한 색상의 결과를 최대 3개 반환합니다.

JSON 표현
{
  "field": string,
  "maxCount": integer,
  "mode": enum (Mode)
}
필드
field

string

혼잡에 사용할 필드입니다. 문서는 Document 객체의 필드별로 정렬할 수 있습니다. 혼잡도 필드는 대소문자를 구분합니다.

maxCount

integer

필드 값당 유지할 최대 문서 수입니다. orderBy에 지정된 순서에 따라 지정된 필드의 값이 동일한 이전 결과가 maxCount개 이상 있으면 값이 동일한 후속 결과는 '밀려납니다'. 지정하지 않으면 기본값은 1입니다.

mode

enum (Mode)

가려진 문서에 사용할 모드입니다.

모드

밀려난 문서에 사용할 모드를 설명하는 enum입니다. 이러한 제품은 순위가 떨어지거나 뒷페이지로 이동할 수 있습니다.

열거형
MODE_UNSPECIFIED 지정되지 않은 혼잡 모드입니다. 이 경우 서버 동작은 기본적으로 Mode.DROP_CROWDED_RESULTS입니다.
DROP_CROWDED_RESULTS 크라우드된 결과를 삭제합니다.
DEMOTE_CROWDED_RESULTS_TO_END 혼잡한 결과를 뒷페이지로 강등합니다.