google-cloud-discovery_engine-v1 2.0.0 → 2.1.0

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

@@ -32,9 +32,16 @@ module Google
         # @!attribute [rw] answer_text
         #   @return [::String]
         #     The textual answer.
+        # @!attribute [rw] grounding_score
+        #   @return [::Float]
+        #     A score in the range of [0, 1] describing how grounded the answer is by the
+        #     reference chunks.
         # @!attribute [rw] citations
         #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::Answer::Citation>]
         #     Citations.
+        # @!attribute [rw] grounding_supports
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::Answer::GroundingSupport>]
+        #     Optional. Grounding supports.
         # @!attribute [rw] references
         #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::Answer::Reference>]
         #     References.
@@ -57,6 +64,9 @@ module Google
         # @!attribute [r] complete_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Answer completed timestamp.
+        # @!attribute [rw] safety_ratings
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::SafetyRating>]
+        #     Optional. Safety ratings.
         class Answer
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -65,10 +75,13 @@ module Google
           # @!attribute [rw] start_index
           #   @return [::Integer]
           #     Index indicates the start of the segment, measured in bytes (UTF-8
-          #     unicode).
+          #     unicode). If there are multi-byte characters,such as non-ASCII
+          #     characters, the index measurement is longer than the string length.
           # @!attribute [rw] end_index
           #   @return [::Integer]
-          #     End of the attributed segment, exclusive.
+          #     End of the attributed segment, exclusive. Measured in bytes (UTF-8
+          #     unicode). If there are multi-byte characters,such as non-ASCII
+          #     characters, the index measurement is longer than the string length.
           # @!attribute [rw] sources
           #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::Answer::CitationSource>]
           #     Citation sources for the attributed segment.
@@ -86,6 +99,35 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # Grounding support for a claim in `answer_text`.
+          # @!attribute [rw] start_index
+          #   @return [::Integer]
+          #     Required. Index indicates the start of the claim, measured in bytes
+          #     (UTF-8 unicode).
+          # @!attribute [rw] end_index
+          #   @return [::Integer]
+          #     Required. End of the claim, exclusive.
+          # @!attribute [rw] grounding_score
+          #   @return [::Float]
+          #     A score in the range of [0, 1] describing how grounded is a specific
+          #     claim by the references.
+          #     Higher value means that the claim is better supported by the reference
+          #     chunks.
+          # @!attribute [rw] grounding_check_required
+          #   @return [::Boolean]
+          #     Indicates that this claim required grounding check. When the
+          #     system decided this claim didn't require attribution/grounding check,
+          #     this field is set to false. In that case, no grounding check was
+          #     done for the claim and therefore `grounding_score`, `sources` is not
+          #     returned.
+          # @!attribute [rw] sources
+          #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::Answer::CitationSource>]
+          #     Optional. Citation sources for the claim.
+          class GroundingSupport
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Reference.
           # @!attribute [rw] unstructured_document_info
           #   @return [::Google::Cloud::DiscoveryEngine::V1::Answer::Reference::UnstructuredDocumentInfo]
@@ -198,6 +240,12 @@ module Google
             # @!attribute [rw] struct_data
             #   @return [::Google::Protobuf::Struct]
             #     Structured search data.
+            # @!attribute [r] title
+            #   @return [::String]
+            #     Output only. The title of the document.
+            # @!attribute [r] uri
+            #   @return [::String]
+            #     Output only. The URI of the document.
             class StructuredDocumentInfo
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -379,6 +427,9 @@ module Google
 
             # Answer generation has succeeded.
             SUCCEEDED = 3
+
+            # Answer generation is currently in progress.
+            STREAMING = 4
           end
 
           # An enum for answer skipped reasons.

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

@@ -42,7 +42,8 @@ module Google
         #     Output only. Represents the relevance score based on similarity.
         #     Higher score indicates higher chunk relevance.
         #     The score is in range [-1.0, 1.0].
-        #     Only populated on [SearchService.SearchResponse][].
+        #     Only populated on
+        #     {::Google::Cloud::DiscoveryEngine::V1::SearchResponse SearchResponse}.
         # @!attribute [rw] document_metadata
         #   @return [::Google::Cloud::DiscoveryEngine::V1::Chunk::DocumentMetadata]
         #     Metadata of the document from the current chunk.

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

@@ -104,11 +104,51 @@ module Google
         #     or if
         #     {::Google::Cloud::DiscoveryEngine::V1::UserEvent#direct_user_request UserEvent.direct_user_request}
         #     is set.
+        # @!attribute [rw] time_zone
+        #   @return [::String]
+        #     Optional. IANA time zone, e.g. Europe/Budapest.
         class UserInfo
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Double list.
+        # @!attribute [rw] values
+        #   @return [::Array<::Float>]
+        #     Double values.
+        class DoubleList
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Promotion proto includes uri and other helping information to display the
+        # promotion.
+        # @!attribute [rw] title
+        #   @return [::String]
+        #     Required. The title of the promotion.
+        #     Maximum length: 160 characters.
+        # @!attribute [rw] uri
+        #   @return [::String]
+        #     Optional. The URL for the page the user wants to promote. Must be set for
+        #     site search. For other verticals, this is optional.
+        # @!attribute [rw] image_uri
+        #   @return [::String]
+        #     Optional. The promotion thumbnail image url.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. The Promotion description.
+        #     Maximum length: 200 characters.
+        # @!attribute [rw] enabled
+        #   @return [::Boolean]
+        #     Optional. The enabled promotion will be returned for any serving configs
+        #     associated with the parent of the control this promotion is attached to.
+        #
+        #     This flag is used for basic site search only.
+        class SearchLinkPromotion
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # The industry vertical associated with the
         # {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}.
         module IndustryVertical

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

@@ -83,29 +83,36 @@ module Google
 
         # Defines a conditioned behavior to employ during serving.
         # Must be attached to a
-        # [ServingConfig][google.cloud.discoveryengine.v1.ServingConfig] to be
+        # {::Google::Cloud::DiscoveryEngine::V1::ServingConfig ServingConfig} to be
         # considered at serving time. Permitted actions dependent on `SolutionType`.
         # @!attribute [rw] boost_action
         #   @return [::Google::Cloud::DiscoveryEngine::V1::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::V1::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::V1::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::V1::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::V1::Control::PromoteAction]
+        #     Promote certain links based on predefined trigger queries.
+        #
+        #     This now only supports basic site search.
+        #
+        #     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
@@ -119,7 +126,7 @@ module Google
         # @!attribute [r] associated_serving_config_ids
         #   @return [::Array<::String>]
         #     Output only. List of all
-        #     [ServingConfig][google.cloud.discoveryengine.v1.ServingConfig] IDs this
+        #     {::Google::Cloud::DiscoveryEngine::V1::ServingConfig ServingConfig} IDs this
         #     control is attached to. May take up to 10 minutes to update after changes.
         # @!attribute [rw] solution_type
         #   @return [::Google::Cloud::DiscoveryEngine::V1::SolutionType]
@@ -148,9 +155,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::V1::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 +189,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::V1::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::V1::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::V1::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 +319,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::V1::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/v1/conversational_search_service.rb

@@ -252,6 +252,9 @@ module Google
         # @!attribute [rw] related_questions_spec
         #   @return [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::RelatedQuestionsSpec]
         #     Related questions specification.
+        # @!attribute [rw] grounding_spec
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::GroundingSpec]
+        #     Optional. Grounding specification.
         # @!attribute [rw] answer_generation_spec
         #   @return [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::AnswerGenerationSpec]
         #     Answer generation specification.
@@ -306,18 +309,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::V1::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::V1::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::V1::HarmCategory]
+            #     Required. Harm category.
+            # @!attribute [rw] threshold
+            #   @return [::Google::Cloud::DiscoveryEngine::V1::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.
@@ -329,6 +377,35 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # Grounding specification.
+          # @!attribute [rw] include_grounding_supports
+          #   @return [::Boolean]
+          #     Optional. Specifies whether to include grounding_supports in the answer.
+          #     The default value is `false`.
+          #
+          #     When this field is set to `true`, returned answer will have
+          #     `grounding_score` and will contain GroundingSupports for each claim.
+          # @!attribute [rw] filtering_level
+          #   @return [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::GroundingSpec::FilteringLevel]
+          #     Optional. Specifies whether to enable the filtering based on grounding
+          #     score and at what level.
+          class GroundingSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Level to filter based on answer grounding.
+            module FilteringLevel
+              # Default is no filter
+              FILTERING_LEVEL_UNSPECIFIED = 0
+
+              # Filter answers based on a low threshold.
+              FILTERING_LEVEL_LOW = 1
+
+              # Filter answers based on a high threshold.
+              FILTERING_LEVEL_HIGH = 2
+            end
+          end
+
           # Answer generation specification.
           # @!attribute [rw] model_spec
           #   @return [::Google::Cloud::DiscoveryEngine::V1::AnswerQueryRequest::AnswerGenerationSpec::ModelSpec]
@@ -612,6 +689,10 @@ module Google
           # @!attribute [rw] query_rephraser_spec
           #   @return [::Google::Cloud::DiscoveryEngine::V1::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
@@ -652,9 +733,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::V1::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::V1::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::V1::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::V1::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::V1::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
 
@@ -751,6 +899,10 @@ module Google
         #   @return [::String]
         #     Required. The resource name of the Session to get. Format:
         #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`
+        # @!attribute [rw] include_answer_details
+        #   @return [::Boolean]
+        #     Optional. If set to true, the full session including all answer details
+        #     will be returned.
         class GetSessionRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -781,13 +933,18 @@ module Google
         #     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`
         #
         #     Example:
-        #     "update_time desc"
-        #     "create_time"
+        #
+        #     * "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
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -50,7 +50,7 @@ module Google
         # @!attribute [r] default_schema_id
         #   @return [::String]
         #     Output only. The id of the default
-        #     {::Google::Cloud::DiscoveryEngine::V1::Schema Schema} asscociated to this data
+        #     {::Google::Cloud::DiscoveryEngine::V1::Schema Schema} associated to this data
         #     store.
         # @!attribute [rw] content_config
         #   @return [::Google::Cloud::DiscoveryEngine::V1::DataStore::ContentConfig]
@@ -61,6 +61,9 @@ module Google
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Timestamp the
         #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore} was created at.
+        # @!attribute [rw] advanced_site_search_config
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::AdvancedSiteSearchConfig]
+        #     Optional. Configuration for advanced site search.
         # @!attribute [r] billing_estimation
         #   @return [::Google::Cloud::DiscoveryEngine::V1::DataStore::BillingEstimation]
         #     Output only. Data size estimation for billing.
@@ -80,9 +83,12 @@ module Google
         #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore} when provisioning
         #     it. If unset, a default vertical specialized schema will be used.
         #
-        #     This field is only used by [CreateDataStore][] API, and will be ignored if
-        #     used in other APIs. This field will be omitted from all API responses
-        #     including [CreateDataStore][] API. To retrieve a schema of a
+        #     This field is only used by
+        #     {::Google::Cloud::DiscoveryEngine::V1::DataStoreService::Client#create_data_store CreateDataStore}
+        #     API, and will be ignored if used in other APIs. This field will be omitted
+        #     from all API responses including
+        #     {::Google::Cloud::DiscoveryEngine::V1::DataStoreService::Client#create_data_store CreateDataStore}
+        #     API. To retrieve a schema of a
         #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}, use
         #     {::Google::Cloud::DiscoveryEngine::V1::SchemaService::Client#get_schema SchemaService.GetSchema}
         #     API instead.
@@ -141,6 +147,18 @@ module Google
           end
         end
 
+        # Configuration data for advance site search.
+        # @!attribute [rw] disable_initial_index
+        #   @return [::Boolean]
+        #     If set true, initial indexing is disabled for the DataStore.
+        # @!attribute [rw] disable_automatic_refresh
+        #   @return [::Boolean]
+        #     If set true, automatic refresh is disabled for the DataStore.
+        class AdvancedSiteSearchConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Config to store data store type configuration for workspace data
         # @!attribute [rw] type
         #   @return [::Google::Cloud::DiscoveryEngine::V1::WorkspaceConfig::Type]
@@ -187,6 +205,9 @@ module Google
 
             # Workspace Data Store contains Keep data
             GOOGLE_KEEP = 7
+
+            # Workspace Data Store contains People data
+            GOOGLE_PEOPLE = 8
           end
         end
       end

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

@@ -50,7 +50,7 @@ module Google
         #     Immutable. The identifier of the document.
         #
         #     Id should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034)
-        #     standard with a length limit of 63 characters.
+        #     standard with a length limit of 128 characters.
         # @!attribute [rw] schema_id
         #   @return [::String]
         #     The identifier of the schema located in the same data store.
@@ -84,7 +84,8 @@ module Google
         #     * If document is indexed successfully, the index_time field is populated.
         #     * Otherwise, if document is not indexed due to errors, the error_samples
         #       field is populated.
-        #     * Otherwise, index_status is unset.
+        #     * Otherwise, if document's index is in progress, the pending_message field
+        #       is populated.
         class Document
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -134,6 +135,10 @@ module Google
           #   @return [::Array<::Google::Rpc::Status>]
           #     A sample of errors encountered while indexing the document.
           #     If this field is populated, the document is not indexed due to errors.
+          # @!attribute [rw] pending_message
+          #   @return [::String]
+          #     Immutable. The message indicates the document index is in progress.
+          #     If this field is populated, the document index is pending.
           class IndexStatus
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods