google-cloud-gemini_data_analytics-v1beta 0.9.1 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +3 -3
  3. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/client.rb +2 -0
  4. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/operations.rb +2 -0
  5. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/paths.rb +21 -0
  6. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/rest/client.rb +2 -0
  7. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/rest/operations.rb +2 -0
  8. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/client.rb +26 -7
  9. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/paths.rb +21 -0
  10. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/rest/client.rb +26 -7
  11. data/lib/google/cloud/gemini_data_analytics/v1beta/version.rb +1 -1
  12. data/lib/google/cloud/geminidataanalytics/v1beta/context_pb.rb +13 -1
  13. data/lib/google/cloud/geminidataanalytics/v1beta/conversation_pb.rb +1 -1
  14. data/lib/google/cloud/geminidataanalytics/v1beta/data_agent_pb.rb +1 -1
  15. data/lib/google/cloud/geminidataanalytics/v1beta/data_chat_service_pb.rb +4 -1
  16. data/lib/google/cloud/geminidataanalytics/v1beta/data_chat_service_services_pb.rb +1 -1
  17. data/lib/google/cloud/geminidataanalytics/v1beta/datasource_pb.rb +3 -1
  18. data/proto_docs/google/cloud/geminidataanalytics/v1beta/context.rb +202 -5
  19. data/proto_docs/google/cloud/geminidataanalytics/v1beta/conversation.rb +14 -2
  20. data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_agent.rb +6 -0
  21. data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_chat_service.rb +105 -21
  22. data/proto_docs/google/cloud/geminidataanalytics/v1beta/datasource.rb +101 -15
  23. metadata +9 -6
@@ -80,19 +80,20 @@ module Google
80
80
  # used to enforce row-level security during SQL generation and query
81
81
  # execution.
82
82
  # @!attribute [rw] parameters
83
- # @return [::Google::Protobuf::Map{::String => ::String}]
83
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::ParameterizedSecureViewParameters::Parameter>]
84
84
  # Optional. Named parameters for Parameterized Secure Views (PSV).
85
- # The map keys are parameter names (e.g., `"user_id"`), and values are the
86
- # corresponding parameter values (e.g., `"123"`).
87
85
  class ParameterizedSecureViewParameters
88
86
  include ::Google::Protobuf::MessageExts
89
87
  extend ::Google::Protobuf::MessageExts::ClassMethods
90
88
 
89
+ # Represents a single parameter for Parameterized Secure Views.
91
90
  # @!attribute [rw] key
92
91
  # @return [::String]
92
+ # Required. The parameter key (e.g., `"user_id"`).
93
93
  # @!attribute [rw] value
94
94
  # @return [::String]
95
- class ParametersEntry
95
+ # Required. The parameter value (e.g., `"123"`).
96
+ class Parameter
96
97
  include ::Google::Protobuf::MessageExts
97
98
  extend ::Google::Protobuf::MessageExts::ClassMethods
98
99
  end
@@ -197,8 +198,9 @@ module Google
197
198
  # @!attribute [rw] page_size
198
199
  # @return [::Integer]
199
200
  # Optional. Requested page size. Server may return fewer items than
200
- # requested. The max page size is 100. All larger page sizes will be coerced
201
- # to 100. If unspecified, server will pick 50 as an approperiate default.
201
+ # requested. The max page size is `100`. All larger page sizes will be
202
+ # coerced to `100`. If unspecified, server will pick `50` as an appropriate
203
+ # default.
202
204
  # @!attribute [rw] page_token
203
205
  # @return [::String]
204
206
  # Optional. A token identifying a page of results the server should return.
@@ -267,10 +269,14 @@ module Google
267
269
  # conversations and agents resources.
268
270
  #
269
271
  # 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.
272
+ # @!attribute [rw] looker_settings
273
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::LookerSettings]
274
+ # Optional. Looker specific settings.
270
275
  # @!attribute [rw] project
271
276
  # @deprecated This field is deprecated and may be removed in the next major version update.
272
277
  # @return [::String]
273
- # Optional. The Google Cloud project to be used for quota and billing.
278
+ # Optional. Deprecated: Use `parent` field instead.
279
+ # The Google Cloud project to be used for quota and billing.
274
280
  # @!attribute [rw] parent
275
281
  # @return [::String]
276
282
  # Required. The parent value for chat request.
@@ -278,10 +284,24 @@ module Google
278
284
  # @!attribute [rw] messages
279
285
  # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::Message>]
280
286
  # Required. Content of current conversation.
287
+ # @!attribute [rw] credentials
288
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Credentials]
289
+ # Optional. The credentials to use when calling the data source(s) specified
290
+ # in the context.
291
+ #
292
+ # This field can be used to provide credentials for various data sources.
293
+ # For example, when connecting to Looker, it currently supports both OAuth
294
+ # token and API key-based credentials, as described in
295
+ # [Authentication with an
296
+ # SDK](https://cloud.google.com/looker/docs/api-auth#authentication_with_an_sdk).
281
297
  # @!attribute [rw] thinking_mode
282
298
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ChatRequest::ThinkingMode]
283
299
  # Optional. The thinking mode to use for the agent loop.
284
300
  # Defaults to THINKING_MODE_UNSPECIFIED if not specified.
301
+ # @!attribute [rw] model
302
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ChatRequest::Model]
303
+ # Optional. The model to use for the agent loop when processing the request.
304
+ # This setting only has an effect when context.options.model is not set.
285
305
  class ChatRequest
286
306
  include ::Google::Protobuf::MessageExts
287
307
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,6 +317,16 @@ module Google
297
317
  # Thinking mode, solves complex problems.
298
318
  THINKING = 2
299
319
  end
320
+
321
+ # Model selection for the agent.
322
+ module Model
323
+ # No model specified. The default model will be used.
324
+ MODEL_UNSPECIFIED = 0
325
+
326
+ # Use the most up-to-date non-preview model. This may constrain certain
327
+ # request level settings.
328
+ LATEST_GA_MODEL = 1
329
+ end
300
330
  end
301
331
 
302
332
  # Context for the chat request using a data agent.
@@ -304,8 +334,10 @@ module Google
304
334
  # @return [::String]
305
335
  # Required. The name of the data agent resource.
306
336
  # @!attribute [rw] credentials
337
+ # @deprecated This field is deprecated and may be removed in the next major version update.
307
338
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Credentials]
308
- # Optional. The credentials to use when calling the Looker data source.
339
+ # Optional. Deprecated: Use credentials in ChatRequest.
340
+ # The credentials to use when calling the Looker data source.
309
341
  #
310
342
  # Currently supports both OAuth token and API key-based credentials, as
311
343
  # described in
@@ -392,6 +424,20 @@ module Google
392
424
  extend ::Google::Protobuf::MessageExts::ClassMethods
393
425
  end
394
426
 
427
+ # Message to hold Looker specific custom settings.
428
+ # @!attribute [rw] enable_dev_mode
429
+ # @return [::Boolean]
430
+ # Optional. Whether to operate in Looker's Development Mode.
431
+ # If true, the API session will be switched to the "dev" workspace,
432
+ # allowing interaction with LookML changes in the user's development branch.
433
+ # If false or unset, the session remains in the default state (Production
434
+ # Mode).
435
+ # See https://cloud.google.com/looker/docs/dev-mode-prod-mode.
436
+ class LookerSettings
437
+ include ::Google::Protobuf::MessageExts
438
+ extend ::Google::Protobuf::MessageExts::ClassMethods
439
+ end
440
+
395
441
  # A message from the user that is interacting with the system.
396
442
  # @!attribute [rw] text
397
443
  # @return [::String]
@@ -402,7 +448,7 @@ module Google
402
448
  end
403
449
 
404
450
  # A message from the system in response to the user. This message can also be a
405
- # message from the user as historical context for multiturn conversations with
451
+ # message from the user as historical context for multi-turn conversations with
406
452
  # the system.
407
453
  # @!attribute [rw] text
408
454
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::TextMessage]
@@ -440,8 +486,10 @@ module Google
440
486
  #
441
487
  # Note: The following fields are mutually exclusive: `example_queries`, `text`, `schema`, `data`, `analysis`, `chart`, `error`, `clarification`. If a field in that set is populated, all other fields in the set will automatically be cleared.
442
488
  # @!attribute [rw] clarification
489
+ # @deprecated This field is deprecated and may be removed in the next major version update.
443
490
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ClarificationMessage]
444
- # Optional. A message containing clarification questions.
491
+ # Optional. Deprecated: Use TextMessage with TextType.FINAL_RESPONSE
492
+ # instead. A message containing clarification questions.
445
493
  #
446
494
  # Note: The following fields are mutually exclusive: `clarification`, `text`, `schema`, `data`, `analysis`, `chart`, `error`, `example_queries`. If a field in that set is populated, all other fields in the set will automatically be cleared.
447
495
  # @!attribute [rw] group_id
@@ -449,6 +497,9 @@ module Google
449
497
  # Identifies the group that the event belongs to. Similar events are deemed
450
498
  # to be logically relevant to each other and should be shown together in
451
499
  # the UI.
500
+ # @!attribute [r] citation
501
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Citation]
502
+ # Output only. Citation information for the system message.
452
503
  class SystemMessage
453
504
  include ::Google::Protobuf::MessageExts
454
505
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -486,6 +537,10 @@ module Google
486
537
  # (`FINAL_RESPONSE`). These messages provide insight into the agent's
487
538
  # actions.
488
539
  PROGRESS = 3
540
+
541
+ # The text is a list of follow-up questions suggested.
542
+ # Each item in parts is a follow-up question.
543
+ FOLLOWUP_QUESTIONS = 4
489
544
  end
490
545
  end
491
546
 
@@ -528,29 +583,34 @@ module Google
528
583
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::DataQuery]
529
584
  # A data retrieval query.
530
585
  #
531
- # Note: The following fields are mutually exclusive: `query`, `generated_sql`, `result`, `generated_looker_query`, `big_query_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
586
+ # Note: The following fields are mutually exclusive: `query`, `generated_sql`, `result`, `generated_looker_query`, `big_query_job`, `matched_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
532
587
  # @!attribute [rw] generated_sql
533
588
  # @return [::String]
534
589
  # SQL generated by the system to retrieve data.
535
590
  #
536
- # Note: The following fields are mutually exclusive: `generated_sql`, `query`, `result`, `generated_looker_query`, `big_query_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
591
+ # Note: The following fields are mutually exclusive: `generated_sql`, `query`, `result`, `generated_looker_query`, `big_query_job`, `matched_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
537
592
  # @!attribute [rw] result
538
593
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::DataResult]
539
594
  # Retrieved data.
540
595
  #
541
- # Note: The following fields are mutually exclusive: `result`, `query`, `generated_sql`, `generated_looker_query`, `big_query_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
596
+ # Note: The following fields are mutually exclusive: `result`, `query`, `generated_sql`, `generated_looker_query`, `big_query_job`, `matched_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
542
597
  # @!attribute [rw] generated_looker_query
543
598
  # @deprecated This field is deprecated and may be removed in the next major version update.
544
599
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::LookerQuery]
545
- # Looker Query generated by the system to retrieve data.
546
600
  # Deprecated: generated looker query is now under DataQuery.looker.
601
+ # Looker Query generated by the system to retrieve data.
547
602
  #
548
- # Note: The following fields are mutually exclusive: `generated_looker_query`, `query`, `generated_sql`, `result`, `big_query_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
603
+ # Note: The following fields are mutually exclusive: `generated_looker_query`, `query`, `generated_sql`, `result`, `big_query_job`, `matched_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
549
604
  # @!attribute [rw] big_query_job
550
605
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryJob]
551
606
  # A BigQuery job executed by the system to retrieve data.
552
607
  #
553
- # Note: The following fields are mutually exclusive: `big_query_job`, `query`, `generated_sql`, `result`, `generated_looker_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
608
+ # Note: The following fields are mutually exclusive: `big_query_job`, `query`, `generated_sql`, `result`, `generated_looker_query`, `matched_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
609
+ # @!attribute [rw] matched_query
610
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::MatchedQuery]
611
+ # A pre-existing query that was matched to retrieve data.
612
+ #
613
+ # Note: The following fields are mutually exclusive: `matched_query`, `query`, `generated_sql`, `result`, `generated_looker_query`, `big_query_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
554
614
  class DataMessage
555
615
  include ::Google::Protobuf::MessageExts
556
616
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -794,45 +854,65 @@ module Google
794
854
  extend ::Google::Protobuf::MessageExts::ClassMethods
795
855
  end
796
856
 
857
+ # Deprecated: Use TextMessage with TextType.FINAL_RESPONSE instead.
797
858
  # Represents a single question to the user to help clarify their query.
859
+ # @deprecated This message is deprecated and may be removed in the next major version update.
798
860
  # @!attribute [rw] question
861
+ # @deprecated This field is deprecated and may be removed in the next major version update.
799
862
  # @return [::String]
800
- # Required. The natural language question to ask the user.
863
+ # Required. Deprecated: The parent message is deprecated.
864
+ # The natural language question to ask the user.
801
865
  # @!attribute [rw] selection_mode
866
+ # @deprecated This field is deprecated and may be removed in the next major version update.
802
867
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ClarificationQuestion::SelectionMode]
803
- # Required. The selection mode for this question.
868
+ # Required. Deprecated: The parent message is deprecated.
869
+ # The selection mode for this question.
804
870
  # @!attribute [rw] options
871
+ # @deprecated This field is deprecated and may be removed in the next major version update.
805
872
  # @return [::Array<::String>]
806
- # Required. A list of distinct options for the user to choose from.
873
+ # Required. Deprecated: The parent message is deprecated.
874
+ # A list of distinct options for the user to choose from.
807
875
  # The number of options is limited to a maximum of 5.
808
876
  # @!attribute [rw] clarification_question_type
877
+ # @deprecated This field is deprecated and may be removed in the next major version update.
809
878
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ClarificationQuestion::ClarificationQuestionType]
810
- # Optional. The type of clarification question.
879
+ # Optional. Deprecated: The parent message is deprecated.
880
+ # The type of clarification question.
811
881
  class ClarificationQuestion
812
882
  include ::Google::Protobuf::MessageExts
813
883
  extend ::Google::Protobuf::MessageExts::ClassMethods
814
884
 
885
+ # Deprecated: The parent message is deprecated.
815
886
  # The selection mode for the clarification question.
887
+ # @deprecated This enum is deprecated and may be removed in the next major version update.
816
888
  module SelectionMode
889
+ # Deprecated: The parent message is deprecated.
817
890
  # Unspecified selection mode.
818
891
  SELECTION_MODE_UNSPECIFIED = 0
819
892
 
893
+ # Deprecated: The parent message is deprecated.
820
894
  # The user can select only one option.
821
895
  SINGLE_SELECT = 1
822
896
 
897
+ # Deprecated: The parent message is deprecated.
823
898
  # The user can select multiple options.
824
899
  MULTI_SELECT = 2
825
900
  end
826
901
 
902
+ # Deprecated: The parent message is deprecated.
827
903
  # The type of clarification question.
828
904
  # This enum may be extended with new values in the future.
905
+ # @deprecated This enum is deprecated and may be removed in the next major version update.
829
906
  module ClarificationQuestionType
907
+ # Deprecated: The parent message is deprecated.
830
908
  # Unspecified clarification question type.
831
909
  CLARIFICATION_QUESTION_TYPE_UNSPECIFIED = 0
832
910
 
911
+ # Deprecated: The parent message is deprecated.
833
912
  # The clarification question is for filter values.
834
913
  FILTER_VALUES = 1
835
914
 
915
+ # Deprecated: The parent message is deprecated.
836
916
  # The clarification question is for data fields. This is a generic term
837
917
  # encompassing SQL columns, Looker fields (dimensions/measures), or
838
918
  # nested data structure properties.
@@ -840,11 +920,15 @@ module Google
840
920
  end
841
921
  end
842
922
 
923
+ # Deprecated: Use TextMessage with TextType.FINAL_RESPONSE instead.
843
924
  # A message of questions to help clarify the user's query. This is returned
844
925
  # when the system cannot confidently answer the user's question.
926
+ # @deprecated This message is deprecated and may be removed in the next major version update.
845
927
  # @!attribute [rw] questions
928
+ # @deprecated This field is deprecated and may be removed in the next major version update.
846
929
  # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::ClarificationQuestion>]
847
- # Required. A batch of clarification questions to ask the user.
930
+ # Required. Deprecated: The parent message is deprecated.
931
+ # A batch of clarification questions to ask the user.
848
932
  class ClarificationMessage
849
933
  include ::Google::Protobuf::MessageExts
850
934
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -61,11 +61,17 @@ module Google
61
61
  end
62
62
 
63
63
  # Message representing references to BigQuery tables and property graphs.
64
- # At least one of `table_references` or `property_graph_references` must be
65
- # populated.
64
+ # At least one of `table_references`, `property_graph_references`, or
65
+ # `search_scope` must be populated.
66
66
  # @!attribute [rw] table_references
67
67
  # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryTableReference>]
68
68
  # Optional. References to BigQuery tables.
69
+ # @!attribute [rw] property_graph_references
70
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryPropertyGraphReference>]
71
+ # Optional. Preview feature. References to BigQuery property graphs.
72
+ # Note: Data sources must exclusively use either tables or property graphs,
73
+ # not both. When using property graphs, a maximum of one graph reference is
74
+ # supported.
69
75
  class BigQueryTableReferences
70
76
  include ::Google::Protobuf::MessageExts
71
77
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -92,7 +98,7 @@ module Google
92
98
  # Message representing references to Looker Studio datasources.
93
99
  # @!attribute [rw] studio_references
94
100
  # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::StudioDatasourceReference>]
95
- # The references to the studio datasources.
101
+ # Optional. The references to the studio datasources.
96
102
  class StudioDatasourceReferences
97
103
  include ::Google::Protobuf::MessageExts
98
104
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -121,6 +127,43 @@ module Google
121
127
  extend ::Google::Protobuf::MessageExts::ClassMethods
122
128
  end
123
129
 
130
+ # Message representing a table including its schema.
131
+ # @!attribute [rw] table_id
132
+ # @return [::String]
133
+ # Required. The name of the table as defined in the database.
134
+ #
135
+ # Note: The precise rules for table naming, including valid characters,
136
+ # length limits, and case sensitivity, are determined by the specific
137
+ # database system.
138
+ #
139
+ # Requirements:
140
+ # - Exact Match: The provided name must be identical to the name stored
141
+ # in the database.
142
+ # - Case Sensitivity: Respect the case sensitivity rules of the specific
143
+ # database system and how the table was created. For example, "Orders"
144
+ # and "orders" may be distinct table names.
145
+ # - Special Characters/Keywords: If the table name includes spaces, special
146
+ # characters, or is a database reserved keyword, provide the literal name
147
+ # as it is stored. Do not add any database-specific identifier quoting
148
+ # characters (e.g., ", `, []).
149
+ #
150
+ # Examples:
151
+ # - Simple name: "orders", "UserActivity"
152
+ # - Case sensitive: "MyTable"
153
+ # - Name with spaces: "Order Details"
154
+ # - Name with other special characters: "user/data", "order-items"
155
+ # - Name that is a keyword: "Group", "Order"
156
+ #
157
+ # Permissions: The caller's credentials must have the necessary database
158
+ # permissions to access the table's schema and data.
159
+ # @!attribute [rw] schema
160
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Schema]
161
+ # Optional. The schema of the table.
162
+ class DatabaseTableReference
163
+ include ::Google::Protobuf::MessageExts
164
+ extend ::Google::Protobuf::MessageExts::ClassMethods
165
+ end
166
+
124
167
  # Message representing a reference to a single AlloyDB database.
125
168
  # @!attribute [rw] project_id
126
169
  # @return [::String]
@@ -140,6 +183,11 @@ module Google
140
183
  # @!attribute [rw] table_ids
141
184
  # @return [::Array<::String>]
142
185
  # Optional. The table ids. Denotes all tables if unset.
186
+ # @!attribute [rw] database_table_references
187
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::DatabaseTableReference>]
188
+ # Optional. References to tables within the database. Each reference
189
+ # specifies a table and can optionally include the table's schema to provide
190
+ # context for the query.
143
191
  class AlloyDbDatabaseReference
144
192
  include ::Google::Protobuf::MessageExts
145
193
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -166,9 +214,6 @@ module Google
166
214
  # @!attribute [rw] project_id
167
215
  # @return [::String]
168
216
  # Required. The project the instance belongs to.
169
- # @!attribute [rw] region
170
- # @return [::String]
171
- # Required. The region of the instance.
172
217
  # @!attribute [rw] instance_id
173
218
  # @return [::String]
174
219
  # Required. The instance id.
@@ -178,6 +223,22 @@ module Google
178
223
  # @!attribute [rw] table_ids
179
224
  # @return [::Array<::String>]
180
225
  # Optional. The table ids. Denotes all tables if unset.
226
+ # @!attribute [rw] database_table_references
227
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::DatabaseTableReference>]
228
+ # Optional. References to tables within the database. Each reference
229
+ # specifies a table and can optionally include the table's schema to provide
230
+ # context for the query.
231
+ # @!attribute [rw] priority
232
+ # @return [::String]
233
+ # Optional. Priority for the queries to Spanner. Should be a value supported
234
+ # by Cloud Spanner e.g.: LOW, MEDIUM, HIGH. Unsupported values will be
235
+ # ignored. See
236
+ # https://docs.cloud.google.com/spanner/docs/reference/rest/v1/RequestOptions#Priority
237
+ # for complete list.
238
+ # @!attribute [rw] request_tag
239
+ # @return [::String]
240
+ # Tag to be attached to all queries to Spanner. Allows to identify and
241
+ # monitor queries sent to Spanner by the GDA service.
181
242
  class SpannerDatabaseReference
182
243
  include ::Google::Protobuf::MessageExts
183
244
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -228,6 +289,11 @@ module Google
228
289
  # @!attribute [rw] table_ids
229
290
  # @return [::Array<::String>]
230
291
  # Optional. The table ids. Denotes all tables if unset.
292
+ # @!attribute [rw] database_table_references
293
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::DatabaseTableReference>]
294
+ # Optional. References to tables within the database. Each reference
295
+ # specifies a table and can optionally include the table's schema to provide
296
+ # context for the query.
231
297
  class CloudSqlDatabaseReference
232
298
  include ::Google::Protobuf::MessageExts
233
299
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -250,8 +316,10 @@ module Google
250
316
  # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::LookerExploreReference>]
251
317
  # Required. References to Looker explores.
252
318
  # @!attribute [rw] credentials
319
+ # @deprecated This field is deprecated and may be removed in the next major version update.
253
320
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Credentials]
254
- # Optional. The credentials to use when calling the Looker API.
321
+ # Optional. Deprecated: Use credentials in ChatRequest.
322
+ # The credentials to use when calling the Looker API.
255
323
  #
256
324
  # Currently supports both OAuth token and API key-based credentials, as
257
325
  # described in
@@ -293,6 +361,21 @@ module Google
293
361
  extend ::Google::Protobuf::MessageExts::ClassMethods
294
362
  end
295
363
 
364
+ # Message representing a reference to a single BigQuery property graph.
365
+ # @!attribute [rw] project_id
366
+ # @return [::String]
367
+ # Required. The project that the property graph belongs to.
368
+ # @!attribute [rw] dataset_id
369
+ # @return [::String]
370
+ # Required. The dataset that the property graph belongs to.
371
+ # @!attribute [rw] property_graph_id
372
+ # @return [::String]
373
+ # Required. The property graph id.
374
+ class BigQueryPropertyGraphReference
375
+ include ::Google::Protobuf::MessageExts
376
+ extend ::Google::Protobuf::MessageExts::ClassMethods
377
+ end
378
+
296
379
  # Message representing a private Looker instance info required if the Looker
297
380
  # instance is behind a private network.
298
381
  # @!attribute [rw] looker_instance_id
@@ -311,32 +394,37 @@ module Google
311
394
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryTableReference]
312
395
  # A reference to a BigQuery table.
313
396
  #
314
- # Note: The following fields are mutually exclusive: `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.
397
+ # 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.
315
398
  # @!attribute [rw] studio_datasource_id
316
399
  # @return [::String]
317
400
  # A reference to a Looker Studio datasource.
318
401
  #
319
- # Note: The following fields are mutually exclusive: `studio_datasource_id`, `bigquery_table_reference`, `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.
402
+ # 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.
320
403
  # @!attribute [rw] looker_explore_reference
321
404
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::LookerExploreReference]
322
405
  # A reference to a Looker explore.
323
406
  #
324
- # Note: The following fields are mutually exclusive: `looker_explore_reference`, `bigquery_table_reference`, `studio_datasource_id`, `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.
407
+ # 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.
325
408
  # @!attribute [rw] alloy_db_reference
326
409
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AlloyDbReference]
327
410
  # A reference to an AlloyDB database.
328
411
  #
329
- # Note: The following fields are mutually exclusive: `alloy_db_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `spanner_reference`, `cloud_sql_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
412
+ # 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.
330
413
  # @!attribute [rw] spanner_reference
331
414
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::SpannerReference]
332
415
  # A reference to a Spanner database.
333
416
  #
334
- # Note: The following fields are mutually exclusive: `spanner_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `alloy_db_reference`, `cloud_sql_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
417
+ # 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.
335
418
  # @!attribute [rw] cloud_sql_reference
336
419
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::CloudSqlReference]
337
420
  # A reference to a CloudSQL database.
338
421
  #
339
- # Note: The following fields are mutually exclusive: `cloud_sql_reference`, `bigquery_table_reference`, `studio_datasource_id`, `looker_explore_reference`, `alloy_db_reference`, `spanner_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
422
+ # 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.
423
+ # @!attribute [rw] bigquery_property_graph_reference
424
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::BigQueryPropertyGraphReference]
425
+ # A reference to a BigQuery property graph.
426
+ #
427
+ # 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.
340
428
  # @!attribute [rw] schema
341
429
  # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Schema]
342
430
  # Optional. The schema of the datasource.
@@ -418,8 +506,6 @@ module Google
418
506
  # @!attribute [rw] category
419
507
  # @return [::String]
420
508
  # Optional. Field category, not required, currently only useful for Looker.
421
- # We are using a string to avoid depending on an external package and keep
422
- # this package self-contained.
423
509
  # @!attribute [rw] value_format
424
510
  # @return [::String]
425
511
  # Optional. Looker only. Value format of the field.
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-gemini_data_analytics-v1beta
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.9.1
4
+ version: 0.11.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -15,14 +15,14 @@ dependencies:
15
15
  requirements:
16
16
  - - "~>"
17
17
  - !ruby/object:Gem::Version
18
- version: '1.2'
18
+ version: '1.3'
19
19
  type: :runtime
20
20
  prerelease: false
21
21
  version_requirements: !ruby/object:Gem::Requirement
22
22
  requirements:
23
23
  - - "~>"
24
24
  - !ruby/object:Gem::Version
25
- version: '1.2'
25
+ version: '1.3'
26
26
  - !ruby/object:Gem::Dependency
27
27
  name: google-cloud-errors
28
28
  requirement: !ruby/object:Gem::Requirement
@@ -65,8 +65,9 @@ dependencies:
65
65
  - - "~>"
66
66
  - !ruby/object:Gem::Version
67
67
  version: '1.11'
68
- description: google-cloud-gemini_data_analytics-v1beta is the official client library
69
- for the Data Analytics API with Gemini V1BETA API. Note that google-cloud-gemini_data_analytics-v1beta
68
+ description: The Gemini Data Analytics API enables developers to build intelligent
69
+ data analytics applications. Leverage AI-powered chat interfaces to allow users
70
+ to interact with and analyze structured data using natural language. Note that google-cloud-gemini_data_analytics-v1beta
70
71
  is a version-specific client library. For most uses, we recommend installing the
71
72
  main client library google-cloud-gemini_data_analytics instead. See the readme for
72
73
  more details.
@@ -159,5 +160,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
159
160
  requirements: []
160
161
  rubygems_version: 3.6.9
161
162
  specification_version: 4
162
- summary: API Client library for the Data Analytics API with Gemini V1BETA API
163
+ summary: The Gemini Data Analytics API enables developers to build intelligent data
164
+ analytics applications. Leverage AI-powered chat interfaces to allow users to interact
165
+ with and analyze structured data using natural language.
163
166
  test_files: []