- 2.56.0 (latest)
- 2.55.0
- 2.54.0
- 2.53.0
- 2.51.0
- 2.50.0
- 2.49.0
- 2.48.0
- 2.47.0
- 2.46.0
- 2.45.0
- 2.44.0
- 2.43.0
- 2.42.0
- 2.41.0
- 2.39.0
- 2.38.0
- 2.37.0
- 2.36.0
- 2.35.0
- 2.34.0
- 2.33.0
- 2.32.0
- 2.31.0
- 2.30.0
- 2.29.0
- 2.26.0
- 2.25.0
- 2.24.0
- 2.23.0
- 2.22.0
- 2.21.0
- 2.20.0
- 2.19.0
- 2.18.0
- 2.17.0
- 2.16.0
- 2.15.0
- 2.14.0
- 2.13.0
- 2.11.0
- 2.10.0
- 2.9.0
- 2.8.0
- 2.7.0
- 2.6.0
- 2.5.1
- 2.4.0
- 2.3.0
- 2.2.3
- 2.1.0
- 2.0.19
public static final class SearchRequest.FacetSpec.FacetKey.Builder extends GeneratedMessageV3.Builder<SearchRequest.FacetSpec.FacetKey.Builder> implements SearchRequest.FacetSpec.FacetKeyOrBuilder
Specifies how a facet is computed.
Protobuf type google.cloud.retail.v2.SearchRequest.FacetSpec.FacetKey
Inheritance
Object > AbstractMessageLite.Builder<MessageType,BuilderType> > AbstractMessage.Builder<BuilderType> > GeneratedMessageV3.Builder > SearchRequest.FacetSpec.FacetKey.BuilderImplements
SearchRequest.FacetSpec.FacetKeyOrBuilderStatic Methods
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
Returns | |
---|---|
Type | Description |
Descriptor |
Methods
addAllContains(Iterable<String> values)
public SearchRequest.FacetSpec.FacetKey.Builder addAllContains(Iterable<String> values)
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 gives only "Women > Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
repeated string contains = 9;
Parameter | |
---|---|
Name | Description |
values |
Iterable<String> The contains to add. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
addAllIntervals(Iterable<? extends Interval> values)
public SearchRequest.FacetSpec.FacetKey.Builder addAllIntervals(Iterable<? extends Interval> values)
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Parameter | |
---|---|
Name | Description |
values |
Iterable<? extends com.google.cloud.retail.v2.Interval> |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
addAllPrefixes(Iterable<String> values)
public SearchRequest.FacetSpec.FacetKey.Builder addAllPrefixes(Iterable<String> values)
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 gives only "Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum is 10.
repeated string prefixes = 8;
Parameter | |
---|---|
Name | Description |
values |
Iterable<String> The prefixes to add. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
addAllRestrictedValues(Iterable<String> values)
public SearchRequest.FacetSpec.FacetKey.Builder addAllRestrictedValues(Iterable<String> values)
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 |
values |
Iterable<String> The restrictedValues to add. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
addContains(String value)
public SearchRequest.FacetSpec.FacetKey.Builder addContains(String value)
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 gives only "Women > Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
repeated string contains = 9;
Parameter | |
---|---|
Name | Description |
value |
String The contains to add. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
addContainsBytes(ByteString value)
public SearchRequest.FacetSpec.FacetKey.Builder addContainsBytes(ByteString value)
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 gives only "Women > Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
repeated string contains = 9;
Parameter | |
---|---|
Name | Description |
value |
ByteString The bytes of the contains to add. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
addIntervals(Interval value)
public SearchRequest.FacetSpec.FacetKey.Builder addIntervals(Interval value)
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Parameter | |
---|---|
Name | Description |
value |
Interval |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
addIntervals(Interval.Builder builderForValue)
public SearchRequest.FacetSpec.FacetKey.Builder addIntervals(Interval.Builder builderForValue)
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Parameter | |
---|---|
Name | Description |
builderForValue |
Interval.Builder |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
addIntervals(int index, Interval value)
public SearchRequest.FacetSpec.FacetKey.Builder addIntervals(int index, Interval value)
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Parameters | |
---|---|
Name | Description |
index |
int |
value |
Interval |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
addIntervals(int index, Interval.Builder builderForValue)
public SearchRequest.FacetSpec.FacetKey.Builder addIntervals(int index, Interval.Builder builderForValue)
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Parameters | |
---|---|
Name | Description |
index |
int |
builderForValue |
Interval.Builder |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
addIntervalsBuilder()
public Interval.Builder addIntervalsBuilder()
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Returns | |
---|---|
Type | Description |
Interval.Builder |
addIntervalsBuilder(int index)
public Interval.Builder addIntervalsBuilder(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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Parameter | |
---|---|
Name | Description |
index |
int |
Returns | |
---|---|
Type | Description |
Interval.Builder |
addPrefixes(String value)
public SearchRequest.FacetSpec.FacetKey.Builder addPrefixes(String value)
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 gives only "Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum is 10.
repeated string prefixes = 8;
Parameter | |
---|---|
Name | Description |
value |
String The prefixes to add. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
addPrefixesBytes(ByteString value)
public SearchRequest.FacetSpec.FacetKey.Builder addPrefixesBytes(ByteString value)
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 gives only "Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum is 10.
repeated string prefixes = 8;
Parameter | |
---|---|
Name | Description |
value |
ByteString The bytes of the prefixes to add. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
addRepeatedField(Descriptors.FieldDescriptor field, Object value)
public SearchRequest.FacetSpec.FacetKey.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters | |
---|---|
Name | Description |
field |
FieldDescriptor |
value |
Object |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
addRestrictedValues(String value)
public SearchRequest.FacetSpec.FacetKey.Builder addRestrictedValues(String value)
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 |
value |
String The restrictedValues to add. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
addRestrictedValuesBytes(ByteString value)
public SearchRequest.FacetSpec.FacetKey.Builder addRestrictedValuesBytes(ByteString value)
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 |
value |
ByteString The bytes of the restrictedValues to add. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
build()
public SearchRequest.FacetSpec.FacetKey build()
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey |
buildPartial()
public SearchRequest.FacetSpec.FacetKey buildPartial()
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey |
clear()
public SearchRequest.FacetSpec.FacetKey.Builder clear()
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
clearCaseInsensitive()
public SearchRequest.FacetSpec.FacetKey.Builder clearCaseInsensitive()
True to make facet keys case insensitive when getting faceting values with prefixes or contains; false otherwise.
bool case_insensitive = 10;
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
clearContains()
public SearchRequest.FacetSpec.FacetKey.Builder clearContains()
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 gives only "Women > Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
repeated string contains = 9;
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
clearField(Descriptors.FieldDescriptor field)
public SearchRequest.FacetSpec.FacetKey.Builder clearField(Descriptors.FieldDescriptor field)
Parameter | |
---|---|
Name | Description |
field |
FieldDescriptor |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
clearIntervals()
public SearchRequest.FacetSpec.FacetKey.Builder clearIntervals()
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
clearKey()
public SearchRequest.FacetSpec.FacetKey.Builder clearKey()
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 | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
clearOneof(Descriptors.OneofDescriptor oneof)
public SearchRequest.FacetSpec.FacetKey.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter | |
---|---|
Name | Description |
oneof |
OneofDescriptor |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
clearOrderBy()
public SearchRequest.FacetSpec.FacetKey.Builder clearOrderBy()
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 |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
clearPrefixes()
public SearchRequest.FacetSpec.FacetKey.Builder clearPrefixes()
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 gives only "Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum is 10.
repeated string prefixes = 8;
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
clearQuery()
public SearchRequest.FacetSpec.FacetKey.Builder clearQuery()
The query that is used to compute facet for the given facet key. When provided, it overrides 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 is always "1" and SearchResponse.Facet.values.count is 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 counts the products that are both in stock and ship to store "123".
string query = 5;
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
clearRestrictedValues()
public SearchRequest.FacetSpec.FacetKey.Builder clearRestrictedValues()
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 |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
clearReturnMinMax()
public SearchRequest.FacetSpec.FacetKey.Builder clearReturnMinMax()
Returns the min and max value for each numerical facet intervals. Ignored for textual facets.
bool return_min_max = 11;
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
clone()
public SearchRequest.FacetSpec.FacetKey.Builder clone()
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
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 gives 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 gives 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 gives 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 gives only "Women > Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
repeated string contains = 9;
Returns | |
---|---|
Type | Description |
ProtocolStringList |
A list containing the contains. |
getDefaultInstanceForType()
public SearchRequest.FacetSpec.FacetKey getDefaultInstanceForType()
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey |
getDescriptorForType()
public Descriptors.Descriptor getDescriptorForType()
Returns | |
---|---|
Type | Description |
Descriptor |
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Parameter | |
---|---|
Name | Description |
index |
int |
Returns | |
---|---|
Type | Description |
Interval |
getIntervalsBuilder(int index)
public Interval.Builder getIntervalsBuilder(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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Parameter | |
---|---|
Name | Description |
index |
int |
Returns | |
---|---|
Type | Description |
Interval.Builder |
getIntervalsBuilderList()
public List<Interval.Builder> getIntervalsBuilderList()
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Returns | |
---|---|
Type | Description |
List<Builder> |
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Returns | |
---|---|
Type | Description |
int |
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Returns | |
---|---|
Type | Description |
List<Interval> |
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Parameter | |
---|---|
Name | Description |
index |
int |
Returns | |
---|---|
Type | Description |
IntervalOrBuilder |
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Returns | |
---|---|
Type | Description |
List<? extends com.google.cloud.retail.v2.IntervalOrBuilder> |
getKey()
public String 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 | |
---|---|
Type | Description |
String |
The key. |
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 | |
---|---|
Type | Description |
ByteString |
The bytes for key. |
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 | |
---|---|
Type | Description |
ByteString |
The bytes for orderBy. |
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 gives 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 gives 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 gives 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 gives only "Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum is 10.
repeated string prefixes = 8;
Returns | |
---|---|
Type | Description |
ProtocolStringList |
A list containing the prefixes. |
getQuery()
public String getQuery()
The query that is used to compute facet for the given facet key. When provided, it overrides 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 is always "1" and SearchResponse.Facet.values.count is 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 counts 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 overrides 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 is always "1" and SearchResponse.Facet.values.count is 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 counts the products that are both in stock and ship to store "123".
string query = 5;
Returns | |
---|---|
Type | Description |
ByteString |
The bytes for query. |
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 | |
---|---|
Type | Description |
ProtocolStringList |
A list containing the restrictedValues. |
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. |
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns | |
---|---|
Type | Description |
FieldAccessorTable |
isInitialized()
public final boolean isInitialized()
Returns | |
---|---|
Type | Description |
boolean |
mergeFrom(SearchRequest.FacetSpec.FacetKey other)
public SearchRequest.FacetSpec.FacetKey.Builder mergeFrom(SearchRequest.FacetSpec.FacetKey other)
Parameter | |
---|---|
Name | Description |
other |
SearchRequest.FacetSpec.FacetKey |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
public SearchRequest.FacetSpec.FacetKey.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters | |
---|---|
Name | Description |
input |
CodedInputStream |
extensionRegistry |
ExtensionRegistryLite |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
Exceptions | |
---|---|
Type | Description |
IOException |
mergeFrom(Message other)
public SearchRequest.FacetSpec.FacetKey.Builder mergeFrom(Message other)
Parameter | |
---|---|
Name | Description |
other |
Message |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
mergeUnknownFields(UnknownFieldSet unknownFields)
public final SearchRequest.FacetSpec.FacetKey.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter | |
---|---|
Name | Description |
unknownFields |
UnknownFieldSet |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
removeIntervals(int index)
public SearchRequest.FacetSpec.FacetKey.Builder removeIntervals(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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Parameter | |
---|---|
Name | Description |
index |
int |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
setCaseInsensitive(boolean value)
public SearchRequest.FacetSpec.FacetKey.Builder setCaseInsensitive(boolean value)
True to make facet keys case insensitive when getting faceting values with prefixes or contains; false otherwise.
bool case_insensitive = 10;
Parameter | |
---|---|
Name | Description |
value |
boolean The caseInsensitive to set. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
setContains(int index, String value)
public SearchRequest.FacetSpec.FacetKey.Builder setContains(int index, String value)
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 gives only "Women > Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
repeated string contains = 9;
Parameters | |
---|---|
Name | Description |
index |
int The index to set the value at. |
value |
String The contains to set. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
setField(Descriptors.FieldDescriptor field, Object value)
public SearchRequest.FacetSpec.FacetKey.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters | |
---|---|
Name | Description |
field |
FieldDescriptor |
value |
Object |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
setIntervals(int index, Interval value)
public SearchRequest.FacetSpec.FacetKey.Builder setIntervals(int index, Interval value)
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Parameters | |
---|---|
Name | Description |
index |
int |
value |
Interval |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
setIntervals(int index, Interval.Builder builderForValue)
public SearchRequest.FacetSpec.FacetKey.Builder setIntervals(int index, Interval.Builder builderForValue)
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 40.
For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
repeated .google.cloud.retail.v2.Interval intervals = 2;
Parameters | |
---|---|
Name | Description |
index |
int |
builderForValue |
Interval.Builder |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
setKey(String value)
public SearchRequest.FacetSpec.FacetKey.Builder setKey(String value)
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];
Parameter | |
---|---|
Name | Description |
value |
String The key to set. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
setKeyBytes(ByteString value)
public SearchRequest.FacetSpec.FacetKey.Builder setKeyBytes(ByteString value)
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];
Parameter | |
---|---|
Name | Description |
value |
ByteString The bytes for key to set. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
setOrderBy(String value)
public SearchRequest.FacetSpec.FacetKey.Builder setOrderBy(String value)
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;
Parameter | |
---|---|
Name | Description |
value |
String The orderBy to set. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
setOrderByBytes(ByteString value)
public SearchRequest.FacetSpec.FacetKey.Builder setOrderByBytes(ByteString value)
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;
Parameter | |
---|---|
Name | Description |
value |
ByteString The bytes for orderBy to set. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
setPrefixes(int index, String value)
public SearchRequest.FacetSpec.FacetKey.Builder setPrefixes(int index, String value)
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 gives only "Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum is 10.
repeated string prefixes = 8;
Parameters | |
---|---|
Name | Description |
index |
int The index to set the value at. |
value |
String The prefixes to set. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
setQuery(String value)
public SearchRequest.FacetSpec.FacetKey.Builder setQuery(String value)
The query that is used to compute facet for the given facet key. When provided, it overrides 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 is always "1" and SearchResponse.Facet.values.count is 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 counts the products that are both in stock and ship to store "123".
string query = 5;
Parameter | |
---|---|
Name | Description |
value |
String The query to set. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
setQueryBytes(ByteString value)
public SearchRequest.FacetSpec.FacetKey.Builder setQueryBytes(ByteString value)
The query that is used to compute facet for the given facet key. When provided, it overrides 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 is always "1" and SearchResponse.Facet.values.count is 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 counts the products that are both in stock and ship to store "123".
string query = 5;
Parameter | |
---|---|
Name | Description |
value |
ByteString The bytes for query to set. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
public SearchRequest.FacetSpec.FacetKey.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters | |
---|---|
Name | Description |
field |
FieldDescriptor |
index |
int |
value |
Object |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
setRestrictedValues(int index, String value)
public SearchRequest.FacetSpec.FacetKey.Builder setRestrictedValues(int index, String value)
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;
Parameters | |
---|---|
Name | Description |
index |
int The index to set the value at. |
value |
String The restrictedValues to set. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
setReturnMinMax(boolean value)
public SearchRequest.FacetSpec.FacetKey.Builder setReturnMinMax(boolean value)
Returns the min and max value for each numerical facet intervals. Ignored for textual facets.
bool return_min_max = 11;
Parameter | |
---|---|
Name | Description |
value |
boolean The returnMinMax to set. |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |
This builder for chaining. |
setUnknownFields(UnknownFieldSet unknownFields)
public final SearchRequest.FacetSpec.FacetKey.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter | |
---|---|
Name | Description |
unknownFields |
UnknownFieldSet |
Returns | |
---|---|
Type | Description |
SearchRequest.FacetSpec.FacetKey.Builder |