google-cloud-discovery_engine-v1 2.0.0 → 2.1.0

data/proto_docs/google/cloud/discoveryengine/v1/document_service.rb

@@ -124,7 +124,7 @@ module Google
         #     Otherwise, an `ALREADY_EXISTS` error is returned.
         #
         #     This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034)
-        #     standard with a length limit of 63 characters. Otherwise, an
+        #     standard with a length limit of 128 characters. Otherwise, an
         #     `INVALID_ARGUMENT` error is returned.
         class CreateDocumentRequest
           include ::Google::Protobuf::MessageExts

data/proto_docs/google/cloud/discoveryengine/v1/engine.rb

@@ -91,9 +91,8 @@ module Google
         #   @return [::Google::Cloud::DiscoveryEngine::V1::IndustryVertical]
         #     The industry vertical that the engine registers.
         #     The restriction of the Engine industry vertical is based on
-        #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}: If unspecified,
-        #     default to `GENERIC`. Vertical on Engine has to match vertical of the
-        #     DataStore linked to the engine.
+        #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}: Vertical on Engine
+        #     has to match vertical of the DataStore linked to the engine.
         # @!attribute [rw] common_config
         #   @return [::Google::Cloud::DiscoveryEngine::V1::Engine::CommonConfig]
         #     Common config spec that specifies the metadata of the engine.
@@ -153,6 +152,20 @@ module Google
           #     API after engine creation. Use
           #     {::Google::Cloud::DiscoveryEngine::V1::Engine::ChatEngineMetadata#dialogflow_agent ChatEngineMetadata.dialogflow_agent}
           #     for actual agent association after Engine is created.
+          # @!attribute [rw] allow_cross_region
+          #   @return [::Boolean]
+          #     Optional. If the flag set to true, we allow the agent and engine are in
+          #     different locations, otherwise the agent and engine are required to be in
+          #     the same location. The flag is set to false by default.
+          #
+          #     Note that the `allow_cross_region` are one-time consumed by and
+          #     passed to
+          #     {::Google::Cloud::DiscoveryEngine::V1::EngineService::Client#create_engine EngineService.CreateEngine}.
+          #     It means they cannot be retrieved using
+          #     {::Google::Cloud::DiscoveryEngine::V1::EngineService::Client#get_engine EngineService.GetEngine}
+          #     or
+          #     {::Google::Cloud::DiscoveryEngine::V1::EngineService::Client#list_engines EngineService.ListEngines}
+          #     API after engine creation.
           class ChatEngineConfig
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/discoveryengine/v1/grounded_generation_service.rb

@@ -65,8 +65,6 @@ module Google
         #     For single-turn queries, this is a single instance. For multi-turn queries,
         #     this is a repeated field that contains conversation history + latest
         #     request.
-        #
-        #     Only a single-turn query is supported currently.
         # @!attribute [rw] generation_spec
         #   @return [::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentRequest::GenerationSpec]
         #     Content generation specification.
@@ -116,6 +114,9 @@ module Google
           # @!attribute [rw] frequency_penalty
           #   @return [::Float]
           #     If specified, custom value for frequency penalty will be used.
+          # @!attribute [rw] seed
+          #   @return [::Integer]
+          #     If specified, custom value for the seed will be used.
           # @!attribute [rw] presence_penalty
           #   @return [::Float]
           #     If specified, custom value for presence penalty will be used.
@@ -163,17 +164,22 @@ module Google
           #   @return [::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentRequest::GroundingSource::InlineSource]
           #     If set, grounding is performed with inline content.
           #
-          #     Note: The following fields are mutually exclusive: `inline_source`, `search_source`, `google_search_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `inline_source`, `search_source`, `google_search_source`, `enterprise_web_retrieval_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] search_source
           #   @return [::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentRequest::GroundingSource::SearchSource]
           #     If set, grounding is performed with Vertex AI Search.
           #
-          #     Note: The following fields are mutually exclusive: `search_source`, `inline_source`, `google_search_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `search_source`, `inline_source`, `google_search_source`, `enterprise_web_retrieval_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] google_search_source
           #   @return [::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentRequest::GroundingSource::GoogleSearchSource]
           #     If set, grounding is performed with Google Search.
           #
-          #     Note: The following fields are mutually exclusive: `google_search_source`, `inline_source`, `search_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `google_search_source`, `inline_source`, `search_source`, `enterprise_web_retrieval_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] enterprise_web_retrieval_source
+          #   @return [::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentRequest::GroundingSource::EnterpriseWebRetrievalSource]
+          #     If set, grounding is performed with enterprise web retrieval.
+          #
+          #     Note: The following fields are mutually exclusive: `enterprise_web_retrieval_source`, `inline_source`, `search_source`, `google_search_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class GroundingSource
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -237,6 +243,12 @@ module Google
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
+
+            # Params for using enterprise web retrieval as grounding source.
+            class EnterpriseWebRetrievalSource
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
 
           # Grounding specification.
@@ -258,6 +270,7 @@ module Google
           end
         end
 
+        # Response for the `GenerateGroundedContent` method.
         # @!attribute [rw] candidates
         #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentResponse::Candidate>]
         #     Generated candidates.
@@ -304,6 +317,9 @@ module Google
             #     GroundingSupport across all claims in the answer candidate.
             #     An support to a fact indicates that the claim is supported by
             #     the fact.
+            # @!attribute [rw] images
+            #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentResponse::Candidate::GroundingMetadata::ImageMetadata>]
+            #     Images from the web search.
             class GroundingMetadata
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -406,6 +422,48 @@ module Google
                 include ::Google::Protobuf::MessageExts
                 extend ::Google::Protobuf::MessageExts::ClassMethods
               end
+
+              # Metadata about an image from the web search.
+              # @!attribute [rw] image
+              #   @return [::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentResponse::Candidate::GroundingMetadata::ImageMetadata::Image]
+              #     Metadata about the full size image.
+              # @!attribute [rw] thumbnail
+              #   @return [::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentResponse::Candidate::GroundingMetadata::ImageMetadata::Image]
+              #     Metadata about the thumbnail.
+              # @!attribute [rw] source
+              #   @return [::Google::Cloud::DiscoveryEngine::V1::GenerateGroundedContentResponse::Candidate::GroundingMetadata::ImageMetadata::WebsiteInfo]
+              #     The details about the website that the image is from.
+              class ImageMetadata
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+
+                # Metadata about the website that the image is from.
+                # @!attribute [rw] uri
+                #   @return [::String]
+                #     The url of the website.
+                # @!attribute [rw] title
+                #   @return [::String]
+                #     The title of the website.
+                class WebsiteInfo
+                  include ::Google::Protobuf::MessageExts
+                  extend ::Google::Protobuf::MessageExts::ClassMethods
+                end
+
+                # Metadata about the image.
+                # @!attribute [rw] uri
+                #   @return [::String]
+                #     The url of the image.
+                # @!attribute [rw] width
+                #   @return [::Integer]
+                #     The width of the image in pixels.
+                # @!attribute [rw] height
+                #   @return [::Integer]
+                #     The height of the image in pixels.
+                class Image
+                  include ::Google::Protobuf::MessageExts
+                  extend ::Google::Protobuf::MessageExts::ClassMethods
+                end
+              end
             end
           end
         end
@@ -432,7 +490,7 @@ module Google
         #     `projects/*/locations/global/groundingConfigs/default_grounding_config`.
         # @!attribute [rw] answer_candidate
         #   @return [::String]
-        #     Answer candidate to check. Can have a maximum length of 1024 characters.
+        #     Answer candidate to check. It can have a maximum length of 4096 tokens.
         # @!attribute [rw] facts
         #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::GroundingFact>]
         #     List of facts for the grounding check.
@@ -485,6 +543,10 @@ module Google
         #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::FactChunk>]
         #     List of facts cited across all claims in the answer candidate.
         #     These are derived from the facts supplied in the request.
+        # @!attribute [rw] cited_facts
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::CheckGroundingResponse::CheckGroundingFactChunk>]
+        #     List of facts cited across all claims in the answer candidate.
+        #     These are derived from the facts supplied in the request.
         # @!attribute [rw] claims
         #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::CheckGroundingResponse::Claim>]
         #     Claim texts and citation info across all claims in the answer candidate.
@@ -492,15 +554,34 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
+          # Fact chunk for grounding check.
+          # @!attribute [rw] chunk_text
+          #   @return [::String]
+          #     Text content of the fact chunk. Can be at most 10K characters long.
+          class CheckGroundingFactChunk
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Text and citation info for a claim in the answer candidate.
           # @!attribute [rw] start_pos
           #   @return [::Integer]
           #     Position indicating the start of the claim in the answer candidate,
-          #     measured in bytes.
+          #     measured in bytes. Note that this is not measured in characters and,
+          #     therefore, must be rendered in the user interface keeping in mind that
+          #     some characters may take more than one byte. For example,
+          #     if the claim text contains non-ASCII characters, the start and end
+          #     positions vary when measured in characters
+          #     (programming-language-dependent) and when measured in bytes
+          #     (programming-language-independent).
           # @!attribute [rw] end_pos
           #   @return [::Integer]
           #     Position indicating the end of the claim in the answer candidate,
-          #     exclusive.
+          #     exclusive, in bytes. Note that this is not measured in characters and,
+          #     therefore, must be rendered as such. For example, if the claim text
+          #     contains non-ASCII characters, the start and end positions vary when
+          #     measured in characters (programming-language-dependent) and when measured
+          #     in bytes (programming-language-independent).
           # @!attribute [rw] claim_text
           #   @return [::String]
           #     Text for the claim in the answer candidate. Always provided regardless of
@@ -518,10 +599,7 @@ module Google
           #     decided this claim doesn't require attribution/grounding check, this
           #     field will be set to false. In that case, no grounding check was done for
           #     the claim and therefore
-          #     {::Google::Cloud::DiscoveryEngine::V1::CheckGroundingResponse::Claim#citation_indices citation_indices},
-          #     [anti_citation_indices][google.cloud.discoveryengine.v1.CheckGroundingResponse.Claim.anti_citation_indices],
-          #     and
-          #     [score][google.cloud.discoveryengine.v1.CheckGroundingResponse.Claim.score]
+          #     {::Google::Cloud::DiscoveryEngine::V1::CheckGroundingResponse::Claim#citation_indices citation_indices}
           #     should not be returned.
           class Claim
             include ::Google::Protobuf::MessageExts

data/proto_docs/google/cloud/discoveryengine/v1/import_config.rb

@@ -224,7 +224,7 @@ module Google
           # The type of values in a Bigtable column or column family.
           # The values are expected to be encoded using
           # [HBase
-          # Bytes.toBytes](https://hbase.apache.org/apidocs/org/apache/hadoop/hbase/util/Bytes.html)
+          # Bytes.toBytes](https://hbase.apache.org/1.4/apidocs/org/apache/hadoop/hbase/util/Bytes.html)
           # function when the encoding value is set to `BINARY`.
           module Type
             # The type is unspecified.
@@ -303,6 +303,17 @@ module Google
         #     all [supported FHIR resource
         #     types](https://cloud.google.com/generative-ai-app-builder/docs/fhir-schema-reference#resource-level-specification).
         #     Default to all supported FHIR resource types if empty.
+        # @!attribute [rw] update_from_latest_predefined_schema
+        #   @return [::Boolean]
+        #     Optional. Whether to update the DataStore schema to the latest predefined
+        #     schema.
+        #
+        #     If true, the DataStore schema will be updated to include any FHIR fields
+        #     or resource types that have been added since the last import and
+        #     corresponding FHIR resources will be imported from the FHIR store.
+        #
+        #     Note this field cannot be used in conjunction with `resource_types`. It
+        #     should be used after initial import.
         class FhirStoreSource
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -647,6 +658,13 @@ module Google
         #     * {::Google::Cloud::DiscoveryEngine::V1::CloudSqlSource CloudSqlSource}.
         #     * {::Google::Cloud::DiscoveryEngine::V1::FirestoreSource FirestoreSource}.
         #     * {::Google::Cloud::DiscoveryEngine::V1::BigtableSource BigtableSource}.
+        # @!attribute [rw] force_refresh_content
+        #   @return [::Boolean]
+        #     Optional. Whether to force refresh the unstructured content of the
+        #     documents.
+        #
+        #     If set to `true`, the content part of the documents will be refreshed
+        #     regardless of the update status of the referencing content.
         class ImportDocumentsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/discoveryengine/v1/purge_config.rb

@@ -41,16 +41,20 @@ module Google
         #     * `userId`: Double quoted string. Specifying this will delete all events
         #       associated with a user.
         #
+        #     Note: This API only supports purging a max range of 30 days.
+        #
         #     Examples:
         #
         #     * Deleting all events in a time range:
         #       `eventTime > "2012-04-23T18:25:43.511Z"
         #       eventTime < "2012-04-23T18:30:43.511Z"`
-        #     * Deleting specific eventType:
-        #       `eventType = "search"`
-        #     * Deleting all events for a specific visitor:
-        #       `userPseudoId = "visitor1024"`
-        #     * Deleting all events inside a DataStore:
+        #     * Deleting specific eventType in a time range:
+        #       `eventTime > "2012-04-23T18:25:43.511Z"
+        #       eventTime < "2012-04-23T18:30:43.511Z" eventType = "search"`
+        #     * Deleting all events for a specific visitor in a time range:
+        #       `eventTime > "2012-04-23T18:25:43.511Z"
+        #       eventTime < "2012-04-23T18:30:43.511Z" userPseudoId = "visitor1024"`
+        #     * Deleting the past 30 days of events inside a DataStore:
         #       `*`
         #
         #     The filtering fields are assumed to have an implicit AND.

data/proto_docs/google/cloud/discoveryengine/v1/rank_service.rb

@@ -43,6 +43,8 @@ module Google
         # @!attribute [rw] score
         #   @return [::Float]
         #     The score of this record based on the given query and selected model.
+        #     The score will be rounded to 2 decimal places. If the score is close to 0,
+        #     it will be rounded to 0.0001 to avoid returning unset.
         class RankingRecord
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -58,7 +60,7 @@ module Google
         #   @return [::String]
         #     The identifier of the model to use. It is one of:
         #
-        #     * `semantic-ranker-512@latest`: Semantic ranking model with maxiumn input
+        #     * `semantic-ranker-512@latest`: Semantic ranking model with maximum input
         #     token size 512.
         #
         #     It is set to `semantic-ranker-512@latest` by default if unspecified.

data/proto_docs/google/cloud/discoveryengine/v1/recommendation_service.rb

@@ -25,7 +25,7 @@ module Google
         # @!attribute [rw] serving_config
         #   @return [::String]
         #     Required. Full resource name of a
-        #     [ServingConfig][google.cloud.discoveryengine.v1.ServingConfig]:
+        #     {::Google::Cloud::DiscoveryEngine::V1::ServingConfig ServingConfig}:
         #     `projects/*/locations/global/collections/*/engines/*/servingConfigs/*`, or
         #     `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*`
         #
@@ -77,9 +77,9 @@ module Google
         #     attribute-based expressions are expected instead of the above described
         #     tag-based syntax. Examples:
         #
-        #      * (launguage: ANY("en", "es")) AND NOT (categories: ANY("Movie"))
+        #      * (language: ANY("en", "es")) AND NOT (categories: ANY("Movie"))
         #      * (available: true) AND
-        #        (launguage: ANY("en", "es")) OR (categories: ANY("Movie"))
+        #        (language: ANY("en", "es")) OR (categories: ANY("Movie"))
         #
         #     If your filter blocks all results, the API returns generic
         #     (unfiltered) popular Documents. If you only want results strictly matching

data/proto_docs/google/cloud/discoveryengine/v1/safety.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module DiscoveryEngine
+      module V1
+        # Safety rating corresponding to the generated content.
+        # @!attribute [r] category
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::HarmCategory]
+        #     Output only. Harm category.
+        # @!attribute [r] probability
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::SafetyRating::HarmProbability]
+        #     Output only. Harm probability levels in the content.
+        # @!attribute [r] probability_score
+        #   @return [::Float]
+        #     Output only. Harm probability score.
+        # @!attribute [r] severity
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::SafetyRating::HarmSeverity]
+        #     Output only. Harm severity levels in the content.
+        # @!attribute [r] severity_score
+        #   @return [::Float]
+        #     Output only. Harm severity score.
+        # @!attribute [r] blocked
+        #   @return [::Boolean]
+        #     Output only. Indicates whether the content was filtered out because of this
+        #     rating.
+        class SafetyRating
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Harm probability levels in the content.
+          module HarmProbability
+            # Harm probability unspecified.
+            HARM_PROBABILITY_UNSPECIFIED = 0
+
+            # Negligible level of harm.
+            NEGLIGIBLE = 1
+
+            # Low level of harm.
+            LOW = 2
+
+            # Medium level of harm.
+            MEDIUM = 3
+
+            # High level of harm.
+            HIGH = 4
+          end
+
+          # Harm severity levels.
+          module HarmSeverity
+            # Harm severity unspecified.
+            HARM_SEVERITY_UNSPECIFIED = 0
+
+            # Negligible level of harm severity.
+            HARM_SEVERITY_NEGLIGIBLE = 1
+
+            # Low level of harm severity.
+            HARM_SEVERITY_LOW = 2
+
+            # Medium level of harm severity.
+            HARM_SEVERITY_MEDIUM = 3
+
+            # High level of harm severity.
+            HARM_SEVERITY_HIGH = 4
+          end
+        end
+
+        # Harm categories that will block the content.
+        module HarmCategory
+          # The harm category is unspecified.
+          HARM_CATEGORY_UNSPECIFIED = 0
+
+          # The harm category is hate speech.
+          HARM_CATEGORY_HATE_SPEECH = 1
+
+          # The harm category is dangerous content.
+          HARM_CATEGORY_DANGEROUS_CONTENT = 2
+
+          # The harm category is harassment.
+          HARM_CATEGORY_HARASSMENT = 3
+
+          # The harm category is sexually explicit content.
+          HARM_CATEGORY_SEXUALLY_EXPLICIT = 4
+
+          # The harm category is civic integrity.
+          HARM_CATEGORY_CIVIC_INTEGRITY = 5
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/discoveryengine/v1/search_service.rb

@@ -83,10 +83,13 @@ module Google
         #     Default number is 10.
         # @!attribute [rw] data_store_specs
         #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::SearchRequest::DataStoreSpec>]
-        #     Specs defining dataStores to filter on in a search call and configurations
-        #     for those dataStores. This is only considered for engines with multiple
-        #     dataStores use case. For single dataStore within an engine, they should
-        #     use the specs at the top level.
+        #     Specifications that define the specific
+        #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}s to be searched,
+        #     along with configurations for those data stores. This is only considered
+        #     for {::Google::Cloud::DiscoveryEngine::V1::Engine Engine}s with multiple data
+        #     stores. For engines with a single data store, the specs directly under
+        #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest SearchRequest} should be
+        #     used.
         # @!attribute [rw] filter
         #   @return [::String]
         #     The filter syntax consists of an expression language for constructing a
@@ -135,7 +138,7 @@ module Google
         # @!attribute [rw] user_info
         #   @return [::Google::Cloud::DiscoveryEngine::V1::UserInfo]
         #     Information about the end user.
-        #     Highly recommended for analytics.
+        #     Highly recommended for analytics and personalization.
         #     {::Google::Cloud::DiscoveryEngine::V1::UserInfo#user_agent UserInfo.user_agent}
         #     is used to deduce `device_type` for analytics.
         # @!attribute [rw] language_code
@@ -228,6 +231,10 @@ module Google
         #     Search as you type configuration. Only supported for the
         #     {::Google::Cloud::DiscoveryEngine::V1::IndustryVertical::MEDIA IndustryVertical.MEDIA}
         #     vertical.
+        # @!attribute [rw] display_spec
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::DisplaySpec]
+        #     Optional. Config for display feature, like match highlighting on search
+        #     results.
         # @!attribute [rw] session
         #   @return [::String]
         #     The session resource name. Optional.
@@ -261,6 +268,18 @@ module Google
         #     Session specification.
         #
         #     Can be used only when `session` is set.
+        # @!attribute [rw] relevance_threshold
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RelevanceThreshold]
+        #     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.
+        # @!attribute [rw] relevance_score_spec
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::RelevanceScoreSpec]
+        #     Optional. The specification for returning the relevance score.
         class SearchRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -288,6 +307,11 @@ module Google
           #     Optional. Filter specification to filter documents in the data store
           #     specified by data_store field. For more information on filtering, see
           #     [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
+          # @!attribute [rw] boost_spec
+          #   @return [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::BoostSpec]
+          #     Optional. Boost specification to boost certain documents.
+          #     For more information on boosting, see
+          #     [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
           class DataStoreSpec
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -437,7 +461,7 @@ module Google
           # @!attribute [rw] condition_boost_specs
           #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::SearchRequest::BoostSpec::ConditionBoostSpec>]
           #     Condition boost specifications. If a document matches multiple conditions
-          #     in the specifictions, boost scores from these specifications are all
+          #     in the specifications, boost scores from these specifications are all
           #     applied and combined in a non-linear way. Maximum number of
           #     specifications is 20.
           class BoostSpec
@@ -900,7 +924,8 @@ module Google
               DOCUMENTS = 1
 
               # Returns chunks in the search result. Only available if the
-              # [DataStore.DocumentProcessingConfig.chunking_config][] is specified.
+              # {::Google::Cloud::DiscoveryEngine::V1::DocumentProcessingConfig#chunking_config DocumentProcessingConfig.chunking_config}
+              # is specified.
               CHUNKS = 2
             end
           end
@@ -926,6 +951,31 @@ module Google
 
               # Enables Search As You Type.
               ENABLED = 2
+
+              # Automatic switching between search-as-you-type and standard search
+              # modes, ideal for single-API implementations (e.g., debouncing).
+              AUTO = 3
+            end
+          end
+
+          # Specifies features for display, like match highlighting.
+          # @!attribute [rw] match_highlighting_condition
+          #   @return [::Google::Cloud::DiscoveryEngine::V1::SearchRequest::DisplaySpec::MatchHighlightingCondition]
+          #     The condition under which match highlighting should occur.
+          class DisplaySpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Enum describing under which condition match highlighting should occur.
+            module MatchHighlightingCondition
+              # Server behavior is the same as `MATCH_HIGHLIGHTING_DISABLED`.
+              MATCH_HIGHLIGHTING_CONDITION_UNSPECIFIED = 0
+
+              # Disables match highlighting on all documents.
+              MATCH_HIGHLIGHTING_DISABLED = 1
+
+              # Enables match highlighting on all documents.
+              MATCH_HIGHLIGHTING_ENABLED = 2
             end
           end
 
@@ -966,7 +1016,7 @@ module Google
           #     The number of top search results to persist. The persisted search results
           #     can be used for the subsequent /answer api call.
           #
-          #     This field is simliar to the `summary_result_count` field in
+          #     This field is similar to the `summary_result_count` field in
           #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest::ContentSearchSpec::SummarySpec#summary_result_count SearchRequest.ContentSearchSpec.SummarySpec.summary_result_count}.
           #
           #     At most 10 results for documents mode, or 50 for chunks mode.
@@ -975,6 +1025,16 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # The specification for returning the document relevance score.
+          # @!attribute [rw] return_relevance_score
+          #   @return [::Boolean]
+          #     Optional. Whether to return the relevance score for search results.
+          #     The higher the score, the more relevant the document is to the query.
+          class RelevanceScoreSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # @!attribute [rw] key
           #   @return [::String]
           # @!attribute [rw] value
@@ -992,6 +1052,27 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # 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.
+          module RelevanceThreshold
+            # Default value. In this case, server behavior defaults to Google defined
+            # threshold.
+            RELEVANCE_THRESHOLD_UNSPECIFIED = 0
+
+            # Lowest relevance threshold.
+            LOWEST = 1
+
+            # Low relevance threshold.
+            LOW = 2
+
+            # Medium relevance threshold.
+            MEDIUM = 3
+
+            # High relevance threshold.
+            HIGH = 4
+          end
         end
 
         # Response message for
@@ -1052,6 +1133,9 @@ module Google
         #     Only set if
         #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest#session SearchRequest.session}
         #     is provided. See its description for more details.
+        # @!attribute [rw] search_link_promotions
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::SearchLinkPromotion>]
+        #     Promotions for site search.
         class SearchResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1071,9 +1155,21 @@ module Google
           #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest::ContentSearchSpec#search_result_mode SearchRequest.ContentSearchSpec.search_result_mode}
           #     is set to
           #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest::ContentSearchSpec::SearchResultMode::CHUNKS CHUNKS}.
+          # @!attribute [r] model_scores
+          #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::DiscoveryEngine::V1::DoubleList}]
+          #     Output only. Google provided available scores.
           class SearchResult
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # @!attribute [rw] key
+            #   @return [::String]
+            # @!attribute [rw] value
+            #   @return [::Google::Cloud::DiscoveryEngine::V1::DoubleList]
+            class ModelScoresEntry
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
 
           # A facet result.
@@ -1294,6 +1390,11 @@ module Google
               # [SearchRequest.ContentSearchSpec.SummarySpec.ignore_non_answer_seeking_query]
               # is set to `true`.
               NON_SUMMARY_SEEKING_QUERY_IGNORED_V2 = 9
+
+              # The time out case.
+              #
+              # Google skips the summary if the time out.
+              TIME_OUT = 10
             end
           end