google-cloud-gemini_data_analytics-v1 0.a → 0.1.0

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

@@ -0,0 +1,689 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module GeminiDataAnalytics
+      module V1
+        # Request for listing chat messages based on parent and conversation_id.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The conversation to list messages under.
+        #     Format:
+        #     `projects/{project}/locations/{location}/conversations/{conversation_id}`
+        # @!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 appropriate
+        #     default.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A token identifying a page of results the server should return.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Filtering results. See [AIP-160](https://google.aip.dev/160) for
+        #     syntax.
+        #
+        #     ListMessages allows filtering by:
+        #      * create_time (e.g., `createTime > "2025-01-28T06:51:56-08:00"`)
+        #      * update_time
+        class ListMessagesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for listing chat messages.
+        # @!attribute [rw] messages
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::StorageMessage>]
+        #     The list of chat messages.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token identifying a page of results the server should return.
+        class ListMessagesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A stored message containing user message or system message.
+        # @!attribute [rw] message_id
+        #   @return [::String]
+        #     The unique resource name of a chat message.
+        # @!attribute [rw] message
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::Message]
+        #     The message content.
+        class StorageMessage
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for Chat.
+        # @!attribute [rw] inline_context
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::Context]
+        #     Optional. Inline context for the chat request. Use this to chat
+        #     statelessly (without managed conversation persistence and without an
+        #     Agent) by passing all context inline.
+        #
+        #     Note: The following fields are mutually exclusive: `inline_context`, `conversation_reference`, `data_agent_context`, `client_managed_resource_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] conversation_reference
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::ConversationReference]
+        #     Optional. Reference to a persisted conversation and agent context.
+        #     Use this to chat with an Agent using managed conversation persistence.
+        #
+        #     Note: The following fields are mutually exclusive: `conversation_reference`, `inline_context`, `data_agent_context`, `client_managed_resource_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] data_agent_context
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::DataAgentContext]
+        #     Optional. Context for the chat request. Use this to chat with an Agent
+        #     statelessly, without managed conversation persistence.
+        #
+        #     Note: The following fields are mutually exclusive: `data_agent_context`, `inline_context`, `conversation_reference`, `client_managed_resource_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] client_managed_resource_context
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::ClientManagedResourceContext]
+        #     Optional. Context with client managed resources.
+        #     Some clients may not use GDA managed resources including
+        #     conversations and agents, instead they create and manage their own
+        #     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::V1::LookerSettings]
+        #     Optional. Looker specific settings.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent value for chat request.
+        #     Pattern: `projects/{project}/locations/{location}`
+        # @!attribute [rw] messages
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::Message>]
+        #     Required. Content of current conversation.
+        # @!attribute [rw] credentials
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::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::V1::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::V1::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
+
+          # Mode of thinking for the agent.
+          module ThinkingMode
+            # Unspecified thinking mode, agent will use THINKING mode by default.
+            THINKING_MODE_UNSPECIFIED = 0
+
+            # Fast mode, answers quickly.
+            FAST = 1
+
+            # Thinking mode, solves complex problems.
+            THINKING = 2
+          end
+
+          # Model selection for the agent.
+          module Model
+            # No model specified. The default model will be used. Currently, this is
+            # `gemini-3.0-flash-preview`.
+            MODEL_UNSPECIFIED = 0
+
+            # Use the most up-to-date non-preview model. Currently, this is
+            # `gemini-2.5-flash`. This constrains the request level settings. The
+            # default will change to `gemini-2.5-flash`, and setting `thinking_mode`
+            # will not be supported.
+            LATEST_GA_MODEL = 1
+          end
+        end
+
+        # Context for the chat request using a data agent.
+        # @!attribute [rw] data_agent
+        #   @return [::String]
+        #     Required. The name of the data agent resource.
+        # @!attribute [rw] context_version
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::DataAgentContext::ContextVersion]
+        #     Optional. Version of context to be used by DCS (e.g. STAGING, PUBLISHED)
+        class DataAgentContext
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # List of context versions supported by DCS.
+          # There are two versions of context. This is to maintain versioning for the
+          # data agent.
+          module ContextVersion
+            # Unspecified or unrecognized.
+            CONTEXT_VERSION_UNSPECIFIED = 0
+
+            # Using this version, DCS will use the latest staging context for the
+            # data agent.
+            STAGING = 1
+
+            # Using this version, DCS will use the latest published context for the
+            # data agent.
+            PUBLISHED = 2
+          end
+        end
+
+        # Reference to a persisted conversation and agent context.
+        # @!attribute [rw] conversation
+        #   @return [::String]
+        #     Required. Name of the conversation resource.
+        #     Format:
+        #     `projects/{project}/locations/{location}/conversations/{conversation_id}`
+        # @!attribute [rw] data_agent_context
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::DataAgentContext]
+        #     Required. Context for the chat request using a data agent.
+        class ConversationReference
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Context with client managed resources.
+        # Some clients may not use GDA managed resources including
+        # conversations and agents, instead they create and manage their own
+        # conversations and agents resources.
+        # @!attribute [rw] inline_context
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::Context]
+        #     Required. Context for the chat request. Use this to chat without GDA API
+        #     managed conversation and agent persistence by passing all context inline.
+        # @!attribute [rw] conversation_id
+        #   @return [::String]
+        #     Optional. The client managed conversation id.
+        # @!attribute [rw] agent_id
+        #   @return [::String]
+        #     Optional. The client managed agent id.
+        class ClientManagedResourceContext
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A message from an interaction between the user and the system.
+        # @!attribute [rw] user_message
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::UserMessage]
+        #     A message from the user that is interacting with the system.
+        #
+        #     Note: The following fields are mutually exclusive: `user_message`, `system_message`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] system_message
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::SystemMessage]
+        #     A message from the system in response to the user.
+        #
+        #     Note: The following fields are mutually exclusive: `system_message`, `user_message`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [r] timestamp
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. For user messages, this is the time at which the system
+        #     received the message. For system messages, this is the time at which the
+        #     system generated the message.
+        # @!attribute [rw] message_id
+        #   @return [::String]
+        #     Optional. unique id of the message in the conversation for persistence.
+        class Message
+          include ::Google::Protobuf::MessageExts
+          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]
+        #     Text should use this field instead of blob.
+        class UserMessage
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        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 multi-turn conversations with
+        # the system.
+        # @!attribute [rw] text
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::TextMessage]
+        #     A direct natural language response to the user message.
+        #
+        #     Note: The following fields are mutually exclusive: `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] schema
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::SchemaMessage]
+        #     A message produced during schema resolution.
+        #
+        #     Note: The following fields are mutually exclusive: `schema`, `text`, `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] data
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::DataMessage]
+        #     A message produced during data retrieval.
+        #
+        #     Note: The following fields are mutually exclusive: `data`, `text`, `schema`, `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] analysis
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::AnalysisMessage]
+        #     A message produced during analysis.
+        #
+        #     Note: The following fields are mutually exclusive: `analysis`, `text`, `schema`, `data`, `chart`, `error`, `example_queries`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] chart
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::ChartMessage]
+        #     A message produced during chart generation.
+        #
+        #     Note: The following fields are mutually exclusive: `chart`, `text`, `schema`, `data`, `analysis`, `error`, `example_queries`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] error
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::ErrorMessage]
+        #     An error message.
+        #
+        #     Note: The following fields are mutually exclusive: `error`, `text`, `schema`, `data`, `analysis`, `chart`, `example_queries`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] example_queries
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::ExampleQueries]
+        #     Optional. A message containing example queries.
+        #
+        #     Note: The following fields are mutually exclusive: `example_queries`, `text`, `schema`, `data`, `analysis`, `chart`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] group_id
+        #   @return [::Integer]
+        #     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::V1::Citation]
+        #     Output only. Citation information for the system message.
+        class SystemMessage
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A multi-part text message.
+        # @!attribute [rw] parts
+        #   @return [::Array<::String>]
+        #     Optional. The parts of the message.
+        # @!attribute [rw] text_type
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::TextMessage::TextType]
+        #     Optional. The type of the text message.
+        # @!attribute [rw] thought_signature
+        #   @return [::String]
+        #     Optional. An opaque signature for a thought so it can be reused in
+        #     subsequent requests.
+        class TextMessage
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The type of the text message.
+          module TextType
+            # The default text type.
+            TEXT_TYPE_UNSPECIFIED = 0
+
+            # The text is a final response to the user question.
+            FINAL_RESPONSE = 1
+
+            # The text is a thought from the model.
+            THOUGHT = 2
+
+            # The text is an informational message about the agent's progress, such as
+            # a tool being invoked. This is distinct from the agent's internal thought
+            # process (`THOUGHT`) and the final answer to the user
+            # (`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
+
+        # A message produced during schema resolution.
+        # @!attribute [rw] query
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::SchemaQuery]
+        #     A schema resolution query.
+        #
+        #     Note: The following fields are mutually exclusive: `query`, `result`. 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::V1::SchemaResult]
+        #     The result of a schema resolution query.
+        #
+        #     Note: The following fields are mutually exclusive: `result`, `query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class SchemaMessage
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A query for resolving the schema relevant to the posed question.
+        # @!attribute [rw] question
+        #   @return [::String]
+        #     Optional. The question to send to the system for schema resolution.
+        class SchemaQuery
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The result of schema resolution.
+        # @!attribute [rw] datasources
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::Datasource>]
+        #     Optional. The datasources used to resolve the schema query.
+        class SchemaResult
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A message produced during data retrieval.
+        # @!attribute [rw] query
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::DataQuery]
+        #     A data retrieval query.
+        #
+        #     Note: The following fields are mutually exclusive: `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] generated_sql
+        #   @return [::String]
+        #     SQL generated by the system to retrieve data.
+        #
+        #     Note: The following fields are mutually exclusive: `generated_sql`, `query`, `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] result
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::DataResult]
+        #     Retrieved data.
+        #
+        #     Note: The following fields are mutually exclusive: `result`, `query`, `generated_sql`, `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::V1::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`, `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::V1::MatchedQuery]
+        #     A pre-existing query that was matched to retrieve data.
+        #
+        #     Note: The following fields are mutually exclusive: `matched_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.
+        class DataMessage
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A query for retrieving data.
+        # @!attribute [rw] looker
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::LookerQuery]
+        #     Optional. A query for retrieving data from a Looker explore.
+        # @!attribute [rw] question
+        #   @return [::String]
+        #     Optional. A natural language question to answer.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Optional. A snake-case name for the query that reflects its intent. It is
+        #     used to name the corresponding data result, so that it can be referenced in
+        #     later steps.
+        #
+        #     * Example: "total_sales_by_product"
+        #     * Example: "sales_for_product_12345"
+        # @!attribute [rw] datasources
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::Datasource>]
+        #     Optional. The datasources available to answer the question.
+        class DataQuery
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Retrieved data.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Optional. A snake-case name for the data result that reflects its contents.
+        #     The name is used to pass the result around by reference, and serves as a
+        #     signal about its meaning.
+        #
+        #     * Example: "total_sales_by_product"
+        #     * Example: "sales_for_product_12345"
+        # @!attribute [rw] schema
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::Schema]
+        #     Optional. The schema of the data.
+        # @!attribute [rw] data
+        #   @return [::Array<::Google::Protobuf::Struct>]
+        #     Optional. The content of the data. Each row is a struct that matches the
+        #     schema. Simple values are represented as strings, while nested structures
+        #     are represented as lists or structs.
+        # @!attribute [rw] formatted_data
+        #   @return [::Array<::Google::Protobuf::Struct>]
+        #     Optional. Formatted representation of the data, when applicable.
+        #     Each row is a struct that directly corresponds to the row at the same index
+        #     within the `data` field. Its values are string representations of the
+        #     original data, formatted according to data source specifications (e.g.,
+        #     "$1,234.56" for currency). Columns without formatting will default to
+        #     their raw value representation. If no columns have formatting rules, this
+        #     field will be empty.
+        class DataResult
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A BigQuery job executed by the system.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     Required. The project that the job belongs to.
+        #
+        #     See
+        #     [JobReference](https://cloud.google.com/bigquery/docs/reference/rest/v2/JobReference).
+        # @!attribute [rw] job_id
+        #   @return [::String]
+        #     Required. The ID of the job.
+        #
+        #     See
+        #     [JobReference](https://cloud.google.com/bigquery/docs/reference/rest/v2/JobReference).
+        # @!attribute [rw] location
+        #   @return [::String]
+        #     Optional. The location of the job.
+        #
+        #     See
+        #     [JobReference](https://cloud.google.com/bigquery/docs/reference/rest/v2/JobReference).
+        # @!attribute [rw] destination_table
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::BigQueryTableReference]
+        #     Optional. A reference to the destination table of the job's query results.
+        #
+        #     See
+        #     [JobConfigurationQuery](https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#jobconfigurationquery).
+        # @!attribute [rw] schema
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::Schema]
+        #     Optional. The schema of the job's query results.
+        #
+        #     See
+        #     [JobStatistics2](https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#jobstatistics2).
+        class BigQueryJob
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A message produced during analysis.
+        # @!attribute [rw] query
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::AnalysisQuery]
+        #     An analysis query.
+        #
+        #     Note: The following fields are mutually exclusive: `query`, `progress_event`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] progress_event
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::AnalysisEvent]
+        #     An event indicating the progress of the analysis.
+        #
+        #     Note: The following fields are mutually exclusive: `progress_event`, `query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class AnalysisMessage
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A query for performing an analysis.
+        # @!attribute [rw] question
+        #   @return [::String]
+        #     Optional. An analysis question to help answer the user's original question.
+        # @!attribute [rw] data_result_names
+        #   @return [::Array<::String>]
+        #     Optional. The names of previously retrieved data results to analyze.
+        class AnalysisQuery
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # An event indicating the progress of an analysis.
+        # @!attribute [rw] planner_reasoning
+        #   @return [::String]
+        #     Python codegen planner's reasoning.
+        #
+        #     Note: The following fields are mutually exclusive: `planner_reasoning`, `coder_instruction`, `code`, `execution_output`, `execution_error`, `result_vega_chart_json`, `result_natural_language`, `result_csv_data`, `result_reference_data`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] coder_instruction
+        #   @return [::String]
+        #     Instructions issued for code generation.
+        #
+        #     Note: The following fields are mutually exclusive: `coder_instruction`, `planner_reasoning`, `code`, `execution_output`, `execution_error`, `result_vega_chart_json`, `result_natural_language`, `result_csv_data`, `result_reference_data`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] code
+        #   @return [::String]
+        #     Generated code.
+        #
+        #     Note: The following fields are mutually exclusive: `code`, `planner_reasoning`, `coder_instruction`, `execution_output`, `execution_error`, `result_vega_chart_json`, `result_natural_language`, `result_csv_data`, `result_reference_data`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] execution_output
+        #   @return [::String]
+        #     Output from code execution.
+        #
+        #     Note: The following fields are mutually exclusive: `execution_output`, `planner_reasoning`, `coder_instruction`, `code`, `execution_error`, `result_vega_chart_json`, `result_natural_language`, `result_csv_data`, `result_reference_data`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] execution_error
+        #   @return [::String]
+        #     An error from code execution.
+        #
+        #     Note: The following fields are mutually exclusive: `execution_error`, `planner_reasoning`, `coder_instruction`, `code`, `execution_output`, `result_vega_chart_json`, `result_natural_language`, `result_csv_data`, `result_reference_data`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] result_vega_chart_json
+        #   @return [::String]
+        #     Result as Vega chart JSON string.
+        #
+        #     Note: The following fields are mutually exclusive: `result_vega_chart_json`, `planner_reasoning`, `coder_instruction`, `code`, `execution_output`, `execution_error`, `result_natural_language`, `result_csv_data`, `result_reference_data`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] result_natural_language
+        #   @return [::String]
+        #     Result as NL string.
+        #
+        #     Note: The following fields are mutually exclusive: `result_natural_language`, `planner_reasoning`, `coder_instruction`, `code`, `execution_output`, `execution_error`, `result_vega_chart_json`, `result_csv_data`, `result_reference_data`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] result_csv_data
+        #   @return [::String]
+        #     Result as CSV string.
+        #
+        #     Note: The following fields are mutually exclusive: `result_csv_data`, `planner_reasoning`, `coder_instruction`, `code`, `execution_output`, `execution_error`, `result_vega_chart_json`, `result_natural_language`, `result_reference_data`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] result_reference_data
+        #   @return [::String]
+        #     Result as a reference to a data source.
+        #
+        #     Note: The following fields are mutually exclusive: `result_reference_data`, `planner_reasoning`, `coder_instruction`, `code`, `execution_output`, `execution_error`, `result_vega_chart_json`, `result_natural_language`, `result_csv_data`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] error
+        #   @return [::String]
+        #     A generic error message.
+        #
+        #     Note: The following fields are mutually exclusive: `error`, `planner_reasoning`, `coder_instruction`, `code`, `execution_output`, `execution_error`, `result_vega_chart_json`, `result_natural_language`, `result_csv_data`, `result_reference_data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class AnalysisEvent
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A message produced during chart generation.
+        # @!attribute [rw] query
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::ChartQuery]
+        #     A query for generating a chart.
+        #
+        #     Note: The following fields are mutually exclusive: `query`, `result`. 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::V1::ChartResult]
+        #     The result of a chart generation query.
+        #
+        #     Note: The following fields are mutually exclusive: `result`, `query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class ChartMessage
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A query for generating a chart.
+        # @!attribute [rw] instructions
+        #   @return [::String]
+        #     Optional. Natural language instructions for generating the chart.
+        # @!attribute [rw] data_result_name
+        #   @return [::String]
+        #     Optional. The name of a previously retrieved data result to use in the
+        #     chart.
+        class ChartQuery
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The result of a chart generation query.
+        # @!attribute [rw] vega_config
+        #   @return [::Google::Protobuf::Struct]
+        #     Optional. A generated Vega chart config.
+        #     See https://vega.github.io/vega/docs/config/
+        # @!attribute [rw] image
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::Blob]
+        #     Optional. A rendering of the chart if this was requested in the context.
+        class ChartResult
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # An error message from a tool call.
+        # This message is used to represent an error that occurred while an agent was
+        # trying to use a tool. It's important to note that not all errors are
+        # terminal. Many are recoverable, and the agent may use the information from
+        # this error message to self-correct and retry the tool call or try a
+        # different approach.
+        #
+        # For example, if a data query fails, the agent might receive an
+        # `ErrorMessage`, analyze it, and then generate a corrected query.
+        #
+        # Clients should be cautious about interpreting this message as a definitive
+        # failure. It can be part of the agent's normal, iterative process of
+        # completing a task. Surfacing these errors directly to end-users without
+        # context (e.g., as a "hard failure") may be misleading.
+        # @!attribute [r] text
+        #   @return [::String]
+        #     Output only. The text of the error.
+        class ErrorMessage
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A message containing derived and authored example queries.
+        # @!attribute [rw] example_queries
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::ExampleQuery>]
+        #     Optional. A list of derived and authored 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.
+        class ExampleQueries
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A blob of data with a MIME type.
+        # @!attribute [rw] mime_type
+        #   @return [::String]
+        #     Required. The IANA standard MIME type of the message data.
+        # @!attribute [rw] data
+        #   @return [::String]
+        #     Required. The data represented as bytes.
+        class Blob
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end