# Interface SearchRequest.FacetSpec.FacetKeyOrBuilder (0.89.0)

0.89.0 (latest) 0.87.0 0.84.0 0.83.0 0.81.0 0.79.0 0.78.0 0.77.0 0.76.0 0.74.0 0.72.0 0.71.0 0.70.0 0.69.0 0.68.0 0.66.0 0.64.0 0.63.0 0.60.0 0.59.0 0.58.0 0.56.0 0.55.0 0.54.0 0.53.0 0.52.0 0.51.0 0.50.0 0.49.0 0.48.0 0.47.0 0.45.0 0.44.0 0.43.0 0.42.0 0.41.0 0.40.0 0.39.0 0.38.0 0.37.0 0.36.0 0.35.0 0.33.0 0.32.0 0.31.0 0.30.0 0.29.0 0.28.0 0.27.0 0.26.0 0.25.0 0.24.0 0.23.0 0.20.0 0.19.0 0.18.0 0.17.0 0.16.0 0.15.0 0.14.0 0.13.0 0.12.0 0.11.0 0.10.0 0.9.0 0.8.0 0.7.0 0.5.0 0.4.0 0.3.0 0.2.0 0.1.0

    public static interface SearchRequest.FacetSpec.FacetKeyOrBuilder extends MessageOrBuilder

## Implements

[MessageOrBuilder](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.MessageOrBuilder.html)

## Methods

### getCaseInsensitive()

    public abstract boolean getCaseInsensitive()

True to make facet keys case insensitive when getting faceting
values with prefixes or contains; false otherwise.

`bool case_insensitive = 6;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The caseInsensitive. |

### getContains(int index)

    public abstract String getContains(int index)

Only get facet values that contain the given strings. For example,
suppose "category" has three values "Action \> 2022",
"Action \> 2021" and "Sci-Fi \> 2022". If set "contains" to "2022", the
"category" facet only contains "Action \> 2022" and "Sci-Fi \> 2022".
Only supported on textual fields. Maximum is 10.

`repeated string contains = 5;`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The contains at the given index. |

### getContainsBytes(int index)

    public abstract ByteString getContainsBytes(int index)

Only get facet values that contain the given strings. For example,
suppose "category" has three values "Action \> 2022",
"Action \> 2021" and "Sci-Fi \> 2022". If set "contains" to "2022", the
"category" facet only contains "Action \> 2022" and "Sci-Fi \> 2022".
Only supported on textual fields. Maximum is 10.

`repeated string contains = 5;`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the contains at the given index. |

### getContainsCount()

    public abstract int getContainsCount()

Only get facet values that contain the given strings. For example,
suppose "category" has three values "Action \> 2022",
"Action \> 2021" and "Sci-Fi \> 2022". If set "contains" to "2022", the
"category" facet only contains "Action \> 2022" and "Sci-Fi \> 2022".
Only supported on textual fields. Maximum is 10.

`repeated string contains = 5;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of contains. |

### getContainsList()

    public abstract List<String> getContainsList()

Only get facet values that contain the given strings. For example,
suppose "category" has three values "Action \> 2022",
"Action \> 2021" and "Sci-Fi \> 2022". If set "contains" to "2022", the
"category" facet only contains "Action \> 2022" and "Sci-Fi \> 2022".
Only supported on textual fields. Maximum is 10.

`repeated string contains = 5;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/util/List.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` | A list containing the contains. |

### getIntervals(int index)

    public abstract Interval getIntervals(int index)

Set only if values should be bucketed into intervals. Must be set
for facets with numerical values. Must not be set for facet with text
values. Maximum number of intervals is 30.

`repeated .google.cloud.discoveryengine.v1alpha.Interval intervals = 2;`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-discoveryengine/latest/com.google.cloud.discoveryengine.v1alpha.Interval` |   |

### getIntervalsCount()

    public abstract int getIntervalsCount()

Set only if values should be bucketed into intervals. Must be set
for facets with numerical values. Must not be set for facet with text
values. Maximum number of intervals is 30.

`repeated .google.cloud.discoveryengine.v1alpha.Interval intervals = 2;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` |   |

### getIntervalsList()

    public abstract List<Interval> getIntervalsList()

Set only if values should be bucketed into intervals. Must be set
for facets with numerical values. Must not be set for facet with text
values. Maximum number of intervals is 30.

`repeated .google.cloud.discoveryengine.v1alpha.Interval intervals = 2;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/util/List.html<https://docs.cloud.google.com/java/docs/reference/google-cloud-discoveryengine/latest/com.google.cloud.discoveryengine.v1alpha.Interval>` |   |

### getIntervalsOrBuilder(int index)

    public abstract IntervalOrBuilder getIntervalsOrBuilder(int index)

Set only if values should be bucketed into intervals. Must be set
for facets with numerical values. Must not be set for facet with text
values. Maximum number of intervals is 30.

`repeated .google.cloud.discoveryengine.v1alpha.Interval intervals = 2;`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-discoveryengine/latest/com.google.cloud.discoveryengine.v1alpha.IntervalOrBuilder` |   |

### getIntervalsOrBuilderList()

    public abstract List<? extends IntervalOrBuilder> getIntervalsOrBuilderList()

Set only if values should be bucketed into intervals. Must be set
for facets with numerical values. Must not be set for facet with text
values. Maximum number of intervals is 30.

`repeated .google.cloud.discoveryengine.v1alpha.Interval intervals = 2;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/util/List.html<? extends com.google.cloud.discoveryengine.v1alpha.IntervalOrBuilder>` |   |

### getKey()

    public abstract String getKey()

Required. Supported textual and numerical facet keys in
Document object, over
which the facet values are computed. Facet key is case-sensitive.

`string key = 1 [(.google.api.field_behavior) = REQUIRED];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The key. |

### getKeyBytes()

    public abstract ByteString getKeyBytes()

Required. Supported textual and numerical facet keys in
Document object, over
which the facet values are computed. Facet key is case-sensitive.

`string key = 1 [(.google.api.field_behavior) = REQUIRED];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for key. |

### getOrderBy()

    public abstract String getOrderBy()

The order in which documents are returned.

Allowed values are:

- "count desc", which means order by
  SearchResponse.Facet.values.count
  descending.

- "value desc", which means order by
  SearchResponse.Facet.values.value
  descending.
  Only applies to textual facets.

  If not set, textual values are sorted in [natural
  order](https://en.wikipedia.org/wiki/Natural_sort_order); numerical
  intervals are sorted in the order given by
  FacetSpec.FacetKey.intervals.

`string order_by = 7;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The orderBy. |

### getOrderByBytes()

    public abstract ByteString getOrderByBytes()

The order in which documents are returned.

Allowed values are:

- "count desc", which means order by
  SearchResponse.Facet.values.count
  descending.

- "value desc", which means order by
  SearchResponse.Facet.values.value
  descending.
  Only applies to textual facets.

  If not set, textual values are sorted in [natural
  order](https://en.wikipedia.org/wiki/Natural_sort_order); numerical
  intervals are sorted in the order given by
  FacetSpec.FacetKey.intervals.

`string order_by = 7;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for orderBy. |

### getPrefixes(int index)

    public abstract String getPrefixes(int index)

Only get facet values that start with the given string prefix. For
example, suppose "category" has three values "Action \> 2022",
"Action \> 2021" and "Sci-Fi \> 2022". If set "prefixes" to "Action", the
"category" facet only contains "Action \> 2022" and "Action \> 2021".
Only supported on textual fields. Maximum is 10.

`repeated string prefixes = 4;`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The prefixes at the given index. |

### getPrefixesBytes(int index)

    public abstract ByteString getPrefixesBytes(int index)

Only get facet values that start with the given string prefix. For
example, suppose "category" has three values "Action \> 2022",
"Action \> 2021" and "Sci-Fi \> 2022". If set "prefixes" to "Action", the
"category" facet only contains "Action \> 2022" and "Action \> 2021".
Only supported on textual fields. Maximum is 10.

`repeated string prefixes = 4;`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the prefixes at the given index. |

### getPrefixesCount()

    public abstract int getPrefixesCount()

Only get facet values that start with the given string prefix. For
example, suppose "category" has three values "Action \> 2022",
"Action \> 2021" and "Sci-Fi \> 2022". If set "prefixes" to "Action", the
"category" facet only contains "Action \> 2022" and "Action \> 2021".
Only supported on textual fields. Maximum is 10.

`repeated string prefixes = 4;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of prefixes. |

### getPrefixesList()

    public abstract List<String> getPrefixesList()

Only get facet values that start with the given string prefix. For
example, suppose "category" has three values "Action \> 2022",
"Action \> 2021" and "Sci-Fi \> 2022". If set "prefixes" to "Action", the
"category" facet only contains "Action \> 2022" and "Action \> 2021".
Only supported on textual fields. Maximum is 10.

`repeated string prefixes = 4;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/util/List.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` | A list containing the prefixes. |

### getRestrictedValues(int index)

    public abstract String getRestrictedValues(int index)

Only get facet for the given restricted values. Only supported on
textual fields. For example, suppose "category" has three values
"Action \> 2022", "Action \> 2021" and "Sci-Fi \> 2022". If set
"restricted_values" to "Action \> 2022", the "category" facet only
contains "Action \> 2022". Only supported on textual fields. Maximum
is 10.

`repeated string restricted_values = 3;`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The restrictedValues at the given index. |

### getRestrictedValuesBytes(int index)

    public abstract ByteString getRestrictedValuesBytes(int index)

Only get facet for the given restricted values. Only supported on
textual fields. For example, suppose "category" has three values
"Action \> 2022", "Action \> 2021" and "Sci-Fi \> 2022". If set
"restricted_values" to "Action \> 2022", the "category" facet only
contains "Action \> 2022". Only supported on textual fields. Maximum
is 10.

`repeated string restricted_values = 3;`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the restrictedValues at the given index. |

### getRestrictedValuesCount()

    public abstract int getRestrictedValuesCount()

Only get facet for the given restricted values. Only supported on
textual fields. For example, suppose "category" has three values
"Action \> 2022", "Action \> 2021" and "Sci-Fi \> 2022". If set
"restricted_values" to "Action \> 2022", the "category" facet only
contains "Action \> 2022". Only supported on textual fields. Maximum
is 10.

`repeated string restricted_values = 3;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of restrictedValues. |

### getRestrictedValuesList()

    public abstract List<String> getRestrictedValuesList()

Only get facet for the given restricted values. Only supported on
textual fields. For example, suppose "category" has three values
"Action \> 2022", "Action \> 2021" and "Sci-Fi \> 2022". If set
"restricted_values" to "Action \> 2022", the "category" facet only
contains "Action \> 2022". Only supported on textual fields. Maximum
is 10.

`repeated string restricted_values = 3;`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/util/List.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` | A list containing the restrictedValues. |