google-cloud-gemini_data_analytics-v1beta 1.0.0 → 1.2.0

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

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.
@@ -77,6 +77,57 @@ module Google
         #     DataAgent resources. Cloud KMS CryptoKeys must reside in the same location
         #     as the DataAgent. The expected format is
         #     `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
+        # @!attribute [rw] bigquery_agent_analytics_enabled
+        #   @return [::Boolean]
+        #     Optional. Controls whether BigQuery Agent Analytics trace logging is
+        #     enabled for the agent.
+        #
+        #     BigQuery Agent Analytics is in Preview and is delivered to enrolled
+        #     projects only. In a project that is not enrolled this field is accepted
+        #     and stored, but no trace rows are written and no error is returned.
+        #
+        #     Trace logging is additionally suppressed for the entire turn, without
+        #     error, when any table in the agent's datasource carries row-level
+        #     security, column-level security or policy tags. It is also suppressed
+        #     when that determination cannot be made, for example when the caller
+        #     lacks permission to list a table's row access policies.
+        #
+        #     Trace rows are written only when this is `true` and
+        #     `bigquery_agent_analytics_table` is set. On a BigQuery agent, enabling
+        #     this without a table has no effect: no table is created for the agent
+        #     and no rows are written. On an agent whose datasource is not BigQuery,
+        #     `CreateDataAgent` rejects either field with `INVALID_ARGUMENT`.
+        #
+        #     This setting is independent of the project-level BigQuery Agent Analytics
+        #     setting configured through `SetAgentOpsObservability`. An agent does not
+        #     inherit that setting.
+        # @!attribute [rw] bigquery_agent_analytics_table
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryTableReference]
+        #     Optional. The BigQuery table that BigQuery Agent Analytics trace rows are
+        #     written to. Has no effect unless `bigquery_agent_analytics_enabled` is
+        #     `true`. The Preview enrollment described on that field applies here too.
+        #
+        #     The trace table is validated when it is set on `CreateDataAgent`, or when
+        #     it is included in the `update_mask` of an `UpdateDataAgent` call. The
+        #     following are rejected with `INVALID_ARGUMENT`:
+        #
+        #     * The table must belong to the same project as the agent.
+        #     * The agent's datasource must be BigQuery. BigQuery Agent Analytics is not
+        #       supported for Looker, Looker Studio or AlloyDB agents.
+        #
+        #     These are validated against the agent as sent in the request. An agent
+        #     that carries no datasource is not validated, and an agent switched to a
+        #     non-BigQuery datasource is not re-validated; in the latter case no trace
+        #     rows are written.
+        #
+        #     The destination dataset must already exist and must grant write access to
+        #     the project's Gemini Data Analytics service agent, whose address is
+        #     `service-PROJECT_NUMBER@gcp-sa-geminidataanalytics.iam.gserviceaccount.com`
+        #     (that grant is not performed on your behalf). Without it the agent answers
+        #     normally and no trace rows are written.
+        #
+        #     Changing the table on an existing agent affects subsequent turns only. Rows
+        #     already written to the previous table are left in place.
         class DataAgent
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.
@@ -48,6 +48,9 @@ module Google
         #   @return [::Boolean]
         #     Optional. If true, the list results will include soft-deleted DataAgents.
         #     Defaults to false.
+        # @!attribute [rw] creator_filter
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ListAccessibleDataAgentsRequest::CreatorFilter]
+        #     Optional. Filter for the creator of the agent.
         class ListDataAgentsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -261,6 +264,103 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Request for SetAgentOpsObservability.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Parent value for SetAgentOpsObservabilityRequest.
+        #     Format: projects/\\{project}/locations/\\{location}
+        # @!attribute [rw] telemetry_enabled
+        #   @return [::Boolean]
+        #     Optional. Whether to enable or disable AgentOps observability.
+        #     When update_mask is provided, this field is ignored unless specified in the
+        #     mask.
+        # @!attribute [rw] data_source_type
+        #   @return [::String]
+        #     Required. The data source type for which to set observability settings.
+        #     Examples: "bigquery", "looker"
+        # @!attribute [rw] bqaa_enabled
+        #   @return [::Boolean]
+        #     Optional. Whether BigQuery Agent Analytics is enabled.
+        #     Note: An explicit `update_mask` containing "bqaa_enabled" is required to
+        #     modify this field. If `update_mask` is omitted, this field is ignored and
+        #     an existing enabled setting cannot be disabled.
+        #
+        #     This is a project-level setting and does not by itself enable trace
+        #     logging for any individual agent. Per-agent trace logging is controlled
+        #     by `DataAgent.bigquery_agent_analytics_enabled` together with
+        #     `DataAgent.bigquery_agent_analytics_table`; an agent does not inherit
+        #     this setting.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. Field mask is used to specify the fields to be overwritten by the
+        #     update. The fields specified in the update_mask are relative to the
+        #     resource. A field will be overwritten if it is in the mask.
+        #
+        #     If the user does not provide a mask, only `telemetry_enabled` will be
+        #     updated (for backward compatibility with legacy callers). Note that
+        #     disabling BigQuery Agent Analytics (`bqaa_enabled = false`) requires
+        #     providing an explicit `update_mask` containing "bqaa_enabled".
+        #
+        #     Per AIP-161:
+        #     - The special wildcard value '*' is supported to update all fields.
+        #     - Field paths should use snake_case, though camelCase equivalents
+        #       (`telemetryEnabled`, `bqaaEnabled`) are accepted for REST/JSON
+        #       transcoding compatibility.
+        class SetAgentOpsObservabilityRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for SetAgentOpsObservability.
+        class SetAgentOpsObservabilityResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Metadata for SetAgentOpsObservability.
+        class SetAgentOpsObservabilityMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for RetrieveAgentOpsObservability.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Parent value for RetrieveAgentOpsObservabilityRequest.
+        #     Format: projects/\\{project}/locations/\\{location}
+        # @!attribute [rw] data_source_type
+        #   @return [::String]
+        #     Required. The data source type for which to retrieve observability
+        #     settings. Examples: "bigquery", "looker"
+        class RetrieveAgentOpsObservabilityRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for RetrieveAgentOpsObservability.
+        # @!attribute [r] telemetry_enabled
+        #   @return [::Boolean]
+        #     Output only. Whether AgentOps observability telemetry is enabled.
+        # @!attribute [r] bigquery_enabled
+        #   @return [::Boolean]
+        #     Output only. Whether BigQuery API is enabled.
+        # @!attribute [r] cloud_trace_enabled
+        #   @return [::Boolean]
+        #     Output only. Whether Cloud Trace API is enabled.
+        # @!attribute [r] cloud_monitoring_enabled
+        #   @return [::Boolean]
+        #     Output only. Whether Cloud Monitoring API is enabled.
+        # @!attribute [r] cloud_logging_enabled
+        #   @return [::Boolean]
+        #     Output only. Whether Cloud Logging API is enabled.
+        # @!attribute [r] bqaa_enabled
+        #   @return [::Boolean]
+        #     Output only. Whether BigQuery Agent Analytics is enabled.
+        class RetrieveAgentOpsObservabilityResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

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

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.

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

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.
@@ -59,6 +59,10 @@ module Google
         #   @return [::Boolean]
         #     Optional. If true (default to false), the service may return a
         #     clarifying_question if the input query is ambiguous.
+        # @!attribute [rw] generate_debug_info
+        #   @return [::Boolean]
+        #     Optional. If true (default to false), returns internal debugging
+        #     information.
         class GenerationOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -125,6 +129,17 @@ module Google
         #     options.generate_disambiguation_question was true, this field contains a
         #     question to the user for clarification. The returned represents the
         #     service's best effort based on the ambiguous input.
+        # @!attribute [rw] pipeline_debug_info
+        #   @return [::Google::Protobuf::Struct]
+        #     Detailed step-by-step pipeline execution information.
+        #     Populated only if generation_options.generate_debug_info was true.
+        #     Provided for debugging and transparency purposes only.
+        #     The structure and content of this object is not guaranteed and may
+        #     change at any time without notice. Do not write production code or
+        #     business logic depending on the fields in this object.
+        # @!attribute [rw] token_usage
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::TokenUsage]
+        #     Overall token usage for the request.
         class QueryDataResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -141,6 +156,9 @@ module Google
         #   @return [::Integer]
         #     The total number of rows in the full result set, if known.
         #     This may be an estimate or an exact count.
+        #     Note: if an internal limit (such as LIMIT 1000) was applied during query
+        #     execution to guard against excessive data transfer, this count reflects the
+        #     truncated result size rather than the unrestricted table result size.
         # @!attribute [rw] partial_result
         #   @return [::Boolean]
         #     Set to true if the returned rows in `query_result` are a subset of the
@@ -308,7 +326,8 @@ module Google
 
           # Mode of thinking for the agent.
           module ThinkingMode
-            # Unspecified thinking mode, agent will use THINKING mode by default.
+            # Unspecified thinking mode, agent will use THINKING mode by default except
+            # for BigQuery user defaulting to FAST mode by default.
             THINKING_MODE_UNSPECIFIED = 0
 
             # Fast mode, answers quickly.
@@ -318,9 +337,9 @@ module Google
             THINKING = 2
           end
 
-          # Model selection for the agent.
+          # Model selection for the agent for BigQuery users.
           module Model
-            # No model specified. The default model will be used.
+            # No model specified. Either preview or non preview model can be used.
             MODEL_UNSPECIFIED = 0
 
             # Use the most up-to-date non-preview model. This may constrain certain

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

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.
@@ -26,35 +26,45 @@ module Google
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryTableReferences]
         #     References to BigQuery tables.
         #
-        #     Note: The following fields are mutually exclusive: `bq`, `studio`, `looker`, `alloydb`, `spanner_reference`, `cloud_sql_reference`. 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: `bq`, `studio`, `looker`, `alloydb`, `spanner_reference`, `cloud_sql_reference`, `bigtable_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] studio
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::StudioDatasourceReferences]
         #     References to Looker Studio datasources.
         #
-        #     Note: The following fields are mutually exclusive: `studio`, `bq`, `looker`, `alloydb`, `spanner_reference`, `cloud_sql_reference`. 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: `studio`, `bq`, `looker`, `alloydb`, `spanner_reference`, `cloud_sql_reference`, `bigtable_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] looker
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::LookerExploreReferences]
         #     References to Looker Explores.
         #
-        #     Note: The following fields are mutually exclusive: `looker`, `bq`, `studio`, `alloydb`, `spanner_reference`, `cloud_sql_reference`. 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: `looker`, `bq`, `studio`, `alloydb`, `spanner_reference`, `cloud_sql_reference`, `bigtable_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] alloydb
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AlloyDbReference]
         #     Reference to an AlloyDB database. Only supported for the `QueryData`
         #     method.
         #
-        #     Note: The following fields are mutually exclusive: `alloydb`, `bq`, `studio`, `looker`, `spanner_reference`, `cloud_sql_reference`. 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: `alloydb`, `bq`, `studio`, `looker`, `spanner_reference`, `cloud_sql_reference`, `bigtable_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] spanner_reference
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::SpannerReference]
         #     Reference to a Spanner database. Only supported for the `QueryData`
         #     method.
         #
-        #     Note: The following fields are mutually exclusive: `spanner_reference`, `bq`, `studio`, `looker`, `alloydb`, `cloud_sql_reference`. 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: `spanner_reference`, `bq`, `studio`, `looker`, `alloydb`, `cloud_sql_reference`, `bigtable_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] cloud_sql_reference
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::CloudSqlReference]
         #     Reference to a CloudSql database. Only supported for the `QueryData`
         #     method.
         #
-        #     Note: The following fields are mutually exclusive: `cloud_sql_reference`, `bq`, `studio`, `looker`, `alloydb`, `spanner_reference`. 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: `cloud_sql_reference`, `bq`, `studio`, `looker`, `alloydb`, `spanner_reference`, `bigtable_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] bigtable_reference
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::BigtableReference]
+        #     Reference to a Bigtable instance.
+        #
+        #     Note: The following fields are mutually exclusive: `bigtable_reference`, `bq`, `studio`, `looker`, `alloydb`, `spanner_reference`, `cloud_sql_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] firestore_reference
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::FirestoreReference]
+        #     Reference to a Firestore database.
+        #
+        #     Note: The following fields are mutually exclusive: `firestore_reference`, `bq`, `studio`, `looker`, `alloydb`, `spanner_reference`, `cloud_sql_reference`, `bigtable_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class DatasourceReferences
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -68,10 +78,14 @@ module Google
         #     Optional. References to BigQuery tables.
         # @!attribute [rw] property_graph_references
         #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryPropertyGraphReference>]
-        #     Optional. Preview feature. References to BigQuery property graphs.
-        #     Note: Data sources must exclusively use either tables or property graphs,
-        #     not both. When using property graphs, a maximum of one graph reference is
-        #     supported.
+        #     Optional. References to BigQuery graphs.
+        #
+        #     Note: "property graph" is the former name for BigQuery Graph. The field and
+        #     message names retain the original term for backward compatibility; both
+        #     refer to the same resource.
+        # @!attribute [rw] agent_context_reference
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AgentContextReference]
+        #     Optional. Parameters for retrieving data from Agent Context.
         class BigQueryTableReferences
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -193,6 +207,72 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Message representing reference to a Bigtable instance and agent context.
+        # @!attribute [rw] database_reference
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::BigtableDatabaseReference]
+        #     Required. Singular proto that supports specifying which database and tables
+        #     to include.
+        # @!attribute [rw] agent_context_reference
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AgentContextReference]
+        #     Optional. Parameters for retrieving data from Agent Context.
+        class BigtableReference
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message representing reference to Bigtable database.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     Required. The project the instance belongs to.
+        # @!attribute [rw] instance_id
+        #   @return [::String]
+        #     Required. The instance id.
+        # @!attribute [rw] table_ids
+        #   @return [::Array<::String>]
+        #     Optional. The table ids. Denotes all tables if unset.
+        # @!attribute [rw] database_table_references
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::DatabaseTableReference>]
+        #     Optional. References to tables within the database. Each reference
+        #     specifies a table and can optionally include the table's schema to provide
+        #     context for the query.
+        class BigtableDatabaseReference
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message representing reference to a Firestore database and agent context.
+        # @!attribute [rw] database_reference
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::FirestoreDatabaseReference]
+        #     Required. Singular proto that supports specifying which database and tables
+        #     to include.
+        # @!attribute [rw] agent_context_reference
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AgentContextReference]
+        #     Optional. Parameters for retrieving data from Agent Context.
+        class FirestoreReference
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message representing a reference to a single Firestore database.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     Required. Project the firestore database belongs to.
+        # @!attribute [rw] database_id
+        #   @return [::String]
+        #     Required. The database id.
+        # @!attribute [rw] collection_ids
+        #   @return [::Array<::String>]
+        #     Optional. The collection ids. Denotes all collections if unset.
+        # @!attribute [rw] database_table_references
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::DatabaseTableReference>]
+        #     Optional. References to collections within the database. Each reference
+        #     specifies a collection and can optionally include the collection's schema
+        #     to provide context for the query.
+        class FirestoreDatabaseReference
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Message representing reference to a Spanner database and agent context.
         # Only supported for the `QueryData` method.
         # @!attribute [rw] database_reference
@@ -394,37 +474,47 @@ module Google
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryTableReference]
         #     A reference to a BigQuery table.
         #
-        #     Note: The following fields are mutually exclusive: `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `alloy_db_reference`, `spanner_reference`, `cloud_sql_reference`, `bigquery_property_graph_reference`. 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: `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `alloy_db_reference`, `spanner_reference`, `cloud_sql_reference`, `bigtable_reference`, `bigquery_property_graph_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] studio_datasource_id
         #   @return [::String]
         #     A reference to a Looker Studio datasource.
         #
-        #     Note: The following fields are mutually exclusive: `studio_datasource_id`, `bigquery_table_reference`, `looker_explore_reference`, `alloy_db_reference`, `spanner_reference`, `cloud_sql_reference`, `bigquery_property_graph_reference`. 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: `studio_datasource_id`, `bigquery_table_reference`, `looker_explore_reference`, `alloy_db_reference`, `spanner_reference`, `cloud_sql_reference`, `bigtable_reference`, `bigquery_property_graph_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] looker_explore_reference
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::LookerExploreReference]
         #     A reference to a Looker explore.
         #
-        #     Note: The following fields are mutually exclusive: `looker_explore_reference`, `bigquery_table_reference`, `studio_datasource_id`, `alloy_db_reference`, `spanner_reference`, `cloud_sql_reference`, `bigquery_property_graph_reference`. 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: `looker_explore_reference`, `bigquery_table_reference`, `studio_datasource_id`, `alloy_db_reference`, `spanner_reference`, `cloud_sql_reference`, `bigtable_reference`, `bigquery_property_graph_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] alloy_db_reference
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AlloyDbReference]
         #     A reference to an AlloyDB database.
         #
-        #     Note: The following fields are mutually exclusive: `alloy_db_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `spanner_reference`, `cloud_sql_reference`, `bigquery_property_graph_reference`. 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: `alloy_db_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `spanner_reference`, `cloud_sql_reference`, `bigtable_reference`, `bigquery_property_graph_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] spanner_reference
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::SpannerReference]
         #     A reference to a Spanner database.
         #
-        #     Note: The following fields are mutually exclusive: `spanner_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `alloy_db_reference`, `cloud_sql_reference`, `bigquery_property_graph_reference`. 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: `spanner_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `alloy_db_reference`, `cloud_sql_reference`, `bigtable_reference`, `bigquery_property_graph_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] cloud_sql_reference
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::CloudSqlReference]
         #     A reference to a CloudSQL database.
         #
-        #     Note: The following fields are mutually exclusive: `cloud_sql_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `alloy_db_reference`, `spanner_reference`, `bigquery_property_graph_reference`. 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: `cloud_sql_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `alloy_db_reference`, `spanner_reference`, `bigtable_reference`, `bigquery_property_graph_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] bigtable_reference
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::BigtableReference]
+        #     A reference to a Bigtable instance.
+        #
+        #     Note: The following fields are mutually exclusive: `bigtable_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `alloy_db_reference`, `spanner_reference`, `cloud_sql_reference`, `bigquery_property_graph_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] bigquery_property_graph_reference
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryPropertyGraphReference]
         #     A reference to a BigQuery property graph.
         #
-        #     Note: The following fields are mutually exclusive: `bigquery_property_graph_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `alloy_db_reference`, `spanner_reference`, `cloud_sql_reference`. 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: `bigquery_property_graph_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `alloy_db_reference`, `spanner_reference`, `cloud_sql_reference`, `bigtable_reference`, `firestore_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] firestore_reference
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::FirestoreReference]
+        #     A reference to a Firestore database.
+        #
+        #     Note: The following fields are mutually exclusive: `firestore_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `alloy_db_reference`, `spanner_reference`, `cloud_sql_reference`, `bigtable_reference`, `bigquery_property_graph_reference`. 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::V1beta::Schema]
         #     Optional. The schema of the datasource.

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

@@ -0,0 +1,38 @@
+# 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 V1beta
+        # Overall token usage tracking for the response.
+        # @!attribute [rw] input_token_count
+        #   @return [::Integer]
+        #     The total number of input tokens used in this request.
+        # @!attribute [rw] output_token_count
+        #   @return [::Integer]
+        #     The total number of output tokens used in this request.
+        class TokenUsage
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/iam/v1/iam_policy.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.

data/proto_docs/google/iam/v1/options.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.

data/proto_docs/google/iam/v1/policy.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.

data/proto_docs/google/longrunning/operations.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.

data/proto_docs/google/protobuf/any.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.

data/proto_docs/google/protobuf/duration.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.

data/proto_docs/google/protobuf/empty.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.

data/proto_docs/google/protobuf/field_mask.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.

data/proto_docs/google/protobuf/struct.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.

data/proto_docs/google/protobuf/timestamp.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.
@@ -110,14 +110,15 @@ module Google
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [::Integer]
-    #     Represents seconds of UTC time since Unix epoch
-    #     1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
-    #     9999-12-31T23:59:59Z inclusive.
+    #     Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must
+    #     be between -315576000000 and 315576000000 inclusive (which corresponds to
+    #     0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).
     # @!attribute [rw] nanos
     #   @return [::Integer]
-    #     Non-negative fractions of a second at nanosecond resolution. Negative
-    #     second values with fractions must still have non-negative nanos values
-    #     that count forward in time. Must be from 0 to 999,999,999
+    #     Non-negative fractions of a second at nanosecond resolution. This field is
+    #     the nanosecond portion of the duration, not an alternative to seconds.
+    #     Negative second values with fractions must still have non-negative nanos
+    #     values that count forward in time. Must be between 0 and 999,999,999
     #     inclusive.
     class Timestamp
       include ::Google::Protobuf::MessageExts

data/proto_docs/google/protobuf/wrappers.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.

data/proto_docs/google/rpc/status.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# 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.