Reference documentation and code samples for the Discovery Engine V1BETA API class Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::NaturalLanguageQueryUnderstandingSpec.
Specification to enable natural language understanding capabilities for
search requests.
(::Array<::String>) — 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][google.cloud.discoveryengine.v1beta.ServingConfig.geo_search_query_detection_field_names].
value (::Array<::String>) — 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][google.cloud.discoveryengine.v1beta.ServingConfig.geo_search_query_detection_field_names].
Returns
(::Array<::String>) — 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][google.cloud.discoveryengine.v1beta.ServingConfig.geo_search_query_detection_field_names].
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Discovery Engine V1BETA API - Class Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::NaturalLanguageQueryUnderstandingSpec (v0.21.0)\n\nVersion latestkeyboard_arrow_down\n\n- [0.21.0 (latest)](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/latest/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.20.1](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.20.1/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.19.1](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.19.1/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.18.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.18.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.17.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.17.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.16.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.16.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.15.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.15.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.14.2](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.14.2/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.13.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.13.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.12.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.12.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.11.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.11.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.10.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.10.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.9.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.9.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.8.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.8.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.7.2](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.7.2/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.6.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.6.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.5.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.5.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.4.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.4.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.3.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.3.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.2.1](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.2.1/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec)\n- [0.1.0](/ruby/docs/reference/google-cloud-discovery_engine-v1beta/0.1.0/Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec) \nReference documentation and code samples for the Discovery Engine V1BETA API class Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::NaturalLanguageQueryUnderstandingSpec.\n\nSpecification to enable natural language understanding capabilities for\nsearch requests. \n\nInherits\n--------\n\n- Object \n\nExtended By\n-----------\n\n- Google::Protobuf::MessageExts::ClassMethods \n\nIncludes\n--------\n\n- Google::Protobuf::MessageExts\n\nMethods\n-------\n\n### #filter_extraction_condition\n\n def filter_extraction_condition() -\u003e ::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::NaturalLanguageQueryUnderstandingSpec::FilterExtractionCondition\n\n**Returns**\n\n- ([::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::NaturalLanguageQueryUnderstandingSpec::FilterExtractionCondition](./Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec-FilterExtractionCondition)) --- The condition under which filter extraction should occur. Default to \\[Condition.DISABLED\\]\\[\\].\n\n### #filter_extraction_condition=\n\n def filter_extraction_condition=(value) -\u003e ::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::NaturalLanguageQueryUnderstandingSpec::FilterExtractionCondition\n\n**Parameter**\n\n- **value** ([::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::NaturalLanguageQueryUnderstandingSpec::FilterExtractionCondition](./Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec-FilterExtractionCondition)) --- The condition under which filter extraction should occur. Default to \\[Condition.DISABLED\\]\\[\\]. \n**Returns**\n\n- ([::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::NaturalLanguageQueryUnderstandingSpec::FilterExtractionCondition](./Google-Cloud-DiscoveryEngine-V1beta-SearchRequest-NaturalLanguageQueryUnderstandingSpec-FilterExtractionCondition)) --- The condition under which filter extraction should occur. Default to \\[Condition.DISABLED\\]\\[\\].\n\n### #geo_search_query_detection_field_names\n\n def geo_search_query_detection_field_names() -\u003e ::Array\u003c::String\u003e\n\n**Returns**\n\n- (::Array\\\u003c::String\\\u003e) --- 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`.\n\n\n If this field is set, it overrides the field names set in\n \\[ServingConfig.geo_search_query_detection_field_names\\]\\[google.cloud.discoveryengine.v1beta.ServingConfig.geo_search_query_detection_field_names\\].\n\n### #geo_search_query_detection_field_names=\n\n def geo_search_query_detection_field_names=(value) -\u003e ::Array\u003c::String\u003e\n\n**Parameter**\n\n- **value** (::Array\\\u003c::String\\\u003e) --- 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`.\n\n\n If this field is set, it overrides the field names set in\n\\[ServingConfig.geo_search_query_detection_field_names\\]\\[google.cloud.discoveryengine.v1beta.ServingConfig.geo_search_query_detection_field_names\\]. \n**Returns**\n\n- (::Array\\\u003c::String\\\u003e) --- 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`.\n\n\n If this field is set, it overrides the field names set in\n \\[ServingConfig.geo_search_query_detection_field_names\\]\\[google.cloud.discoveryengine.v1beta.ServingConfig.geo_search_query_detection_field_names\\]."]]