google-cloud-gemini_data_analytics-v1beta 0.9.1 → 0.10.0

data/proto_docs/google/cloud/geminidataanalytics/v1beta/context.rb

@@ -40,19 +40,24 @@ module Google
         #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::ExampleQuery>]
         #     Optional. A list of example queries, providing examples of relevant and
         #     commonly used SQL queries and their corresponding natural language queries
-        #     optionally present. Currently only used for BigQuery data sources.
+        #     optionally present. Currently only used for BigQuery data sources and
+        #     databases (alloydb, cloudsql, spanner) data sources.
         # @!attribute [rw] looker_golden_queries
         #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::LookerGoldenQuery>]
         #     Optional. A list of golden queries, providing examples of relevant and
         #     commonly used Looker queries and their corresponding natural language
-        #     queries optionally present.
+        #     queries optionally present. Only supported for Looker data sources.
         # @!attribute [rw] glossary_terms
         #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::GlossaryTerm>]
         #     Optional. Term definitions (currently, only user authored)
+        #     Not supported for databases (alloydb, cloudsql, spanner) data sources.
         # @!attribute [rw] schema_relationships
         #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::Context::SchemaRelationship>]
         #     Optional. Relationships between table schema, including referencing and
         #     referenced columns.
+        # @!attribute [rw] user_functions
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::UserFunctions]
+        #     Optional. A collection of user functions to be included in context.
         class Context
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -74,10 +79,10 @@ module Google
           #     index in the `left_schema_paths` list.
           # @!attribute [rw] sources
           #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::Context::SchemaRelationship::Source>]
-          #     Sources which generated the schema relation edge.
+          #     Optional. Sources which generated the schema relation edge.
           # @!attribute [rw] confidence_score
           #   @return [::Float]
-          #     A confidence score for the suggested relationship.
+          #     Optional. A confidence score for the suggested relationship.
           #     Manually added edges have the highest confidence score.
           class SchemaRelationship
             include ::Google::Protobuf::MessageExts
@@ -114,6 +119,43 @@ module Google
           end
         end
 
+        # A collection of user functions to be included in context.
+        # @!attribute [rw] bq_routines
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryRoutine>]
+        #     A list of BigQuery routines to include in the context.
+        class UserFunctions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A reference to a BigQuery routine.
+        # @!attribute [rw] routine_reference
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryRoutineReference]
+        #     The reference to the BigQuery routine.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     User override or addition to description, to tell the agent when to use the
+        #     UDF.
+        class BigQueryRoutine
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A reference to a BigQuery routine.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     The project ID of the routine.
+        # @!attribute [rw] dataset_id
+        #   @return [::String]
+        #     The dataset ID of the routine.
+        # @!attribute [rw] routine_id
+        #   @return [::String]
+        #     The routine ID of the routine.
+        class BigQueryRoutineReference
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Example of relevant and commonly used SQL query and its corresponding natural
         # language queries optionally present. Currently only used for BigQuery data
         # sources.
@@ -126,11 +168,66 @@ module Google
         #   @return [::String]
         #     Optional. A natural language question that a user might ask.
         #     For example: "How many orders were placed last month?"
+        # @!attribute [rw] parameters
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::QueryParameter>]
+        #     Optional. The list of query parameters.
+        #     Example: The parameterized SQL query
+        #     "SELECT * FROM my_table WHERE id = @id" can be matched with any value of
+        #     id.
         class ExampleQuery
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # A query parameter message represents a parameter that can be used to
+        # parameterize a SQL query.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the parameter reference in the SQL query.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. The description of the parameter that can be used by LLM to
+        #     extract the parameter value from the user question.
+        # @!attribute [rw] data_type
+        #   @return [::String]
+        #     Required. The data type of the parameter, e.g. "STRING", "INT64", "DATE",
+        #     etc. For valid values, see the [BigQuery
+        #     documentation](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types).
+        #     This will be used to populate
+        #     google.cloud.bigquery.v2.QueryParameterType.type.
+        class QueryParameter
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A matched query message represents the agent having matched one of the
+        # example queries supplied in context as being applicable to the current
+        # question. It will also contain additional info during the matching process.
+        # @!attribute [rw] example_query
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ExampleQuery]
+        #     The query that was matched based on an example query.
+        # @!attribute [rw] query_parameter_values
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::QueryParameterValues>]
+        #     The extracted values for the query parameters.
+        class MatchedQuery
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A query parameter values message represents the values for the query
+        # parameters that were extracted from the user question by LLM, based on the
+        # example query.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the parameter.
+        # @!attribute [rw] value
+        #   @return [::String]
+        #     Required. The value of the parameter.
+        class QueryParameterValues
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A golden query for Looker, including natural language questions and a
         # corresponding Looker Query. Analogous to ExampleQuery.
         # @!attribute [rw] natural_language_questions
@@ -166,6 +263,16 @@ module Google
         # @!attribute [rw] limit
         #   @return [::String]
         #     Optional. Limit in the query.
+        # @!attribute [rw] query_id
+        #   @return [::String]
+        #     Optional. The primary identifier for the query resource in Looker, used for
+        #     API operations. Maps to `id` (or `slug`) in the Looker API `Query`
+        #     resource.
+        # @!attribute [rw] client_id
+        #   @return [::String]
+        #     Optional. The short alphanumeric identifier for the query, used for share
+        #     links and Explore URLs (e.g., in the `qid` parameter). Maps to `client_id`
+        #     in the Looker API `Query` resource.
         class LookerQuery
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -176,7 +283,9 @@ module Google
           #     Required. The field to filter on.
           # @!attribute [rw] value
           #   @return [::String]
-          #     Required. The value for the field to filter on.
+          #     Optional. The value for the field to filter on.
+          #     Optional so we can preserve the default value as an empty
+          #     string, important to get a valid and working Looker Explore url.
           class Filter
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,9 +321,23 @@ module Google
         # @!attribute [rw] datasource
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::DatasourceOptions]
         #     Optional. Options for datasources.
+        # @!attribute [rw] model
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ConversationOptions::Model]
+        #     Optional. The model to use for the agent loop.
         class ConversationOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Allowed models for the agent/conversation.
+          module Model
+            # No model specified. The model may be set on the chat request, or the
+            # default model will be used.
+            MODEL_UNSPECIFIED = 0
+
+            # Use the most up-to-date non-preview model. This may constrain certain
+            # request level settings.
+            LATEST_GA_MODEL = 1
+          end
         end
 
         # Options for datasources configurations.
@@ -285,6 +408,80 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
         end
+
+        # Source attributions for content.
+        # @!attribute [r] sources
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::CitationSource>]
+        #     Output only. List of the sources being cited.
+        # @!attribute [r] anchors
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::CitationAnchor>]
+        #     Output only. List of the anchors of the citations.
+        class Citation
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The source of the citation.
+        # @!attribute [r] uri
+        #   @return [::String]
+        #     Output only. The uri used as the source, such as a web grounding URL.
+        #
+        #     Note: The following fields are mutually exclusive: `uri`, `example_query`, `glossary_term`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [r] example_query
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ExampleQuery]
+        #     Output only. The example query used as the source.
+        #
+        #     Note: The following fields are mutually exclusive: `example_query`, `uri`, `glossary_term`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [r] glossary_term
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::GlossaryTerm]
+        #     Output only. The glossary term used as the source.
+        #
+        #     Note: The following fields are mutually exclusive: `glossary_term`, `uri`, `example_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [r] id
+        #   @return [::String]
+        #     Output only. Unique identifier of the source. This ID is service-generated
+        #     and is unique within the scope of a single `Citation` message.
+        # @!attribute [r] title
+        #   @return [::String]
+        #     Output only. The title of the source.
+        class CitationSource
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The anchor of the citation.
+        # @!attribute [r] text_message_anchor
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::CitationAnchor::TextMessageCitationAnchor]
+        #     Output only. Only set if the citation is for a TextMessage.
+        class CitationAnchor
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Citation anchor within a TextMessage.
+          # @!attribute [r] part_index
+          #   @return [::Integer]
+          #     Output only. The 0-based index of the part within the TextMessage.parts
+          #     field.
+          # @!attribute [r] start_offset_bytes
+          #   @return [::Integer]
+          #     Output only. The offset, measured in UTF-8 bytes, within the part string
+          #     where the citation begins (inclusive). Example: For the text "Hello,
+          #     world" where "world" is cited, the start offset bytes (inclusive) is 7
+          #     and the end offset bytes (exclusive) is 12.
+          # @!attribute [r] end_offset_bytes
+          #   @return [::Integer]
+          #     Output only. The offset, measured in UTF-8 bytes, within the part string
+          #     where the citation ends (exclusive). Example: For the text "Hello, world"
+          #     where "world" is cited, the start offset bytes (inclusive) is 7 and the
+          #     end offset bytes (exclusive) is 12.
+          # @!attribute [r] source_ids
+          #   @return [::Array<::String>]
+          #     Output only. The ids of the sources that are cited.
+          class TextMessageCitationAnchor
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
       end
     end
   end

data/proto_docs/google/cloud/geminidataanalytics/v1beta/conversation.rb

@@ -53,6 +53,17 @@ module Google
         #     Optional. Open-ended and user-defined labels that can be set by the client
         #     to tag a conversation (e.g. to filter conversations for specific
         #     surfaces/products).
+        # @!attribute [rw] kms_key
+        #   @return [::String]
+        #     Optional. Customer managed encryption key (CMEK) to use for encrypting the
+        #     Conversation resources. Encryption will happen at Titan layer, we will pass
+        #     the KMS key to Titan.
+        #
+        #     Format:
+        #     projects/\\{project_id}/locations/\\{location}/keyRings/\\{key_ring_name}/cryptoKeys/\\{key_name}.
+        # @!attribute [rw] memory_paused
+        #   @return [::Boolean]
+        #     Optional. Whether memory is paused for this conversation.
         class Conversation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -111,8 +122,9 @@ module Google
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Requested page size. Server may return fewer items than
-        #     requested. The max page size is 100. All larger page sizes will be coerced
-        #     to 100. If unspecified, server will pick 50 as an approperiate default.
+        #     requested. The max page size is `100`. All larger page sizes will be
+        #     coerced to `100`. If unspecified, server will pick `50` as an appropriate
+        #     default.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. A token identifying a page of results the server should return.

data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_agent.rb

@@ -71,6 +71,12 @@ module Google
         #     Output only. Timestamp in UTC of when this data agent is considered
         #     expired. This is *always* provided on output, regardless of what was sent
         #     on input.
+        # @!attribute [rw] kms_key
+        #   @return [::String]
+        #     Optional. Customer managed encryption key (CMEK) to use for encrypting the
+        #     DataAgent resources. Cloud KMS CryptoKeys must reside in the same location
+        #     as the DataAgent. The expected format is
+        #     `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
         class DataAgent
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_chat_service.rb

@@ -80,19 +80,20 @@ module Google
         # used to enforce row-level security during SQL generation and query
         # execution.
         # @!attribute [rw] parameters
-        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::ParameterizedSecureViewParameters::Parameter>]
         #     Optional. Named parameters for Parameterized Secure Views (PSV).
-        #     The map keys are parameter names (e.g., `"user_id"`), and values are the
-        #     corresponding parameter values (e.g., `"123"`).
         class ParameterizedSecureViewParameters
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
+          # Represents a single parameter for Parameterized Secure Views.
           # @!attribute [rw] key
           #   @return [::String]
+          #     Required. The parameter key (e.g., `"user_id"`).
           # @!attribute [rw] value
           #   @return [::String]
-          class ParametersEntry
+          #     Required. The parameter value (e.g., `"123"`).
+          class Parameter
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
@@ -197,8 +198,9 @@ module Google
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Requested page size. Server may return fewer items than
-        #     requested. The max page size is 100. All larger page sizes will be coerced
-        #     to 100. If unspecified, server will pick 50 as an approperiate default.
+        #     requested. The max page size is `100`. All larger page sizes will be
+        #     coerced to `100`. If unspecified, server will pick `50` as an appropriate
+        #     default.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. A token identifying a page of results the server should return.
@@ -267,10 +269,14 @@ module Google
         #     conversations and agents resources.
         #
         #     Note: The following fields are mutually exclusive: `client_managed_resource_context`, `inline_context`, `conversation_reference`, `data_agent_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] looker_settings
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::LookerSettings]
+        #     Optional. Looker specific settings.
         # @!attribute [rw] project
         #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::String]
-        #     Optional. The Google Cloud project to be used for quota and billing.
+        #     Optional. Deprecated: Use `parent` field instead.
+        #     The Google Cloud project to be used for quota and billing.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The parent value for chat request.
@@ -278,10 +284,24 @@ module Google
         # @!attribute [rw] messages
         #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::Message>]
         #     Required. Content of current conversation.
+        # @!attribute [rw] credentials
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Credentials]
+        #     Optional. The credentials to use when calling the data source(s) specified
+        #     in the context.
+        #
+        #     This field can be used to provide credentials for various data sources.
+        #     For example, when connecting to Looker, it currently supports both OAuth
+        #     token and API key-based credentials, as described in
+        #     [Authentication with an
+        #     SDK](https://cloud.google.com/looker/docs/api-auth#authentication_with_an_sdk).
         # @!attribute [rw] thinking_mode
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ChatRequest::ThinkingMode]
         #     Optional. The thinking mode to use for the agent loop.
         #     Defaults to THINKING_MODE_UNSPECIFIED if not specified.
+        # @!attribute [rw] model
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ChatRequest::Model]
+        #     Optional. The model to use for the agent loop when processing the request.
+        #     This setting only has an effect when context.options.model is not set.
         class ChatRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,6 +317,16 @@ module Google
             # Thinking mode, solves complex problems.
             THINKING = 2
           end
+
+          # Model selection for the agent.
+          module Model
+            # No model specified. The default model will be used.
+            MODEL_UNSPECIFIED = 0
+
+            # Use the most up-to-date non-preview model. This may constrain certain
+            # request level settings.
+            LATEST_GA_MODEL = 1
+          end
         end
 
         # Context for the chat request using a data agent.
@@ -304,8 +334,10 @@ module Google
         #   @return [::String]
         #     Required. The name of the data agent resource.
         # @!attribute [rw] credentials
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Credentials]
-        #     Optional. The credentials to use when calling the Looker data source.
+        #     Optional. Deprecated: Use credentials in ChatRequest.
+        #     The credentials to use when calling the Looker data source.
         #
         #     Currently supports both OAuth token and API key-based credentials, as
         #     described in
@@ -392,6 +424,20 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Message to hold Looker specific custom settings.
+        # @!attribute [rw] enable_dev_mode
+        #   @return [::Boolean]
+        #     Optional. Whether to operate in Looker's Development Mode.
+        #     If true, the API session will be switched to the "dev" workspace,
+        #     allowing interaction with LookML changes in the user's development branch.
+        #     If false or unset, the session remains in the default state (Production
+        #     Mode).
+        #     See https://cloud.google.com/looker/docs/dev-mode-prod-mode.
+        class LookerSettings
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A message from the user that is interacting with the system.
         # @!attribute [rw] text
         #   @return [::String]
@@ -402,7 +448,7 @@ module Google
         end
 
         # A message from the system in response to the user. This message can also be a
-        # message from the user as historical context for multiturn conversations with
+        # message from the user as historical context for multi-turn conversations with
         # the system.
         # @!attribute [rw] text
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::TextMessage]
@@ -440,8 +486,10 @@ module Google
         #
         #     Note: The following fields are mutually exclusive: `example_queries`, `text`, `schema`, `data`, `analysis`, `chart`, `error`, `clarification`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] clarification
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ClarificationMessage]
-        #     Optional. A message containing clarification questions.
+        #     Optional. Deprecated: Use TextMessage with TextType.FINAL_RESPONSE
+        #     instead. A message containing clarification questions.
         #
         #     Note: The following fields are mutually exclusive: `clarification`, `text`, `schema`, `data`, `analysis`, `chart`, `error`, `example_queries`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] group_id
@@ -449,6 +497,9 @@ module Google
         #     Identifies the group that the event belongs to. Similar events are deemed
         #     to be logically relevant to each other and should be shown together in
         #     the UI.
+        # @!attribute [r] citation
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Citation]
+        #     Output only. Citation information for the system message.
         class SystemMessage
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -486,6 +537,10 @@ module Google
             # (`FINAL_RESPONSE`). These messages provide insight into the agent's
             # actions.
             PROGRESS = 3
+
+            # The text is a list of follow-up questions suggested.
+            # Each item in parts is a follow-up question.
+            FOLLOWUP_QUESTIONS = 4
           end
         end
 
@@ -528,29 +583,34 @@ module Google
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::DataQuery]
         #     A data retrieval query.
         #
-        #     Note: The following fields are mutually exclusive: `query`, `generated_sql`, `result`, `generated_looker_query`, `big_query_job`. 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: `query`, `generated_sql`, `result`, `generated_looker_query`, `big_query_job`, `matched_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] generated_sql
         #   @return [::String]
         #     SQL generated by the system to retrieve data.
         #
-        #     Note: The following fields are mutually exclusive: `generated_sql`, `query`, `result`, `generated_looker_query`, `big_query_job`. 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: `generated_sql`, `query`, `result`, `generated_looker_query`, `big_query_job`, `matched_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] result
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::DataResult]
         #     Retrieved data.
         #
-        #     Note: The following fields are mutually exclusive: `result`, `query`, `generated_sql`, `generated_looker_query`, `big_query_job`. 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: `result`, `query`, `generated_sql`, `generated_looker_query`, `big_query_job`, `matched_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] generated_looker_query
         #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::LookerQuery]
-        #     Looker Query generated by the system to retrieve data.
         #     Deprecated: generated looker query is now under DataQuery.looker.
+        #     Looker Query generated by the system to retrieve data.
         #
-        #     Note: The following fields are mutually exclusive: `generated_looker_query`, `query`, `generated_sql`, `result`, `big_query_job`. 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: `generated_looker_query`, `query`, `generated_sql`, `result`, `big_query_job`, `matched_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] big_query_job
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryJob]
         #     A BigQuery job executed by the system to retrieve data.
         #
-        #     Note: The following fields are mutually exclusive: `big_query_job`, `query`, `generated_sql`, `result`, `generated_looker_query`. 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: `big_query_job`, `query`, `generated_sql`, `result`, `generated_looker_query`, `matched_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] matched_query
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::MatchedQuery]
+        #     A pre-existing query that was matched to retrieve data.
+        #
+        #     Note: The following fields are mutually exclusive: `matched_query`, `query`, `generated_sql`, `result`, `generated_looker_query`, `big_query_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class DataMessage
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -794,45 +854,65 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Deprecated: Use TextMessage with TextType.FINAL_RESPONSE instead.
         # Represents a single question to the user to help clarify their query.
+        # @deprecated This message is deprecated and may be removed in the next major version update.
         # @!attribute [rw] question
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::String]
-        #     Required. The natural language question to ask the user.
+        #     Required. Deprecated: The parent message is deprecated.
+        #     The natural language question to ask the user.
         # @!attribute [rw] selection_mode
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ClarificationQuestion::SelectionMode]
-        #     Required. The selection mode for this question.
+        #     Required. Deprecated: The parent message is deprecated.
+        #     The selection mode for this question.
         # @!attribute [rw] options
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Array<::String>]
-        #     Required. A list of distinct options for the user to choose from.
+        #     Required. Deprecated: The parent message is deprecated.
+        #     A list of distinct options for the user to choose from.
         #     The number of options is limited to a maximum of 5.
         # @!attribute [rw] clarification_question_type
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ClarificationQuestion::ClarificationQuestionType]
-        #     Optional. The type of clarification question.
+        #     Optional. Deprecated: The parent message is deprecated.
+        #     The type of clarification question.
         class ClarificationQuestion
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
+          # Deprecated: The parent message is deprecated.
           # The selection mode for the clarification question.
+          # @deprecated This enum is deprecated and may be removed in the next major version update.
           module SelectionMode
+            # Deprecated: The parent message is deprecated.
             # Unspecified selection mode.
             SELECTION_MODE_UNSPECIFIED = 0
 
+            # Deprecated: The parent message is deprecated.
             # The user can select only one option.
             SINGLE_SELECT = 1
 
+            # Deprecated: The parent message is deprecated.
             # The user can select multiple options.
             MULTI_SELECT = 2
           end
 
+          # Deprecated: The parent message is deprecated.
           # The type of clarification question.
           # This enum may be extended with new values in the future.
+          # @deprecated This enum is deprecated and may be removed in the next major version update.
           module ClarificationQuestionType
+            # Deprecated: The parent message is deprecated.
             # Unspecified clarification question type.
             CLARIFICATION_QUESTION_TYPE_UNSPECIFIED = 0
 
+            # Deprecated: The parent message is deprecated.
             # The clarification question is for filter values.
             FILTER_VALUES = 1
 
+            # Deprecated: The parent message is deprecated.
             # The clarification question is for data fields. This is a generic term
             # encompassing SQL columns, Looker fields (dimensions/measures), or
             # nested data structure properties.
@@ -840,11 +920,15 @@ module Google
           end
         end
 
+        # Deprecated: Use TextMessage with TextType.FINAL_RESPONSE instead.
         # A message of questions to help clarify the user's query. This is returned
         # when the system cannot confidently answer the user's question.
+        # @deprecated This message is deprecated and may be removed in the next major version update.
         # @!attribute [rw] questions
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::ClarificationQuestion>]
-        #     Required. A batch of clarification questions to ask the user.
+        #     Required. Deprecated: The parent message is deprecated.
+        #     A batch of clarification questions to ask the user.
         class ClarificationMessage
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods