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.
- checksums.yaml +4 -4
- data/README.md +3 -3
- data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/client.rb +2 -0
- data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/operations.rb +2 -0
- data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/paths.rb +21 -0
- data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/rest/client.rb +2 -0
- data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/rest/operations.rb +2 -0
- data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/client.rb +26 -7
- data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/paths.rb +21 -0
- data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/rest/client.rb +26 -7
- data/lib/google/cloud/gemini_data_analytics/v1beta/version.rb +1 -1
- data/lib/google/cloud/geminidataanalytics/v1beta/context_pb.rb +13 -1
- data/lib/google/cloud/geminidataanalytics/v1beta/conversation_pb.rb +1 -1
- data/lib/google/cloud/geminidataanalytics/v1beta/data_agent_pb.rb +1 -1
- data/lib/google/cloud/geminidataanalytics/v1beta/data_chat_service_pb.rb +4 -1
- data/lib/google/cloud/geminidataanalytics/v1beta/data_chat_service_services_pb.rb +1 -1
- data/lib/google/cloud/geminidataanalytics/v1beta/datasource_pb.rb +3 -1
- data/proto_docs/google/cloud/geminidataanalytics/v1beta/context.rb +202 -5
- data/proto_docs/google/cloud/geminidataanalytics/v1beta/conversation.rb +14 -2
- data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_agent.rb +6 -0
- data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_chat_service.rb +105 -21
- data/proto_docs/google/cloud/geminidataanalytics/v1beta/datasource.rb +101 -15
- 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::
|
|
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
|
-
|
|
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
|
|
201
|
-
# to 100
|
|
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.
|
|
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.
|
|
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
|
|
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.
|
|
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
|
|
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
|
|
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.
|
|
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
|
|
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.
|
|
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
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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:
|
|
69
|
-
|
|
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:
|
|
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: []
|