Class SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder (0.81.0)

public static final class SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder extends GeneratedMessage.Builder<SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder> implements SearchRequest.NaturalLanguageQueryUnderstandingSpecOrBuilder

Specification to enable natural language understanding capabilities for search requests.

Protobuf type google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

Methods

addAllAllowedFieldNames(Iterable<String> values)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder addAllAllowedFieldNames(Iterable<String> values)

Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.

repeated string allowed_field_names = 4 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
values Iterable<String>

The allowedFieldNames to add.

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

addAllGeoSearchQueryDetectionFieldNames(Iterable<String> values)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder addAllGeoSearchQueryDetectionFieldNames(Iterable<String> values)

Field names used for location-based filtering, where geolocation filters are detected in natural language search queries. Only valid when the FilterExtractionCondition is set to ENABLED.

If this field is set, it overrides the field names set in ServingConfig.geo_search_query_detection_field_names.

repeated string geo_search_query_detection_field_names = 2;

Parameter
Name Description
values Iterable<String>

The geoSearchQueryDetectionFieldNames to add.

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

addAllowedFieldNames(String value)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder addAllowedFieldNames(String value)

Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.

repeated string allowed_field_names = 4 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value String

The allowedFieldNames to add.

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

addAllowedFieldNamesBytes(ByteString value)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder addAllowedFieldNamesBytes(ByteString value)

Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.

repeated string allowed_field_names = 4 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value ByteString

The bytes of the allowedFieldNames to add.

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

addGeoSearchQueryDetectionFieldNames(String value)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder addGeoSearchQueryDetectionFieldNames(String value)

Field names used for location-based filtering, where geolocation filters are detected in natural language search queries. Only valid when the FilterExtractionCondition is set to ENABLED.

If this field is set, it overrides the field names set in ServingConfig.geo_search_query_detection_field_names.

repeated string geo_search_query_detection_field_names = 2;

Parameter
Name Description
value String

The geoSearchQueryDetectionFieldNames to add.

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

addGeoSearchQueryDetectionFieldNamesBytes(ByteString value)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder addGeoSearchQueryDetectionFieldNamesBytes(ByteString value)

Field names used for location-based filtering, where geolocation filters are detected in natural language search queries. Only valid when the FilterExtractionCondition is set to ENABLED.

If this field is set, it overrides the field names set in ServingConfig.geo_search_query_detection_field_names.

repeated string geo_search_query_detection_field_names = 2;

Parameter
Name Description
value ByteString

The bytes of the geoSearchQueryDetectionFieldNames to add.

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

build()

public SearchRequest.NaturalLanguageQueryUnderstandingSpec build()
Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec

buildPartial()

public SearchRequest.NaturalLanguageQueryUnderstandingSpec buildPartial()
Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec

clear()

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder clear()
Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder
Overrides

clearAllowedFieldNames()

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder clearAllowedFieldNames()

Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.

repeated string allowed_field_names = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

clearExtractedFilterBehavior()

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder clearExtractedFilterBehavior()

Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is HARD_FILTER. For multi-datastore search, the default behavior is SOFT_BOOST. Location-based filters are always applied as hard filters, and the SOFT_BOOST setting will not affect them. This field is only used if SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition is set to FilterExtractionCondition.ENABLED.

.google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec.ExtractedFilterBehavior extracted_filter_behavior = 3 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

clearFilterExtractionCondition()

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder clearFilterExtractionCondition()

The condition under which filter extraction should occur. Server behavior defaults to DISABLED.

.google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition filter_extraction_condition = 1;

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

clearGeoSearchQueryDetectionFieldNames()

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder clearGeoSearchQueryDetectionFieldNames()

Field names used for location-based filtering, where geolocation filters are detected in natural language search queries. Only valid when the FilterExtractionCondition is set to ENABLED.

If this field is set, it overrides the field names set in ServingConfig.geo_search_query_detection_field_names.

repeated string geo_search_query_detection_field_names = 2;

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

getAllowedFieldNames(int index)

public String getAllowedFieldNames(int index)

Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.

repeated string allowed_field_names = 4 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
index int

The index of the element to return.

Returns
Type Description
String

The allowedFieldNames at the given index.

getAllowedFieldNamesBytes(int index)

public ByteString getAllowedFieldNamesBytes(int index)

Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.

repeated string allowed_field_names = 4 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
index int

The index of the value to return.

Returns
Type Description
ByteString

The bytes of the allowedFieldNames at the given index.

getAllowedFieldNamesCount()

public int getAllowedFieldNamesCount()

Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.

repeated string allowed_field_names = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
int

The count of allowedFieldNames.

getAllowedFieldNamesList()

public ProtocolStringList getAllowedFieldNamesList()

Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.

repeated string allowed_field_names = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
ProtocolStringList

A list containing the allowedFieldNames.

getDefaultInstanceForType()

public SearchRequest.NaturalLanguageQueryUnderstandingSpec getDefaultInstanceForType()
Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
Type Description
Descriptor
Overrides

getExtractedFilterBehavior()

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.ExtractedFilterBehavior getExtractedFilterBehavior()

Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is HARD_FILTER. For multi-datastore search, the default behavior is SOFT_BOOST. Location-based filters are always applied as hard filters, and the SOFT_BOOST setting will not affect them. This field is only used if SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition is set to FilterExtractionCondition.ENABLED.

.google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec.ExtractedFilterBehavior extracted_filter_behavior = 3 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.ExtractedFilterBehavior

The extractedFilterBehavior.

getExtractedFilterBehaviorValue()

public int getExtractedFilterBehaviorValue()

Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is HARD_FILTER. For multi-datastore search, the default behavior is SOFT_BOOST. Location-based filters are always applied as hard filters, and the SOFT_BOOST setting will not affect them. This field is only used if SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition is set to FilterExtractionCondition.ENABLED.

.google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec.ExtractedFilterBehavior extracted_filter_behavior = 3 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
int

The enum numeric value on the wire for extractedFilterBehavior.

getFilterExtractionCondition()

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition getFilterExtractionCondition()

The condition under which filter extraction should occur. Server behavior defaults to DISABLED.

.google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition filter_extraction_condition = 1;

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition

The filterExtractionCondition.

getFilterExtractionConditionValue()

public int getFilterExtractionConditionValue()

The condition under which filter extraction should occur. Server behavior defaults to DISABLED.

.google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition filter_extraction_condition = 1;

Returns
Type Description
int

The enum numeric value on the wire for filterExtractionCondition.

getGeoSearchQueryDetectionFieldNames(int index)

public String getGeoSearchQueryDetectionFieldNames(int index)

Field names used for location-based filtering, where geolocation filters are detected in natural language search queries. Only valid when the FilterExtractionCondition is set to ENABLED.

If this field is set, it overrides the field names set in ServingConfig.geo_search_query_detection_field_names.

repeated string geo_search_query_detection_field_names = 2;

Parameter
Name Description
index int

The index of the element to return.

Returns
Type Description
String

The geoSearchQueryDetectionFieldNames at the given index.

getGeoSearchQueryDetectionFieldNamesBytes(int index)

public ByteString getGeoSearchQueryDetectionFieldNamesBytes(int index)

Field names used for location-based filtering, where geolocation filters are detected in natural language search queries. Only valid when the FilterExtractionCondition is set to ENABLED.

If this field is set, it overrides the field names set in ServingConfig.geo_search_query_detection_field_names.

repeated string geo_search_query_detection_field_names = 2;

Parameter
Name Description
index int

The index of the value to return.

Returns
Type Description
ByteString

The bytes of the geoSearchQueryDetectionFieldNames at the given index.

getGeoSearchQueryDetectionFieldNamesCount()

public int getGeoSearchQueryDetectionFieldNamesCount()

Field names used for location-based filtering, where geolocation filters are detected in natural language search queries. Only valid when the FilterExtractionCondition is set to ENABLED.

If this field is set, it overrides the field names set in ServingConfig.geo_search_query_detection_field_names.

repeated string geo_search_query_detection_field_names = 2;

Returns
Type Description
int

The count of geoSearchQueryDetectionFieldNames.

getGeoSearchQueryDetectionFieldNamesList()

public ProtocolStringList getGeoSearchQueryDetectionFieldNamesList()

Field names used for location-based filtering, where geolocation filters are detected in natural language search queries. Only valid when the FilterExtractionCondition is set to ENABLED.

If this field is set, it overrides the field names set in ServingConfig.geo_search_query_detection_field_names.

repeated string geo_search_query_detection_field_names = 2;

Returns
Type Description
ProtocolStringList

A list containing the geoSearchQueryDetectionFieldNames.

internalGetFieldAccessorTable()

protected GeneratedMessage.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

mergeFrom(SearchRequest.NaturalLanguageQueryUnderstandingSpec other)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder mergeFrom(SearchRequest.NaturalLanguageQueryUnderstandingSpec other)
Parameter
Name Description
other SearchRequest.NaturalLanguageQueryUnderstandingSpec
Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder
Overrides
Exceptions
Type Description
IOException

mergeFrom(Message other)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder mergeFrom(Message other)
Parameter
Name Description
other Message
Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder
Overrides

setAllowedFieldNames(int index, String value)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder setAllowedFieldNames(int index, String value)

Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.

repeated string allowed_field_names = 4 [(.google.api.field_behavior) = OPTIONAL];

Parameters
Name Description
index int

The index to set the value at.

value String

The allowedFieldNames to set.

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

setExtractedFilterBehavior(SearchRequest.NaturalLanguageQueryUnderstandingSpec.ExtractedFilterBehavior value)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder setExtractedFilterBehavior(SearchRequest.NaturalLanguageQueryUnderstandingSpec.ExtractedFilterBehavior value)

Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is HARD_FILTER. For multi-datastore search, the default behavior is SOFT_BOOST. Location-based filters are always applied as hard filters, and the SOFT_BOOST setting will not affect them. This field is only used if SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition is set to FilterExtractionCondition.ENABLED.

.google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec.ExtractedFilterBehavior extracted_filter_behavior = 3 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value SearchRequest.NaturalLanguageQueryUnderstandingSpec.ExtractedFilterBehavior

The extractedFilterBehavior to set.

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

setExtractedFilterBehaviorValue(int value)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder setExtractedFilterBehaviorValue(int value)

Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is HARD_FILTER. For multi-datastore search, the default behavior is SOFT_BOOST. Location-based filters are always applied as hard filters, and the SOFT_BOOST setting will not affect them. This field is only used if SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition is set to FilterExtractionCondition.ENABLED.

.google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec.ExtractedFilterBehavior extracted_filter_behavior = 3 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value int

The enum numeric value on the wire for extractedFilterBehavior to set.

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

setFilterExtractionCondition(SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition value)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder setFilterExtractionCondition(SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition value)

The condition under which filter extraction should occur. Server behavior defaults to DISABLED.

.google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition filter_extraction_condition = 1;

Parameter
Name Description
value SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition

The filterExtractionCondition to set.

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

setFilterExtractionConditionValue(int value)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder setFilterExtractionConditionValue(int value)

The condition under which filter extraction should occur. Server behavior defaults to DISABLED.

.google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition filter_extraction_condition = 1;

Parameter
Name Description
value int

The enum numeric value on the wire for filterExtractionCondition to set.

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.

setGeoSearchQueryDetectionFieldNames(int index, String value)

public SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder setGeoSearchQueryDetectionFieldNames(int index, String value)

Field names used for location-based filtering, where geolocation filters are detected in natural language search queries. Only valid when the FilterExtractionCondition is set to ENABLED.

If this field is set, it overrides the field names set in ServingConfig.geo_search_query_detection_field_names.

repeated string geo_search_query_detection_field_names = 2;

Parameters
Name Description
index int

The index to set the value at.

value String

The geoSearchQueryDetectionFieldNames to set.

Returns
Type Description
SearchRequest.NaturalLanguageQueryUnderstandingSpec.Builder

This builder for chaining.