@google-cloud/discoveryengine 2.5.2 → 2.5.3

package/build/protos/google/cloud/discoveryengine/v1/search_service.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -105,6 +105,8 @@ message SearchRequest {
     // Required. Full resource name of
     // [DataStore][google.cloud.discoveryengine.v1.DataStore], such as
     // `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.
+    // The path must include the project number, project id is not supported for
+    // this field.
     string data_store = 1 [
       (google.api.field_behavior) = REQUIRED,
       (google.api.resource_reference) = {
@@ -204,7 +206,6 @@ message SearchRequest {
 
     // List of keys to exclude when faceting.
     //
-    //
     // By default,
     // [FacetKey.key][google.cloud.discoveryengine.v1.SearchRequest.FacetSpec.FacetKey.key]
     // is not excluded from the filter unless it is listed in this field.
@@ -696,6 +697,76 @@ message SearchRequest {
     ChunkSpec chunk_spec = 5;
   }
 
+  // Specification to enable natural language understanding capabilities for
+  // search requests.
+  message NaturalLanguageQueryUnderstandingSpec {
+    // Enum describing under which condition filter extraction should occur.
+    enum FilterExtractionCondition {
+      // Server behavior defaults to `DISABLED`.
+      CONDITION_UNSPECIFIED = 0;
+
+      // Disables NL filter extraction.
+      DISABLED = 1;
+
+      // Enables NL filter extraction.
+      ENABLED = 2;
+    }
+
+    // Enum describing how extracted filters are applied to the search.
+    enum ExtractedFilterBehavior {
+      // `EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED` will use the default behavior
+      // for extracted filters. For single datastore search, the default is to
+      // apply as hard filters. For multi-datastore search, the default is to
+      // apply as soft boosts.
+      EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED = 0;
+
+      // Applies all extracted filters as hard filters on the results. Results
+      // that do not pass the extracted filters will not be returned in the
+      // result set.
+      HARD_FILTER = 1;
+
+      // Applies all extracted filters as soft boosts. Results that pass the
+      // filters will be boosted up to higher ranks in the result set.
+      SOFT_BOOST = 2;
+    }
+
+    // The condition under which filter extraction should occur.
+    // Server behavior defaults to `DISABLED`.
+    FilterExtractionCondition filter_extraction_condition = 1;
+
+    // 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.v1.ServingConfig.geo_search_query_detection_field_names].
+    repeated string geo_search_query_detection_field_names = 2;
+
+    // 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][google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition]
+    // is set to
+    // [FilterExtractionCondition.ENABLED][google.cloud.discoveryengine.v1.SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition.ENABLED].
+    ExtractedFilterBehavior extracted_filter_behavior = 3
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // 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];
+  }
+
   // Specification for search as you type in search requests.
   message SearchAsYouTypeSpec {
     // Enum describing under which condition search as you type should occur.
@@ -739,6 +810,42 @@ message SearchRequest {
     MatchHighlightingCondition match_highlighting_condition = 1;
   }
 
+  // Specification for crowding. Crowding improves the diversity of search
+  // results by limiting the number of results that share the same field value.
+  // For example, crowding on the color field with a max_count of 3 and mode
+  // DROP_CROWDED_RESULTS will return at most 3 results with the same color
+  // across all pages.
+  message CrowdingSpec {
+    // Enum describing the mode to use for documents that are crowded away.
+    // They can be dropped or demoted to the later pages.
+    enum Mode {
+      // Unspecified crowding mode. In this case, server behavior defaults to
+      // [Mode.DROP_CROWDED_RESULTS][google.cloud.discoveryengine.v1.SearchRequest.CrowdingSpec.Mode.DROP_CROWDED_RESULTS].
+      MODE_UNSPECIFIED = 0;
+
+      // Drop crowded results.
+      DROP_CROWDED_RESULTS = 1;
+
+      // Demote crowded results to the later pages.
+      DEMOTE_CROWDED_RESULTS_TO_END = 2;
+    }
+
+    // The field to use for crowding. Documents can be crowded by a field in the
+    // [Document][google.cloud.discoveryengine.v1.Document] object. Crowding
+    // field is case sensitive.
+    string field = 1;
+
+    // The maximum number of documents to keep per value of the field. Once
+    // there are at least max_count previous results which contain the same
+    // value for the given field (according to the order specified in
+    // `order_by`), later results with the same value are "crowded away".
+    // If not specified, the default value is 1.
+    int32 max_count = 2;
+
+    // Mode to use for documents that are crowded away.
+    Mode mode = 3;
+  }
+
   // Session specification.
   //
   // Multi-turn Search feature is currently at private GA stage. Please use
@@ -789,6 +896,30 @@ message SearchRequest {
     bool return_relevance_score = 1 [(google.api.field_behavior) = OPTIONAL];
   }
 
+  // The backend to use for the ranking expression evaluation.
+  enum RankingExpressionBackend {
+    // Default option for unspecified/unknown values.
+    RANKING_EXPRESSION_BACKEND_UNSPECIFIED = 0;
+
+    // Deprecated: Use `RANK_BY_EMBEDDING` instead.
+    // Ranking by custom embedding model, the default way to evaluate the
+    // ranking expression. Legacy enum option, `RANK_BY_EMBEDDING` should be
+    // used instead.
+    BYOE = 1 [deprecated = true];
+
+    // Deprecated: Use `RANK_BY_FORMULA` instead.
+    // Ranking by custom formula. Legacy enum option, `RANK_BY_FORMULA` should
+    // be used instead.
+    CLEARBOX = 2 [deprecated = true];
+
+    // Ranking by custom embedding model, the default way to evaluate the
+    // ranking expression.
+    RANK_BY_EMBEDDING = 3;
+
+    // Ranking by custom formula.
+    RANK_BY_FORMULA = 4;
+  }
+
   // The relevance threshold of the search results. The higher relevance
   // threshold is, the higher relevant results are shown and the less number of
   // results are returned.
@@ -835,6 +966,25 @@ message SearchRequest {
   // Raw search query.
   string query = 3;
 
+  // Optional. The categories associated with a category page. Must be set for
+  // category navigation queries to achieve good search quality. The format
+  // should be the same as
+  // [PageInfo.page_category][google.cloud.discoveryengine.v1.PageInfo.page_category].
+  // This field is the equivalent of the query for browse (navigation) queries.
+  // It's used by the browse model when the query is empty.
+  //
+  // If the field is empty, it will not be used by the browse model.
+  // If the field contains more than one element, only the first element will
+  // be used.
+  //
+  // To represent full path of a category, use '>' character to separate
+  // different hierarchies. If '>' is part of the category name, replace it with
+  // other character(s).
+  // For example, `Graphics Cards > RTX>4090 > Founders Edition` where "RTX >
+  // 4090" represents one level, can be rewritten as `Graphics Cards > RTX_4090
+  // > Founders Edition`
+  repeated string page_categories = 63 [(google.api.field_behavior) = OPTIONAL];
+
   // Raw image query.
   ImageQuery image_query = 19;
 
@@ -867,6 +1017,8 @@ message SearchRequest {
   // unset.
   //
   // If this field is negative, an  `INVALID_ARGUMENT`  is returned.
+  //
+  // A large offset may be capped to a reasonable threshold.
   int32 offset = 6;
 
   // The maximum number of results to return for OneBox.
@@ -977,10 +1129,10 @@ message SearchRequest {
   // which spell correction takes effect.
   SpellCorrectionSpec spell_correction_spec = 14;
 
-  // A unique identifier for tracking visitors. For example, this could be
-  // implemented with an HTTP cookie, which should be able to uniquely identify
-  // a visitor on a single device. This unique identifier should not change if
-  // the visitor logs in or out of the website.
+  // Optional. A unique identifier for tracking visitors. For example, this
+  // could be implemented with an HTTP cookie, which should be able to uniquely
+  // identify a visitor on a single device. This unique identifier should not
+  // change if the visitor logs in or out of the website.
   //
   // This field should NOT have a fixed value such as `unknown_visitor`.
   //
@@ -991,87 +1143,13 @@ message SearchRequest {
   //
   // The field must be a UTF-8 encoded string with a length limit of 128
   // characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
-  string user_pseudo_id = 15;
+  string user_pseudo_id = 15 [(google.api.field_behavior) = OPTIONAL];
 
   // A specification for configuring the behavior of content search.
   ContentSearchSpec content_search_spec = 24;
 
-  // Whether to turn on safe search. This is only supported for
-  // website search.
-  bool safe_search = 20;
-
-  // The user labels applied to a resource must meet the following requirements:
-  //
-  // * Each resource can have multiple labels, up to a maximum of 64.
-  // * Each label must be a key-value pair.
-  // * Keys have a minimum length of 1 character and a maximum length of 63
-  //   characters and cannot be empty. Values can be empty and have a maximum
-  //   length of 63 characters.
-  // * Keys and values can contain only lowercase letters, numeric characters,
-  //   underscores, and dashes. All characters must use UTF-8 encoding, and
-  //   international characters are allowed.
-  // * The key portion of a label must be unique. However, you can use the same
-  //   key with multiple resources.
-  // * Keys must start with a lowercase letter or international character.
-  //
-  // See [Google Cloud
-  // Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
-  // for more details.
-  map<string, string> user_labels = 22;
-
-  // Search as you type configuration. Only supported for the
-  // [IndustryVertical.MEDIA][google.cloud.discoveryengine.v1.IndustryVertical.MEDIA]
-  // vertical.
-  SearchAsYouTypeSpec search_as_you_type_spec = 31;
-
-  // Optional. Config for display feature, like match highlighting on search
-  // results.
-  DisplaySpec display_spec = 38 [(google.api.field_behavior) = OPTIONAL];
-
-  // The session resource name. Optional.
-  //
-  // Session allows users to do multi-turn /search API calls or coordination
-  // between /search API calls and /answer API calls.
-  //
-  // Example #1 (multi-turn /search API calls):
-  //   Call /search API with the session ID generated in the first call.
-  //   Here, the previous search query gets considered in query
-  //   standing. I.e., if the first query is "How did Alphabet do in 2022?"
-  //   and the current query is "How about 2023?", the current query will
-  //   be interpreted as "How did Alphabet do in 2023?".
-  //
-  // Example #2 (coordination between /search API calls and /answer API calls):
-  //   Call /answer API with the session ID generated in the first call.
-  //   Here, the answer generation happens in the context of the search
-  //   results from the first search call.
-  //
-  // Multi-turn Search feature is currently at private GA stage. Please use
-  // v1alpha or v1beta version instead before we launch this feature to public
-  // GA. Or ask for allowlisting through Google Support team.
-  string session = 41 [(google.api.resource_reference) = {
-    type: "discoveryengine.googleapis.com/Session"
-  }];
-
-  // Session specification.
-  //
-  // Can be used only when `session` is set.
-  SessionSpec session_spec = 42;
-
-  // The relevance threshold of the search results.
-  //
-  // Default to Google defined threshold, leveraging a balance of
-  // precision and recall to deliver both highly accurate results and
-  // comprehensive coverage of relevant information.
-  //
-  // This feature is not supported for healthcare search.
-  RelevanceThreshold relevance_threshold = 44;
-
-  // Optional. The specification for returning the relevance score.
-  RelevanceScoreSpec relevance_score_spec = 52
-      [(google.api.field_behavior) = OPTIONAL];
-
-  // The ranking expression controls the customized ranking on retrieval
-  // documents. This overrides
+  // Optional. The ranking expression controls the customized ranking on
+  // retrieval documents. This overrides
   // [ServingConfig.ranking_expression][google.cloud.discoveryengine.v1.ServingConfig.ranking_expression].
   // The syntax and supported features depend on the
   // `ranking_expression_backend` value. If `ranking_expression_backend` is not
@@ -1160,23 +1238,109 @@ message SearchRequest {
   //   Google model to determine the keyword-based overlap between the query and
   //   the document.
   //   * `base_rank`: the default rank of the result
-  string ranking_expression = 26;
+  string ranking_expression = 26 [(google.api.field_behavior) = OPTIONAL];
 
-  // The backend to use for the ranking expression evaluation.
-  enum RankingExpressionBackend {
-    reserved 1, 2;
+  // Optional. The backend to use for the ranking expression evaluation.
+  RankingExpressionBackend ranking_expression_backend = 53
+      [(google.api.field_behavior) = OPTIONAL];
 
-    // Default option for unspecified/unknown values.
-    RANKING_EXPRESSION_BACKEND_UNSPECIFIED = 0;
-    // Ranking by custom embedding model, the default way to evaluate the
-    // ranking expression.
-    RANK_BY_EMBEDDING = 3;
-    // Ranking by custom formula.
-    RANK_BY_FORMULA = 4;
-  }
+  // Whether to turn on safe search. This is only supported for
+  // website search.
+  bool safe_search = 20;
 
-  // The backend to use for the ranking expression evaluation.
-  RankingExpressionBackend ranking_expression_backend = 53
+  // The user labels applied to a resource must meet the following requirements:
+  //
+  // * Each resource can have multiple labels, up to a maximum of 64.
+  // * Each label must be a key-value pair.
+  // * Keys have a minimum length of 1 character and a maximum length of 63
+  //   characters and cannot be empty. Values can be empty and have a maximum
+  //   length of 63 characters.
+  // * Keys and values can contain only lowercase letters, numeric characters,
+  //   underscores, and dashes. All characters must use UTF-8 encoding, and
+  //   international characters are allowed.
+  // * The key portion of a label must be unique. However, you can use the same
+  //   key with multiple resources.
+  // * Keys must start with a lowercase letter or international character.
+  //
+  // See [Google Cloud
+  // Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
+  // for more details.
+  map<string, string> user_labels = 22;
+
+  // Optional. Config for natural language query understanding capabilities,
+  // such as extracting structured field filters from the query. Refer to [this
+  // documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries)
+  // for more information.
+  // If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional
+  // natural language query understanding will be done.
+  NaturalLanguageQueryUnderstandingSpec
+      natural_language_query_understanding_spec = 28
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Search as you type configuration. Only supported for the
+  // [IndustryVertical.MEDIA][google.cloud.discoveryengine.v1.IndustryVertical.MEDIA]
+  // vertical.
+  SearchAsYouTypeSpec search_as_you_type_spec = 31;
+
+  // Optional. Config for display feature, like match highlighting on search
+  // results.
+  DisplaySpec display_spec = 38 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Crowding specifications for improving result diversity.
+  // If multiple CrowdingSpecs are specified, crowding will be evaluated on
+  // each unique combination of the `field` values, and max_count will be the
+  // maximum value of `max_count` across all CrowdingSpecs.
+  // For example, if the first CrowdingSpec has `field` = "color" and
+  // `max_count` = 3, and the second CrowdingSpec has `field` = "size" and
+  // `max_count` = 2, then after 3 documents that share the same color AND size
+  // have been returned, subsequent ones should be
+  // removed or demoted.
+  repeated CrowdingSpec crowding_specs = 40
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // The session resource name. Optional.
+  //
+  // Session allows users to do multi-turn /search API calls or coordination
+  // between /search API calls and /answer API calls.
+  //
+  // Example #1 (multi-turn /search API calls):
+  //   Call /search API with the session ID generated in the first call.
+  //   Here, the previous search query gets considered in query
+  //   standing. I.e., if the first query is "How did Alphabet do in 2022?"
+  //   and the current query is "How about 2023?", the current query will
+  //   be interpreted as "How did Alphabet do in 2023?".
+  //
+  // Example #2 (coordination between /search API calls and /answer API calls):
+  //   Call /answer API with the session ID generated in the first call.
+  //   Here, the answer generation happens in the context of the search
+  //   results from the first search call.
+  //
+  // Multi-turn Search feature is currently at private GA stage. Please use
+  // v1alpha or v1beta version instead before we launch this feature to public
+  // GA. Or ask for allowlisting through Google Support team.
+  string session = 41 [(google.api.resource_reference) = {
+    type: "discoveryengine.googleapis.com/Session"
+  }];
+
+  // Session specification.
+  //
+  // Can be used only when `session` is set.
+  SessionSpec session_spec = 42;
+
+  // The global relevance threshold of the search results.
+  //
+  // Defaults to Google defined threshold, leveraging a balance of
+  // precision and recall to deliver both highly accurate results and
+  // comprehensive coverage of relevant information.
+  //
+  // If more granular relevance filtering is required, use the
+  // `relevance_filter_spec` instead.
+  //
+  // This feature is not supported for healthcare search.
+  RelevanceThreshold relevance_threshold = 44;
+
+  // Optional. The specification for returning the relevance score.
+  RelevanceScoreSpec relevance_score_spec = 52
       [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -1186,65 +1350,71 @@ message SearchRequest {
 message SearchResponse {
   // Represents the search results.
   message SearchResult {
-    // [Document.id][google.cloud.discoveryengine.v1.Document.id] of the
-    // searched [Document][google.cloud.discoveryengine.v1.Document].
-    string id = 1;
-
-    // The document data snippet in the search response. Only fields that are
-    // marked as `retrievable` are populated.
-    Document document = 2;
-
-    // The chunk data in the search response if the
-    // [SearchRequest.ContentSearchSpec.search_result_mode][google.cloud.discoveryengine.v1.SearchRequest.ContentSearchSpec.search_result_mode]
-    // is set to
-    // [CHUNKS][google.cloud.discoveryengine.v1.SearchRequest.ContentSearchSpec.SearchResultMode.CHUNKS].
-    Chunk chunk = 18;
-
-    // Output only. Google provided available scores.
-    map<string, DoubleList> model_scores = 4
-        [(google.api.field_behavior) = OUTPUT_ONLY];
-
     // A set of ranking signals.
     message RankSignals {
-      reserved 5;
+      // Custom clearbox signal represented by name and value pair.
+      message CustomSignal {
+        // Optional. Name of the signal.
+        string name = 1 [(google.api.field_behavior) = OPTIONAL];
 
-      // Keyword matching adjustment.
+        // Optional. Float value representing the ranking signal (e.g. 1.25 for
+        // BM25).
+        float value = 2 [(google.api.field_behavior) = OPTIONAL];
+      }
+
+      // Optional. Keyword matching adjustment.
       optional float keyword_similarity_score = 1
           [(google.api.field_behavior) = OPTIONAL];
-      // Semantic relevance adjustment.
+
+      // Optional. Semantic relevance adjustment.
       optional float relevance_score = 2
           [(google.api.field_behavior) = OPTIONAL];
-      // Semantic similarity adjustment.
+
+      // Optional. Semantic similarity adjustment.
       optional float semantic_similarity_score = 3
           [(google.api.field_behavior) = OPTIONAL];
-      // Predicted conversion rate adjustment as a rank.
+
+      // Optional. Predicted conversion rate adjustment as a rank.
       optional float pctr_rank = 4 [(google.api.field_behavior) = OPTIONAL];
-      // Topicality adjustment as a rank.
+
+      // Optional. Topicality adjustment as a rank.
       optional float topicality_rank = 6
           [(google.api.field_behavior) = OPTIONAL];
-      // Age of the document in hours.
+
+      // Optional. Age of the document in hours.
       optional float document_age = 7 [(google.api.field_behavior) = OPTIONAL];
-      // Combined custom boosts for a doc.
+
+      // Optional. Combined custom boosts for a doc.
       optional float boosting_factor = 8
           [(google.api.field_behavior) = OPTIONAL];
 
-      // The default rank of the result.
+      // Optional. The default rank of the result.
       float default_rank = 32 [(google.api.field_behavior) = OPTIONAL];
 
-      // Custom clearbox signal represented by name and value pair.
-      message CustomSignal {
-        // Name of the signal.
-        string name = 1 [(google.api.field_behavior) = OPTIONAL];
-        // Float value representing the ranking signal (e.g. 1.25 for BM25).
-        float value = 2 [(google.api.field_behavior) = OPTIONAL];
-      }
-
-      // A list of custom clearbox signals.
+      // Optional. A list of custom clearbox signals.
       repeated CustomSignal custom_signals = 33
           [(google.api.field_behavior) = OPTIONAL];
     }
 
-    // A set of ranking signals associated with the result.
+    // [Document.id][google.cloud.discoveryengine.v1.Document.id] of the
+    // searched [Document][google.cloud.discoveryengine.v1.Document].
+    string id = 1;
+
+    // The document data snippet in the search response. Only fields that are
+    // marked as `retrievable` are populated.
+    Document document = 2;
+
+    // The chunk data in the search response if the
+    // [SearchRequest.ContentSearchSpec.search_result_mode][google.cloud.discoveryengine.v1.SearchRequest.ContentSearchSpec.search_result_mode]
+    // is set to
+    // [CHUNKS][google.cloud.discoveryengine.v1.SearchRequest.ContentSearchSpec.SearchResultMode.CHUNKS].
+    Chunk chunk = 18;
+
+    // Output only. Google provided available scores.
+    map<string, DoubleList> model_scores = 4
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Optional. A set of ranking signals associated with the result.
     RankSignals rank_signals = 7 [(google.api.field_behavior) = OPTIONAL];
   }
 
@@ -1461,6 +1631,140 @@ message SearchResponse {
     int64 pinned_result_count = 2;
   }
 
+  // Information describing what natural language understanding was
+  // done on the input query.
+  message NaturalLanguageQueryUnderstandingInfo {
+    // The filters that were extracted from the input query represented in a
+    // structured form.
+    message StructuredExtractedFilter {
+      // Constraint expression of a string field.
+      message StringConstraint {
+        // Name of the string field as defined in the schema.
+        string field_name = 1;
+
+        // Values of the string field. The record will only be returned if the
+        // field value matches one of the values specified here.
+        repeated string values = 2;
+
+        // Identifies the keywords within the search query that match a filter.
+        string query_segment = 3;
+      }
+
+      // Constraint expression of a number field. Example: price < 100.
+      message NumberConstraint {
+        // The comparison operation that was performed.
+        enum Comparison {
+          // Undefined comparison operator.
+          COMPARISON_UNSPECIFIED = 0;
+
+          // Denotes equality `=` operator.
+          EQUALS = 1;
+
+          // Denotes less than or equal to `<=` operator.
+          LESS_THAN_EQUALS = 2;
+
+          // Denotes less than `<` operator.
+          LESS_THAN = 3;
+
+          // Denotes greater than or equal to `>=` operator.
+          GREATER_THAN_EQUALS = 4;
+
+          // Denotes greater than `>` operator.
+          GREATER_THAN = 5;
+        }
+
+        // Name of the numerical field as defined in the schema.
+        string field_name = 1;
+
+        // The comparison operation performed between the field value and the
+        // value specified in the constraint.
+        Comparison comparison = 2;
+
+        // The value specified in the numerical constraint.
+        double value = 3;
+
+        // Identifies the keywords within the search query that match a filter.
+        string query_segment = 4;
+      }
+
+      // Constraint of a geolocation field.
+      // Name of the geolocation field as defined in the schema.
+      message GeolocationConstraint {
+        // The name of the geolocation field as defined in the schema.
+        string field_name = 1;
+
+        // The reference address that was inferred from the input query. The
+        // proximity of the reference address to the geolocation field will be
+        // used to filter the results.
+        string address = 2;
+
+        // The latitude of the geolocation inferred from the input query.
+        double latitude = 4;
+
+        // The longitude of the geolocation inferred from the input query.
+        double longitude = 5;
+
+        // The radius in meters around the address. The record is returned if
+        // the location of the geolocation field is within the radius.
+        float radius_in_meters = 3;
+      }
+
+      // Logical `And` operator.
+      message AndExpression {
+        // The expressions that were ANDed together.
+        repeated Expression expressions = 1;
+      }
+
+      // Logical `Or` operator.
+      message OrExpression {
+        // The expressions that were ORed together.
+        repeated Expression expressions = 1;
+      }
+
+      // The expression denoting the filter that was extracted from the input
+      // query.
+      message Expression {
+        // The expression type.
+        oneof expr {
+          // String constraint expression.
+          StringConstraint string_constraint = 1;
+
+          // Numerical constraint expression.
+          NumberConstraint number_constraint = 2;
+
+          // Geolocation constraint expression.
+          GeolocationConstraint geolocation_constraint = 3;
+
+          // Logical "And" compound operator connecting multiple expressions.
+          AndExpression and_expr = 4;
+
+          // Logical "Or" compound operator connecting multiple expressions.
+          OrExpression or_expr = 5;
+        }
+      }
+
+      // The expression denoting the filter that was extracted from the input
+      // query in a structured form. It can be a simple expression denoting a
+      // single string, numerical or geolocation constraint or a compound
+      // expression which is a combination of multiple expressions connected
+      // using logical (OR and AND) operators.
+      Expression expression = 1;
+    }
+
+    // The filters that were extracted from the input query.
+    string extracted_filters = 1;
+
+    // Rewritten input query minus the extracted filters.
+    string rewritten_query = 2;
+
+    // The classified intents from the input query.
+    repeated string classified_intents = 5;
+
+    // The filters that were extracted from the input query represented in a
+    // structured form.
+    StructuredExtractedFilter structured_extracted_filter = 3;
+  }
+
   // Information about the session.
   message SessionInfo {
     // Name of the session.
@@ -1478,6 +1782,18 @@ message SearchResponse {
     string query_id = 2;
   }
 
+  // Semantic state of the search response.
+  enum SemanticState {
+    // Default value. Should not be used.
+    SEMANTIC_STATE_UNSPECIFIED = 0;
+
+    // Semantic search was disabled for this search response.
+    DISABLED = 1;
+
+    // Semantic search was enabled for this search response.
+    ENABLED = 2;
+  }
+
   // A list of matched documents. The order represents the ranking.
   repeated SearchResult results = 1;
 
@@ -1526,6 +1842,12 @@ message SearchResponse {
   // Query expansion information for the returned results.
   QueryExpansionInfo query_expansion_info = 14;
 
+  // Output only. Natural language query understanding information for the
+  // returned results.
+  NaturalLanguageQueryUnderstandingInfo
+      natural_language_query_understanding_info = 15
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
   // Session information.
   //
   // Only set if
@@ -1535,4 +1857,7 @@ message SearchResponse {
 
   // Promotions for site search.
   repeated SearchLinkPromotion search_link_promotions = 23;
+
+  // Output only. Indicates the semantic state of the search response.
+  SemanticState semantic_state = 36 [(google.api.field_behavior) = OUTPUT_ONLY];
 }