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

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

@@ -0,0 +1,450 @@
+# 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
+        # A collection of context to apply to this conversation
+        # @!attribute [rw] system_instruction
+        #   @return [::String]
+        #     Optional. The basic entry point for data owners creating domain knowledge
+        #     for Agent.
+        #
+        #     Why: Business jargon (e.g., YTD revenue is calculated as…, Retirement Age
+        #     is 65 in the USA, etc) and system instructions (e.g., answer like a Pirate)
+        #     can help the model understand the business context around a user question.
+        # @!attribute [rw] datasource_references
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::DatasourceReferences]
+        #     Required. Data sources that are available for answering the question.
+        # @!attribute [rw] options
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::ConversationOptions]
+        #     Optional. Additional options for the conversation.
+        # @!attribute [rw] example_queries
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::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 and
+        #     databases (alloydb, cloudsql, spanner) data sources.
+        # @!attribute [rw] looker_golden_queries
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::LookerGoldenQuery>]
+        #     Optional. A list of golden queries, providing examples of relevant and
+        #     commonly used Looker queries and their corresponding natural language
+        #     queries optionally present. Only supported for Looker data sources.
+        # @!attribute [rw] glossary_terms
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::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::V1::Context::SchemaRelationship>]
+        #     Optional. Relationships between table schema, including referencing and
+        #     referenced columns.
+        # @!attribute [rw] user_functions
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::UserFunctions]
+        #     Optional. A collection of user functions to be included in context.
+        class Context
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The relationship between two tables, including referencing and referenced
+          # columns. This is a derived context retrieved from Dataplex Dataset
+          # Insights.
+          # @!attribute [rw] left_schema_paths
+          #   @return [::Google::Cloud::GeminiDataAnalytics::V1::Context::SchemaRelationship::SchemaPaths]
+          #     An ordered list of fields for the join from the first table.
+          #     The size of this list must be the same as `right_schema_paths`.
+          #     Each field at index i in this list must correspond to a field at the same
+          #     index in the `right_schema_paths` list.
+          # @!attribute [rw] right_schema_paths
+          #   @return [::Google::Cloud::GeminiDataAnalytics::V1::Context::SchemaRelationship::SchemaPaths]
+          #     An ordered list of fields for the join from the second table.
+          #     The size of this list must be the same as `left_schema_paths`.
+          #     Each field at index i in this list must correspond to a field at the same
+          #     index in the `left_schema_paths` list.
+          # @!attribute [rw] sources
+          #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::Context::SchemaRelationship::Source>]
+          #     Optional. Sources which generated the schema relation edge.
+          # @!attribute [rw] confidence_score
+          #   @return [::Float]
+          #     Optional. A confidence score for the suggested relationship.
+          #     Manually added edges have the highest confidence score.
+          class SchemaRelationship
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Represents an ordered set of paths within the table schema.
+            # @!attribute [rw] table_fqn
+            #   @return [::String]
+            #     The service-qualified full resource name of the table
+            #     Ex:
+            #     bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
+            # @!attribute [rw] paths
+            #   @return [::Array<::String>]
+            #     The ordered list of paths within the table schema.
+            class SchemaPaths
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Source which generated the schema relation edge.
+            module Source
+              # The source of the schema relationship is unspecified.
+              SOURCE_UNSPECIFIED = 0
+
+              # The source of the schema relationship is BigQuery job history.
+              BIGQUERY_JOB_HISTORY = 1
+
+              # The source of the schema relationship is LLM suggested.
+              LLM_SUGGESTED = 2
+
+              # The source of the schema relationship is BigQuery table constraints.
+              BIGQUERY_TABLE_CONSTRAINTS = 3
+            end
+          end
+        end
+
+        # A collection of user functions to be included in context.
+        # @!attribute [rw] bq_routines
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::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::V1::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.
+        # @!attribute [rw] sql_query
+        #   @return [::String]
+        #     Optional. The SQL query that should be generated to answer the natural
+        #     language question. For example: "SELECT COUNT(*) FROM orders WHERE
+        #     order_date BETWEEN '2024-01-01' AND '2024-01-31'"
+        # @!attribute [rw] natural_language_question
+        #   @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::V1::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::V1::ExampleQuery]
+        #     The query that was matched based on an example query.
+        # @!attribute [rw] query_parameter_values
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::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
+        #   @return [::Array<::String>]
+        #     Optional. Natural language questions that a user might ask.
+        #     For example: "How many orders were placed last month?"
+        # @!attribute [rw] looker_query
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::LookerQuery]
+        #     Optional. The Looker Query corresponding to the natural language questions.
+        class LookerGoldenQuery
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Looker Query Object
+        # [Looker API
+        # documentation](https://cloud.google.com/looker/docs/reference/looker-api/latest/methods/Query/run_inline_query).
+        # @!attribute [rw] model
+        #   @return [::String]
+        #     Required. The LookML model used to generate the query.
+        # @!attribute [rw] explore
+        #   @return [::String]
+        #     Required. The LookML explore used to generate the query.
+        # @!attribute [rw] fields
+        #   @return [::Array<::String>]
+        #     Optional. The fields to retrieve from the explore.
+        # @!attribute [rw] filters
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::LookerQuery::Filter>]
+        #     Optional. The filters to apply to the explore.
+        # @!attribute [rw] sorts
+        #   @return [::Array<::String>]
+        #     Optional. The sorts to apply to the explore.
+        # @!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
+
+          # A Looker query filter.
+          # @!attribute [rw] field
+          #   @return [::String]
+          #     Required. The field to filter on.
+          # @!attribute [rw] value
+          #   @return [::String]
+          #     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
+          end
+        end
+
+        # Definition of a term within a specific domain.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Required. User friendly display name of the glossary term being defined.
+        #     For example: "CTR", "conversion rate", "pending"
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Required. The description or meaning of the term.
+        #     For example: "Click-through rate", "The percentage of users who complete a
+        #     desired action", "An order that is waiting to be processed."
+        # @!attribute [rw] labels
+        #   @return [::Array<::String>]
+        #     Optional. A list of general purpose labels associated to this term.
+        #     For example: ["click rate", "clickthrough", "waiting"]
+        class GlossaryTerm
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Options for the conversation.
+        # @!attribute [rw] analysis
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::AnalysisOptions]
+        #     Optional. Options for analysis.
+        # @!attribute [rw] datasource
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::DatasourceOptions]
+        #     Optional. Options for datasources.
+        # @!attribute [rw] model
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::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. 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
+
+        # Options for datasources configurations.
+        # @!attribute [rw] big_query_max_billed_bytes
+        #   @return [::Google::Protobuf::Int64Value]
+        #     Optional. This option applies to datasources that require BigQuery queries
+        #     only. Limits the bytes billed for each BQ query job. Queries that will have
+        #     bytes billed beyond this limit will fail (without incurring a charge).
+        #     If unspecified, no limit will be applied.
+        class DatasourceOptions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Options for analysis.
+        # @!attribute [rw] python
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::AnalysisOptions::Python]
+        #     Optional. Options for Python analysis.
+        class AnalysisOptions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Options for Python analysis.
+          # @!attribute [rw] enabled
+          #   @return [::Boolean]
+          #     Optional. Whether to enable Python analysis.
+          #     Defaults to false.
+          class Python
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Source attributions for content.
+        # @!attribute [r] sources
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::CitationSource>]
+        #     Output only. List of the sources being cited.
+        # @!attribute [r] anchors
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::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::V1::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::V1::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::V1::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
+end

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

@@ -0,0 +1,167 @@
+# 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
+        # Message for a conversation.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Optional. Identifier. The unique resource name of a conversation. Format:
+        #     `projects/{project}/locations/{location}/conversations/{conversation_id}`
+        #     `{conversation_id}` is the resource id and should be 63 characters or less
+        #     and must match the format described in
+        #     https://google.aip.dev/122#resource-id-segments
+        #
+        #     Example:
+        #     `projects/1234567890/locations/global/conversations/my-conversation`.
+        #
+        #     It is recommended to skip setting this field during conversation creation
+        #     as it will be inferred automatically and overwritten with the
+        #     \\{parent}/conversations/\\{conversation_id}.
+        # @!attribute [rw] agents
+        #   @return [::Array<::String>]
+        #     Required. Agent(s) in the conversation.
+        #     Currently, only one agent is supported. This field is repeated to allow
+        #     for future support of multiple agents in a conversation.
+        #     Format: `projects/{project}/locations/{location}/dataAgents/{agent}`
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Creation timestamp.
+        # @!attribute [r] last_used_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Timestamp of the last used conversation.
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     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
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Request for creating a conversation.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Parent value for CreateConversationRequest.
+        #     Format: `projects/{project}/locations/{location}`
+        # @!attribute [rw] conversation_id
+        #   @return [::String]
+        #     Optional. The conversation id of the conversation to create.
+        #     Must be unique within the parent.
+        #     The allowed format is: `^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$`.
+        #     If not provided, the server will auto-generate a value for the id.
+        # @!attribute [rw] conversation
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1::Conversation]
+        #     Required. The conversation to create.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes since the first request.
+        class CreateConversationRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for getting a conversation based on parent and conversation id.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the resource.
+        #     Format:
+        #     `projects/{project}/locations/{location}/conversations/{conversation}`
+        class GetConversationRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for listing conversations based on parent.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Parent value for ListConversationsRequest.
+        #     Format: `projects/{project}/locations/{location}`
+        # @!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. Returned conversations will match criteria specified within the
+        #     filter. ListConversations allows filtering by:
+        #      * agents
+        #      * labels
+        class ListConversationsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for response to listing conversations.
+        # @!attribute [rw] conversations
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1::Conversation>]
+        #     The list of conversations.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token identifying a page of results the server should return.
+        class ListConversationsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for deleting a conversation based on parent and conversation id.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the resource.
+        #     Format:
+        #     `projects/{project}/locations/{location}/conversations/{conversation}`
+        class DeleteConversationRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end