public static final class SearchRequest.FacetSpec.FacetKey extends GeneratedMessageV3 implements SearchRequest.FacetSpec.FacetKeyOrBuilder
Specifies how a facet is computed.
Protobuf type google.cloud.retail.v2beta.SearchRequest.FacetSpec.FacetKey
Static Fields
CASE_INSENSITIVE_FIELD_NUMBER
public static final int CASE_INSENSITIVE_FIELD_NUMBER
Field Value
CONTAINS_FIELD_NUMBER
public static final int CONTAINS_FIELD_NUMBER
Field Value
INTERVALS_FIELD_NUMBER
public static final int INTERVALS_FIELD_NUMBER
Field Value
KEY_FIELD_NUMBER
public static final int KEY_FIELD_NUMBER
Field Value
ORDER_BY_FIELD_NUMBER
public static final int ORDER_BY_FIELD_NUMBER
Field Value
PREFIXES_FIELD_NUMBER
public static final int PREFIXES_FIELD_NUMBER
Field Value
QUERY_FIELD_NUMBER
public static final int QUERY_FIELD_NUMBER
Field Value
RESTRICTED_VALUES_FIELD_NUMBER
public static final int RESTRICTED_VALUES_FIELD_NUMBER
Field Value
RETURN_MIN_MAX_FIELD_NUMBER
public static final int RETURN_MIN_MAX_FIELD_NUMBER
Field Value
Static Methods
getDefaultInstance()
public static SearchRequest.FacetSpec.FacetKey getDefaultInstance()
Returns
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
Returns
newBuilder()
public static SearchRequest.FacetSpec.FacetKey.Builder newBuilder()
Returns
newBuilder(SearchRequest.FacetSpec.FacetKey prototype)
public static SearchRequest.FacetSpec.FacetKey.Builder newBuilder(SearchRequest.FacetSpec.FacetKey prototype)
Parameter
Returns
public static SearchRequest.FacetSpec.FacetKey parseDelimitedFrom(InputStream input)
Parameter
Returns
Exceptions
public static SearchRequest.FacetSpec.FacetKey parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(byte[] data)
public static SearchRequest.FacetSpec.FacetKey parseFrom(byte[] data)
Parameter
Name | Description |
data | byte[]
|
Returns
Exceptions
parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
public static SearchRequest.FacetSpec.FacetKey parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(ByteString data)
public static SearchRequest.FacetSpec.FacetKey parseFrom(ByteString data)
Parameter
Returns
Exceptions
parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
public static SearchRequest.FacetSpec.FacetKey parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static SearchRequest.FacetSpec.FacetKey parseFrom(CodedInputStream input)
Parameter
Returns
Exceptions
public static SearchRequest.FacetSpec.FacetKey parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static SearchRequest.FacetSpec.FacetKey parseFrom(InputStream input)
Parameter
Returns
Exceptions
public static SearchRequest.FacetSpec.FacetKey parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(ByteBuffer data)
public static SearchRequest.FacetSpec.FacetKey parseFrom(ByteBuffer data)
Parameter
Returns
Exceptions
parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
public static SearchRequest.FacetSpec.FacetKey parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parser()
public static Parser<SearchRequest.FacetSpec.FacetKey> parser()
Returns
Methods
equals(Object obj)
public boolean equals(Object obj)
Parameter
Returns
Overrides
getCaseInsensitive()
public boolean getCaseInsensitive()
True to make facet keys case insensitive when getting faceting
values with prefixes or contains; false otherwise.
bool case_insensitive = 10;
Returns
Type | Description |
boolean | The caseInsensitive.
|
getContains(int index)
public String getContains(int index)
Only get facet values that contains the given strings. For example,
suppose "categories" has three values "Women > Shoe",
"Women > Dress" and "Men > Shoe". If set "contains" to "Shoe", the
"categories" facet will give only "Women > Shoe" and "Men > Shoe".
Only supported on textual fields. Maximum is 10.
repeated string contains = 9;
Parameter
Name | Description |
index | int
The index of the element to return.
|
Returns
Type | Description |
String | The contains at the given index.
|
getContainsBytes(int index)
public ByteString getContainsBytes(int index)
Only get facet values that contains the given strings. For example,
suppose "categories" has three values "Women > Shoe",
"Women > Dress" and "Men > Shoe". If set "contains" to "Shoe", the
"categories" facet will give only "Women > Shoe" and "Men > Shoe".
Only supported on textual fields. Maximum is 10.
repeated string contains = 9;
Parameter
Name | Description |
index | int
The index of the value to return.
|
Returns
Type | Description |
ByteString | The bytes of the contains at the given index.
|
getContainsCount()
public int getContainsCount()
Only get facet values that contains the given strings. For example,
suppose "categories" has three values "Women > Shoe",
"Women > Dress" and "Men > Shoe". If set "contains" to "Shoe", the
"categories" facet will give only "Women > Shoe" and "Men > Shoe".
Only supported on textual fields. Maximum is 10.
repeated string contains = 9;
Returns
Type | Description |
int | The count of contains.
|
getContainsList()
public ProtocolStringList getContainsList()
Only get facet values that contains the given strings. For example,
suppose "categories" has three values "Women > Shoe",
"Women > Dress" and "Men > Shoe". If set "contains" to "Shoe", the
"categories" facet will give only "Women > Shoe" and "Men > Shoe".
Only supported on textual fields. Maximum is 10.
repeated string contains = 9;
Returns
getDefaultInstanceForType()
public SearchRequest.FacetSpec.FacetKey getDefaultInstanceForType()
Returns
getIntervals(int index)
public Interval getIntervals(int index)
Set only if values should be bucketized 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.retail.v2beta.Interval intervals = 2;
Parameter
Returns
getIntervalsCount()
public int getIntervalsCount()
Set only if values should be bucketized 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.retail.v2beta.Interval intervals = 2;
Returns
getIntervalsList()
public List<Interval> getIntervalsList()
Set only if values should be bucketized 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.retail.v2beta.Interval intervals = 2;
Returns
getIntervalsOrBuilder(int index)
public IntervalOrBuilder getIntervalsOrBuilder(int index)
Set only if values should be bucketized 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.retail.v2beta.Interval intervals = 2;
Parameter
Returns
getIntervalsOrBuilderList()
public List<? extends IntervalOrBuilder> getIntervalsOrBuilderList()
Set only if values should be bucketized 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.retail.v2beta.Interval intervals = 2;
Returns
Type | Description |
List<? extends com.google.cloud.retail.v2beta.IntervalOrBuilder> | |
getKey()
Required. Supported textual and numerical facet keys in
Product object, over which the
facet values are computed. Facet key is case-sensitive.
Allowed facet keys when
FacetKey.query
is not specified:
- textual_field =
- "brands"
- "categories"
- "genders"
- "ageGroups"
- "availability"
- "colorFamilies"
- "colors"
- "sizes"
- "materials"
- "patterns"
- "conditions"
- "attributes.key"
- "pickupInStore"
- "shipToStore"
- "sameDayDelivery"
- "nextDayDelivery"
- "customFulfillment1"
- "customFulfillment2"
- "customFulfillment3"
- "customFulfillment4"
- "customFulfillment5"
- "inventory(place_id,attributes.key)"
- numerical_field =
- "price"
- "discount"
- "rating"
- "ratingCount"
- "attributes.key"
- "inventory(place_id,price)"
- "inventory(place_id,original_price)"
- "inventory(place_id,attributes.key)"
string key = 1 [(.google.api.field_behavior) = REQUIRED];
Returns
getKeyBytes()
public ByteString getKeyBytes()
Required. Supported textual and numerical facet keys in
Product object, over which the
facet values are computed. Facet key is case-sensitive.
Allowed facet keys when
FacetKey.query
is not specified:
- textual_field =
- "brands"
- "categories"
- "genders"
- "ageGroups"
- "availability"
- "colorFamilies"
- "colors"
- "sizes"
- "materials"
- "patterns"
- "conditions"
- "attributes.key"
- "pickupInStore"
- "shipToStore"
- "sameDayDelivery"
- "nextDayDelivery"
- "customFulfillment1"
- "customFulfillment2"
- "customFulfillment3"
- "customFulfillment4"
- "customFulfillment5"
- "inventory(place_id,attributes.key)"
- numerical_field =
- "price"
- "discount"
- "rating"
- "ratingCount"
- "attributes.key"
- "inventory(place_id,price)"
- "inventory(place_id,original_price)"
- "inventory(place_id,attributes.key)"
string key = 1 [(.google.api.field_behavior) = REQUIRED];
Returns
getOrderBy()
public String getOrderBy()
The order in which
SearchResponse.Facet.values
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; numerical
intervals are sorted in the order given by
FacetSpec.FacetKey.intervals;
FulfillmentInfo.place_ids
are sorted in the order given by
FacetSpec.FacetKey.restricted_values.
string order_by = 4;
Returns
Type | Description |
String | The orderBy.
|
getOrderByBytes()
public ByteString getOrderByBytes()
The order in which
SearchResponse.Facet.values
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; numerical
intervals are sorted in the order given by
FacetSpec.FacetKey.intervals;
FulfillmentInfo.place_ids
are sorted in the order given by
FacetSpec.FacetKey.restricted_values.
string order_by = 4;
Returns
getParserForType()
public Parser<SearchRequest.FacetSpec.FacetKey> getParserForType()
Returns
Overrides
getPrefixes(int index)
public String getPrefixes(int index)
Only get facet values that start with the given string prefix. For
example, suppose "categories" has three values "Women > Shoe",
"Women > Dress" and "Men > Shoe". If set "prefixes" to "Women", the
"categories" facet will give only "Women > Shoe" and "Women > Dress".
Only supported on textual fields. Maximum is 10.
repeated string prefixes = 8;
Parameter
Name | Description |
index | int
The index of the element to return.
|
Returns
Type | Description |
String | The prefixes at the given index.
|
getPrefixesBytes(int index)
public ByteString getPrefixesBytes(int index)
Only get facet values that start with the given string prefix. For
example, suppose "categories" has three values "Women > Shoe",
"Women > Dress" and "Men > Shoe". If set "prefixes" to "Women", the
"categories" facet will give only "Women > Shoe" and "Women > Dress".
Only supported on textual fields. Maximum is 10.
repeated string prefixes = 8;
Parameter
Name | Description |
index | int
The index of the value to return.
|
Returns
Type | Description |
ByteString | The bytes of the prefixes at the given index.
|
getPrefixesCount()
public int getPrefixesCount()
Only get facet values that start with the given string prefix. For
example, suppose "categories" has three values "Women > Shoe",
"Women > Dress" and "Men > Shoe". If set "prefixes" to "Women", the
"categories" facet will give only "Women > Shoe" and "Women > Dress".
Only supported on textual fields. Maximum is 10.
repeated string prefixes = 8;
Returns
Type | Description |
int | The count of prefixes.
|
getPrefixesList()
public ProtocolStringList getPrefixesList()
Only get facet values that start with the given string prefix. For
example, suppose "categories" has three values "Women > Shoe",
"Women > Dress" and "Men > Shoe". If set "prefixes" to "Women", the
"categories" facet will give only "Women > Shoe" and "Women > Dress".
Only supported on textual fields. Maximum is 10.
repeated string prefixes = 8;
Returns
getQuery()
The query that is used to compute facet for the given facet key.
When provided, it will override the default behavior of facet
computation. The query syntax is the same as a filter expression. See
SearchRequest.filter
for detail syntax and limitations. Notice that there is no limitation
on
FacetKey.key
when query is specified.
In the response,
SearchResponse.Facet.values.value
will be always "1" and
SearchResponse.Facet.values.count
will be the number of results that match the query.
For example, you can set a customized facet for "shipToStore",
where
FacetKey.key
is "customizedShipToStore", and
FacetKey.query
is "availability: ANY(\"IN_STOCK\") AND shipToStore: ANY(\"123\")".
Then the facet will count the products that are both in stock and ship
to store "123".
string query = 5;
Returns
Type | Description |
String | The query.
|
getQueryBytes()
public ByteString getQueryBytes()
The query that is used to compute facet for the given facet key.
When provided, it will override the default behavior of facet
computation. The query syntax is the same as a filter expression. See
SearchRequest.filter
for detail syntax and limitations. Notice that there is no limitation
on
FacetKey.key
when query is specified.
In the response,
SearchResponse.Facet.values.value
will be always "1" and
SearchResponse.Facet.values.count
will be the number of results that match the query.
For example, you can set a customized facet for "shipToStore",
where
FacetKey.key
is "customizedShipToStore", and
FacetKey.query
is "availability: ANY(\"IN_STOCK\") AND shipToStore: ANY(\"123\")".
Then the facet will count the products that are both in stock and ship
to store "123".
string query = 5;
Returns
getRestrictedValues(int index)
public String getRestrictedValues(int index)
Only get facet for the given restricted values. For example, when using
"pickupInStore" as key and set restricted values to
["store123", "store456"], only facets for "store123" and "store456" are
returned. Only supported on predefined textual fields, custom textual
attributes and fulfillments. Maximum is 20.
Must be set for the fulfillment facet keys:
- pickupInStore
- shipToStore
- sameDayDelivery
- nextDayDelivery
- customFulfillment1
- customFulfillment2
- customFulfillment3
- customFulfillment4
- customFulfillment5
repeated string restricted_values = 3;
Parameter
Name | Description |
index | int
The index of the element to return.
|
Returns
Type | Description |
String | The restrictedValues at the given index.
|
getRestrictedValuesBytes(int index)
public ByteString getRestrictedValuesBytes(int index)
Only get facet for the given restricted values. For example, when using
"pickupInStore" as key and set restricted values to
["store123", "store456"], only facets for "store123" and "store456" are
returned. Only supported on predefined textual fields, custom textual
attributes and fulfillments. Maximum is 20.
Must be set for the fulfillment facet keys:
- pickupInStore
- shipToStore
- sameDayDelivery
- nextDayDelivery
- customFulfillment1
- customFulfillment2
- customFulfillment3
- customFulfillment4
- customFulfillment5
repeated string restricted_values = 3;
Parameter
Name | Description |
index | int
The index of the value to return.
|
Returns
Type | Description |
ByteString | The bytes of the restrictedValues at the given index.
|
getRestrictedValuesCount()
public int getRestrictedValuesCount()
Only get facet for the given restricted values. For example, when using
"pickupInStore" as key and set restricted values to
["store123", "store456"], only facets for "store123" and "store456" are
returned. Only supported on predefined textual fields, custom textual
attributes and fulfillments. Maximum is 20.
Must be set for the fulfillment facet keys:
- pickupInStore
- shipToStore
- sameDayDelivery
- nextDayDelivery
- customFulfillment1
- customFulfillment2
- customFulfillment3
- customFulfillment4
- customFulfillment5
repeated string restricted_values = 3;
Returns
Type | Description |
int | The count of restrictedValues.
|
getRestrictedValuesList()
public ProtocolStringList getRestrictedValuesList()
Only get facet for the given restricted values. For example, when using
"pickupInStore" as key and set restricted values to
["store123", "store456"], only facets for "store123" and "store456" are
returned. Only supported on predefined textual fields, custom textual
attributes and fulfillments. Maximum is 20.
Must be set for the fulfillment facet keys:
- pickupInStore
- shipToStore
- sameDayDelivery
- nextDayDelivery
- customFulfillment1
- customFulfillment2
- customFulfillment3
- customFulfillment4
- customFulfillment5
repeated string restricted_values = 3;
Returns
getReturnMinMax()
public boolean getReturnMinMax()
Returns the min and max value for each numerical facet intervals.
Ignored for textual facets.
bool return_min_max = 11;
Returns
Type | Description |
boolean | The returnMinMax.
|
getSerializedSize()
public int getSerializedSize()
Returns
Overrides
getUnknownFields()
public final UnknownFieldSet getUnknownFields()
Returns
Overrides
hashCode()
Returns
Overrides
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Overrides
isInitialized()
public final boolean isInitialized()
Returns
Overrides
newBuilderForType()
public SearchRequest.FacetSpec.FacetKey.Builder newBuilderForType()
Returns
newBuilderForType(GeneratedMessageV3.BuilderParent parent)
protected SearchRequest.FacetSpec.FacetKey.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
Returns
Overrides
newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
Returns
Overrides
toBuilder()
public SearchRequest.FacetSpec.FacetKey.Builder toBuilder()
Returns
writeTo(CodedOutputStream output)
public void writeTo(CodedOutputStream output)
Parameter
Overrides
Exceptions