google-cloud-discovery_engine-v1beta 0.27.0 → 0.28.0

data/proto_docs/google/cloud/discoveryengine/v1beta/completion_service.rb

@@ -54,10 +54,10 @@ module Google
         #     * `search-history` is the default model for site search dataStores.
         # @!attribute [rw] user_pseudo_id
         #   @return [::String]
-        #     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`.
         #
@@ -134,9 +134,9 @@ module Google
         #     user's recently searched queries given the empty query.
         # @!attribute [rw] query_model
         #   @return [::String]
-        #     Specifies the autocomplete data model. This overrides any model specified
-        #     in the Configuration > Autocomplete section of the Cloud console. Currently
-        #     supported values:
+        #     Specifies the autocomplete query model, which only applies to the QUERY
+        #     SuggestionType. This overrides any model specified in the Configuration >
+        #     Autocomplete section of the Cloud console. Currently supported values:
         #
         #     * `document` - Using suggestions generated from user-imported documents.
         #     * `search-history` - Using suggestions generated from the past history of
@@ -153,10 +153,10 @@ module Google
         #     * `search-history` is the default model for site search dataStores.
         # @!attribute [rw] user_pseudo_id
         #   @return [::String]
-        #     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`.
         #
@@ -188,15 +188,22 @@ module Google
         #     Optional. Suggestion types to return. If empty or unspecified, query
         #     suggestions are returned. Only one suggestion type is supported at the
         #     moment.
+        # @!attribute [rw] suggestion_type_specs
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest::SuggestionTypeSpec>]
+        #     Optional. Specification of each suggestion type.
+        # @!attribute [rw] experiment_ids
+        #   @return [::Array<::String>]
+        #     Optional. Experiment ids for this request.
         class AdvancedCompleteQueryRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # Specification to boost suggestions based on the condtion of the suggestion.
+          # Specification to boost suggestions based on the condition of the
+          # suggestion.
           # @!attribute [rw] condition_boost_specs
           #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest::BoostSpec::ConditionBoostSpec>]
           #     Condition boost specifications. If a suggestion matches multiple
-          #     conditions in the specifictions, boost values from these specifications
+          #     conditions in the specifications, boost values from these specifications
           #     are all applied and combined in a non-linear way. Maximum number of
           #     specifications is 20.
           #
@@ -236,6 +243,19 @@ module Google
             end
           end
 
+          # Specification of each suggestion type.
+          # @!attribute [rw] suggestion_type
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest::SuggestionType]
+          #     Optional. Suggestion type.
+          # @!attribute [rw] max_suggestions
+          #   @return [::Integer]
+          #     Optional. Maximum number of suggestions to return for each suggestion
+          #     type.
+          class SuggestionTypeSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Suggestion type to return.
           module SuggestionType
             # Default value.
@@ -300,6 +320,9 @@ module Google
           # @!attribute [rw] data_store
           #   @return [::Array<::String>]
           #     The name of the dataStore that this suggestion belongs to.
+          # @!attribute [rw] score
+          #   @return [::Float]
+          #     The score of each suggestion. The score is in the range of [0, 1].
           class QuerySuggestion
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -319,6 +342,15 @@ module Google
           # @!attribute [rw] data_store
           #   @return [::String]
           #     The name of the dataStore that this suggestion belongs to.
+          # @!attribute [rw] score
+          #   @return [::Float]
+          #     The score of each suggestion. The score is in the range of [0, 1].
+          # @!attribute [rw] display_photo_uri
+          #   @return [::String]
+          #     The photo uri of the person suggestion.
+          # @!attribute [rw] destination_uri
+          #   @return [::String]
+          #     The destination uri of the person suggestion.
           class PersonSuggestion
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -350,6 +382,15 @@ module Google
           # @!attribute [rw] data_store
           #   @return [::String]
           #     The name of the dataStore that this suggestion belongs to.
+          # @!attribute [rw] score
+          #   @return [::Float]
+          #     The score of each suggestion. The score is in the range of [0, 1].
+          # @!attribute [rw] icon_uri
+          #   @return [::String]
+          #     The icon uri of the content suggestion.
+          # @!attribute [rw] destination_uri
+          #   @return [::String]
+          #     The destination uri of the content suggestion.
           class ContentSuggestion
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -374,11 +415,72 @@ module Google
           # @!attribute [rw] recent_search_time
           #   @return [::Google::Protobuf::Timestamp]
           #     The time when this recent rearch happened.
+          # @!attribute [rw] score
+          #   @return [::Float]
+          #     The score of each suggestion. The score is in the range of [0, 1].
           class RecentSearchSuggestion
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
         end
+
+        # Request message for
+        # {::Google::Cloud::DiscoveryEngine::V1beta::CompletionService::Client#remove_suggestion CompletionService.RemoveSuggestion}
+        # method.
+        # @!attribute [rw] search_history_suggestion
+        #   @return [::String]
+        #     The search history suggestion to be removed.
+        #
+        #     Note: The following fields are mutually exclusive: `search_history_suggestion`, `remove_all_search_history_suggestions`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] remove_all_search_history_suggestions
+        #   @return [::Boolean]
+        #     Remove all search history suggestions for the user.
+        #
+        #     Note: The following fields are mutually exclusive: `remove_all_search_history_suggestions`, `search_history_suggestion`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] completion_config
+        #   @return [::String]
+        #     Required. The completion_config of the parent engine resource name for
+        #     which the search history suggestion is to be removed, such as
+        #     `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.
+        # @!attribute [rw] user_pseudo_id
+        #   @return [::String]
+        #     Required. 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`.
+        #
+        #     This should be the same identifier as
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::UserEvent#user_pseudo_id UserEvent.user_pseudo_id}
+        #     and
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest#user_pseudo_id SearchRequest.user_pseudo_id}.
+        #
+        #     The field must be a UTF-8 encoded string with a length limit of 128.
+        # @!attribute [rw] user_info
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::UserInfo]
+        #     Optional. Information about the end user.
+        #
+        #     This should be the same identifier information as
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::UserEvent#user_info UserEvent.user_info}
+        #     and
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest#user_info SearchRequest.user_info}.
+        # @!attribute [rw] remove_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Required. Time at which the suggestion was removed. If not set, the current
+        #     time will be used.
+        class RemoveSuggestionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::DiscoveryEngine::V1beta::CompletionService::Client#remove_suggestion CompletionService.RemoveSuggestion}
+        # method.
+        class RemoveSuggestionResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/cloud/discoveryengine/v1beta/control.rb

@@ -41,7 +41,7 @@ module Google
         #     Optional. Query regex to match the whole search query.
         #     Cannot be set when
         #     {::Google::Cloud::DiscoveryEngine::V1beta::Condition#query_terms Condition.query_terms}
-        #     is set. This is currently supporting promotion use case.
+        #     is set. Only supported for Basic Site Search promotion serving controls.
         class Condition
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -89,23 +89,28 @@ module Google
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control::BoostAction]
         #     Defines a boost-type control
         #
-        #     Note: The following fields are mutually exclusive: `boost_action`, `filter_action`, `redirect_action`, `synonyms_action`. 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: `boost_action`, `filter_action`, `redirect_action`, `synonyms_action`, `promote_action`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] filter_action
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control::FilterAction]
         #     Defines a filter-type control
         #     Currently not supported by Recommendation
         #
-        #     Note: The following fields are mutually exclusive: `filter_action`, `boost_action`, `redirect_action`, `synonyms_action`. 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: `filter_action`, `boost_action`, `redirect_action`, `synonyms_action`, `promote_action`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] redirect_action
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control::RedirectAction]
         #     Defines a redirect-type control.
         #
-        #     Note: The following fields are mutually exclusive: `redirect_action`, `boost_action`, `filter_action`, `synonyms_action`. 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: `redirect_action`, `boost_action`, `filter_action`, `synonyms_action`, `promote_action`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] synonyms_action
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control::SynonymsAction]
         #     Treats a group of terms as synonyms of one another.
         #
-        #     Note: The following fields are mutually exclusive: `synonyms_action`, `boost_action`, `filter_action`, `redirect_action`. 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: `synonyms_action`, `boost_action`, `filter_action`, `redirect_action`, `promote_action`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] promote_action
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control::PromoteAction]
+        #     Promote certain links based on predefined trigger queries.
+        #
+        #     Note: The following fields are mutually exclusive: `promote_action`, `boost_action`, `filter_action`, `redirect_action`, `synonyms_action`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] name
         #   @return [::String]
         #     Immutable. Fully qualified name
@@ -148,9 +153,22 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
           # Adjusts order of products in returned list.
+          # @!attribute [rw] fixed_boost
+          #   @return [::Float]
+          #     Optional. Strength of the boost, which should be in [-1, 1]. Negative
+          #     boost means demotion. Default is 0.0 (No-op).
+          #
+          #     Note: The following fields are mutually exclusive: `fixed_boost`, `interpolation_boost_spec`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] interpolation_boost_spec
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control::BoostAction::InterpolationBoostSpec]
+          #     Optional. Complex specification for custom ranking based on customer
+          #     defined attribute value.
+          #
+          #     Note: The following fields are mutually exclusive: `interpolation_boost_spec`, `fixed_boost`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] boost
+          #   @deprecated This field is deprecated and may be removed in the next major version update.
           #   @return [::Float]
-          #     Required. Strength of the boost, which should be in [-1, 1]. Negative
+          #     Strength of the boost, which should be in [-1, 1]. Negative
           #     boost means demotion. Default is 0.0 (No-op).
           # @!attribute [rw] filter
           #   @return [::String]
@@ -169,6 +187,86 @@ module Google
           class BoostAction
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Specification for custom ranking based on customer specified attribute
+            # value. It provides more controls for customized ranking than the simple
+            # (condition, boost) combination above.
+            # @!attribute [rw] field_name
+            #   @return [::String]
+            #     Optional. The name of the field whose value will be used to determine
+            #     the boost amount.
+            # @!attribute [rw] attribute_type
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control::BoostAction::InterpolationBoostSpec::AttributeType]
+            #     Optional. The attribute type to be used to determine the boost amount.
+            #     The attribute value can be derived from the field value of the
+            #     specified field_name. In the case of numerical it is straightforward
+            #     i.e. attribute_value = numerical_field_value. In the case of freshness
+            #     however, attribute_value = (time.now() - datetime_field_value).
+            # @!attribute [rw] interpolation_type
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control::BoostAction::InterpolationBoostSpec::InterpolationType]
+            #     Optional. The interpolation type to be applied to connect the control
+            #     points listed below.
+            # @!attribute [rw] control_points
+            #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::Control::BoostAction::InterpolationBoostSpec::ControlPoint>]
+            #     Optional. The control points used to define the curve. The monotonic
+            #     function (defined through the interpolation_type above) passes through
+            #     the control points listed here.
+            class InterpolationBoostSpec
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # The control points used to define the curve. The curve defined
+              # through these control points can only be monotonically increasing
+              # or decreasing(constant values are acceptable).
+              # @!attribute [rw] attribute_value
+              #   @return [::String]
+              #     Optional. Can be one of:
+              #     1. The numerical field value.
+              #     2. The duration spec for freshness:
+              #     The value must be formatted as an XSD `dayTimeDuration` value (a
+              #     restricted subset of an ISO 8601 duration value). The pattern for
+              #     this is: `[nD][T[nH][nM][nS]]`.
+              # @!attribute [rw] boost_amount
+              #   @return [::Float]
+              #     Optional. The value between -1 to 1 by which to boost the score if
+              #     the attribute_value evaluates to the value specified above.
+              class ControlPoint
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
+
+              # The attribute(or function) for which the custom ranking is to be
+              # applied.
+              module AttributeType
+                # Unspecified AttributeType.
+                ATTRIBUTE_TYPE_UNSPECIFIED = 0
+
+                # The value of the numerical field will be used to dynamically update
+                # the boost amount. In this case, the attribute_value (the x value)
+                # of the control point will be the actual value of the numerical
+                # field for which the boost_amount is specified.
+                NUMERICAL = 1
+
+                # For the freshness use case the attribute value will be the duration
+                # between the current time and the date in the datetime field
+                # specified. The value must be formatted as an XSD `dayTimeDuration`
+                # value (a restricted subset of an ISO 8601 duration value). The
+                # pattern for this is: `[nD][T[nH][nM][nS]]`.
+                # For example, `5D`, `3DT12H30M`, `T24H`.
+                FRESHNESS = 2
+              end
+
+              # The interpolation type to be applied. Default will be linear
+              # (Piecewise Linear).
+              module InterpolationType
+                # Interpolation type is unspecified. In this case, it defaults to
+                # Linear.
+                INTERPOLATION_TYPE_UNSPECIFIED = 0
+
+                # Piecewise linear interpolation will be applied.
+                LINEAR = 1
+              end
+            end
           end
 
           # Specified which products may be included in results.
@@ -219,6 +317,21 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # Promote certain links based on some trigger queries.
+          #
+          # Example: Promote shoe store link when searching for `shoe` keyword.
+          # The link can be outside of associated data store.
+          # @!attribute [rw] data_store
+          #   @return [::String]
+          #     Required. Data store with which this promotion is attached to.
+          # @!attribute [rw] search_link_promotion
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::SearchLinkPromotion]
+          #     Required. Promotion attached to this action.
+          class PromoteAction
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
       end
     end

data/proto_docs/google/cloud/discoveryengine/v1beta/conversational_search_service.rb

@@ -236,6 +236,12 @@ module Google
         #     `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`,
         #     or
         #     `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`.
+        #
+        #     Or the resource name of the agent engine serving config, such as:
+        #     `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_agent_answer`.
+        #     (use when `enable_agent_invocation` set to true, and you have custom
+        #     `AI_MODE` agent engine configured)
+        #
         #     This field is used to identify the serving configuration name, set
         #     of models used to make the search.
         # @!attribute [rw] query
@@ -312,18 +318,63 @@ module Google
         #     See [Google Cloud
         #     Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
         #     for more details.
+        # @!attribute [rw] end_user_spec
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::EndUserSpec]
+        #     Optional. End user specification.
         class AnswerQueryRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
           # Safety specification.
+          # There are two use cases:
+          # 1. when only safety_spec.enable is set, the BLOCK_LOW_AND_ABOVE threshold
+          # will be applied for all categories.
+          # 2. when safety_spec.enable is set and some safety_settings are set, only
+          # specified safety_settings are applied.
           # @!attribute [rw] enable
           #   @return [::Boolean]
           #     Enable the safety filtering on the answer response. It is false by
           #     default.
+          # @!attribute [rw] safety_settings
+          #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::SafetySpec::SafetySetting>]
+          #     Optional. Safety settings.
+          #     This settings are effective only when the safety_spec.enable is true.
           class SafetySpec
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Safety settings.
+            # @!attribute [rw] category
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::HarmCategory]
+            #     Required. Harm category.
+            # @!attribute [rw] threshold
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::SafetySpec::SafetySetting::HarmBlockThreshold]
+            #     Required. The harm block threshold.
+            class SafetySetting
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Probability based thresholds levels for blocking.
+              module HarmBlockThreshold
+                # Unspecified harm block threshold.
+                HARM_BLOCK_THRESHOLD_UNSPECIFIED = 0
+
+                # Block low threshold and above (i.e. block more).
+                BLOCK_LOW_AND_ABOVE = 1
+
+                # Block medium threshold and above.
+                BLOCK_MEDIUM_AND_ABOVE = 2
+
+                # Block only high threshold (i.e. block less).
+                BLOCK_ONLY_HIGH = 3
+
+                # Block none.
+                BLOCK_NONE = 4
+
+                # Turn off the safety filter.
+                OFF = 5
+              end
+            end
           end
 
           # Related questions specification.
@@ -422,6 +473,9 @@ module Google
           #     competing company's CEO". If this field is set to `true`, we skip
           #     generating summaries for jail-breaking queries and return fallback
           #     messages instead.
+          # @!attribute [rw] multimodal_spec
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::AnswerGenerationSpec::MultimodalSpec]
+          #     Optional. Multimodal specification.
           class AnswerGenerationSpec
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -444,6 +498,31 @@ module Google
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
+
+            # Multimodal specification: Will return an image from specified source.
+            # If multiple sources are specified, the pick is a quality based decision.
+            # @!attribute [rw] image_source
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::AnswerGenerationSpec::MultimodalSpec::ImageSource]
+            #     Optional. Source of image returned in the answer.
+            class MultimodalSpec
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Specifies the image source.
+              module ImageSource
+                # Unspecified image source (multimodal feature is disabled by default).
+                IMAGE_SOURCE_UNSPECIFIED = 0
+
+                # Behavior when service determines the pick from all available sources.
+                ALL_AVAILABLE_SOURCES = 1
+
+                # Includes image from corpus in the answer.
+                CORPUS_IMAGE_ONLY = 2
+
+                # Triggers figure generation in the answer.
+                FIGURE_GENERATION_ONLY = 3
+              end
+            end
           end
 
           # Search specification.
@@ -652,6 +731,10 @@ module Google
           # @!attribute [rw] query_rephraser_spec
           #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::QueryUnderstandingSpec::QueryRephraserSpec]
           #     Query rephraser specification.
+          # @!attribute [rw] disable_spell_correction
+          #   @return [::Boolean]
+          #     Optional. Whether to disable spell correction.
+          #     The default value is `false`.
           class QueryUnderstandingSpec
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -680,6 +763,9 @@ module Google
 
                 # Non-answer-seeking query classification type, for no clear intent.
                 NON_ANSWER_SEEKING_QUERY_V2 = 4
+
+                # User defined query classification type.
+                USER_DEFINED_CLASSIFICATION_QUERY = 5
               end
             end
 
@@ -692,9 +778,76 @@ module Google
             #     Max rephrase steps.
             #     The max number is 5 steps.
             #     If not set or set to < 1, it will be set to 1 by default.
+            # @!attribute [rw] model_spec
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::QueryUnderstandingSpec::QueryRephraserSpec::ModelSpec]
+            #     Optional. Query Rephraser Model specification.
             class QueryRephraserSpec
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Query Rephraser Model specification.
+              # @!attribute [rw] model_type
+              #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::QueryUnderstandingSpec::QueryRephraserSpec::ModelSpec::ModelType]
+              #     Optional. Enabled query rephraser model type. If not set, it will use
+              #     LARGE by default.
+              class ModelSpec
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+
+                # Query rephraser types. Currently only supports single-hop
+                # (max_rephrase_steps = 1) model selections. For multi-hop
+                # (max_rephrase_steps > 1), there is only one default model.
+                module ModelType
+                  # Unspecified model type.
+                  MODEL_TYPE_UNSPECIFIED = 0
+
+                  # Small query rephraser model. Gemini 1.0 XS model.
+                  SMALL = 1
+
+                  # Large query rephraser model. Gemini 1.0 Pro model.
+                  LARGE = 2
+                end
+              end
+            end
+          end
+
+          # End user specification.
+          # @!attribute [rw] end_user_metadata
+          #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::EndUserSpec::EndUserMetaData>]
+          #     Optional. End user metadata.
+          class EndUserSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # End user metadata.
+            # @!attribute [rw] chunk_info
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::EndUserSpec::EndUserMetaData::ChunkInfo]
+            #     Chunk information.
+            class EndUserMetaData
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Chunk information.
+              # @!attribute [rw] content
+              #   @return [::String]
+              #     Chunk textual content. It is limited to 8000 characters.
+              # @!attribute [rw] document_metadata
+              #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::EndUserSpec::EndUserMetaData::ChunkInfo::DocumentMetadata]
+              #     Metadata of the document from the current chunk.
+              class ChunkInfo
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+
+                # Document metadata contains the information of the document of
+                # the current chunk.
+                # @!attribute [rw] title
+                #   @return [::String]
+                #     Title of the document.
+                class DocumentMetadata
+                  include ::Google::Protobuf::MessageExts
+                  extend ::Google::Protobuf::MessageExts::ClassMethods
+                end
+              end
             end
           end
 
@@ -753,6 +906,14 @@ module Google
         # @!attribute [rw] session
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Session]
         #     Required. The session to create.
+        # @!attribute [rw] session_id
+        #   @return [::String]
+        #     Optional. The ID to use for the session, which will become the final
+        #     component of the session's resource name.
+        #
+        #     This value should be 1-63 characters, and valid characters
+        #     are /[a-z0-9][a-z0-9-]\\{0,61}[a-z0-9]/. If not specified, a unique ID will
+        #     be generated.
         class CreateSessionRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -816,7 +977,9 @@ module Google
         # @!attribute [rw] filter
         #   @return [::String]
         #     A comma-separated list of fields to filter by, in EBNF grammar.
+        #
         #     The supported fields are:
+        #
         #     * `user_pseudo_id`
         #     * `state`
         #     * `display_name`
@@ -825,29 +988,36 @@ module Google
         #     * `labels`
         #     * `create_time`
         #     * `update_time`
+        #     * `collaborative_project`
         #
         #     Examples:
-        #     "user_pseudo_id = some_id"
-        #     "display_name = \"some_name\""
-        #     "starred = true"
-        #     "is_pinned=true AND (NOT labels:hidden)"
-        #     "create_time > \"1970-01-01T12:00:00Z\""
+        #
+        #     * `user_pseudo_id = some_id`
+        #     * `display_name = "some_name"`
+        #     * `starred = true`
+        #     * `is_pinned=true AND (NOT labels:hidden)`
+        #     * `create_time > "1970-01-01T12:00:00Z"`
+        #     * `collaborative_project =
+        #          "projects/123/locations/global/collections/default_collection/engines/"
+        #          "default_engine/collaborative_projects/cp1"`
         # @!attribute [rw] order_by
         #   @return [::String]
         #     A comma-separated list of fields to order by, sorted in ascending order.
         #     Use "desc" after a field name for descending.
+        #
         #     Supported fields:
         #
         #       * `update_time`
         #       * `create_time`
         #       * `session_name`
         #       * `is_pinned`
+        #       * `display_name`
         #
         #     Example:
         #
-        #     * "update_time desc"
-        #     * "create_time"
-        #     * "is_pinned desc,update_time desc": list sessions by is_pinned first, then
+        #     * `update_time desc`
+        #     * `create_time`
+        #     * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then
         #        by update_time.
         class ListSessionsRequest
           include ::Google::Protobuf::MessageExts