google-cloud-gemini_data_analytics-v1beta 1.0.0 → 1.2.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 (71) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +4 -4
  3. data/README.md +5 -6
  4. data/lib/google/cloud/gemini_data_analytics/v1beta/bindings_override.rb +2 -2
  5. data/lib/google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/client.rb +697 -0
  6. data/lib/google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/credentials.rb +47 -0
  7. data/lib/google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/rest/client.rb +643 -0
  8. data/lib/google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/rest/service_stub.rb +283 -0
  9. data/lib/google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/rest.rb +53 -0
  10. data/lib/google/cloud/gemini_data_analytics/v1beta/data_a2_a_service.rb +55 -0
  11. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/client.rb +237 -2
  12. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/credentials.rb +1 -1
  13. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/operations.rb +1 -1
  14. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/paths.rb +1 -1
  15. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/rest/client.rb +223 -2
  16. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/rest/operations.rb +1 -1
  17. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/rest/service_stub.rb +124 -1
  18. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/rest.rb +1 -1
  19. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service.rb +1 -1
  20. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/client.rb +106 -1
  21. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/credentials.rb +1 -1
  22. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/paths.rb +1 -1
  23. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/rest/client.rb +99 -1
  24. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/rest/service_stub.rb +63 -1
  25. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/rest.rb +1 -1
  26. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service.rb +1 -1
  27. data/lib/google/cloud/gemini_data_analytics/v1beta/rest.rb +3 -2
  28. data/lib/google/cloud/gemini_data_analytics/v1beta/version.rb +1 -1
  29. data/lib/google/cloud/gemini_data_analytics/v1beta.rb +4 -3
  30. data/lib/google/cloud/geminidataanalytics/v1beta/context_pb.rb +2 -1
  31. data/lib/google/cloud/geminidataanalytics/v1beta/conversation_pb.rb +3 -1
  32. data/lib/google/cloud/geminidataanalytics/v1beta/data_a2a_service_pb.rb +64 -0
  33. data/lib/google/cloud/geminidataanalytics/v1beta/data_a2a_service_services_pb.rb +52 -0
  34. data/lib/google/cloud/geminidataanalytics/v1beta/data_agent_pb.rb +2 -1
  35. data/lib/google/cloud/geminidataanalytics/v1beta/data_agent_service_pb.rb +6 -1
  36. data/lib/google/cloud/geminidataanalytics/v1beta/data_agent_service_services_pb.rb +7 -1
  37. data/lib/google/cloud/geminidataanalytics/v1beta/data_chat_service_pb.rb +2 -1
  38. data/lib/google/cloud/geminidataanalytics/v1beta/data_chat_service_services_pb.rb +3 -1
  39. data/lib/google/cloud/geminidataanalytics/v1beta/datasource_pb.rb +5 -1
  40. data/lib/google/cloud/geminidataanalytics/v1beta/usage_pb.rb +21 -0
  41. data/lib/google-cloud-gemini_data_analytics-v1beta.rb +1 -1
  42. data/proto_docs/google/api/client.rb +1 -1
  43. data/proto_docs/google/api/field_behavior.rb +1 -1
  44. data/proto_docs/google/api/field_info.rb +1 -1
  45. data/proto_docs/google/api/launch_stage.rb +1 -1
  46. data/proto_docs/google/api/resource.rb +1 -1
  47. data/proto_docs/google/cloud/geminidataanalytics/v1beta/agent_context.rb +1 -1
  48. data/proto_docs/google/cloud/geminidataanalytics/v1beta/context.rb +83 -2
  49. data/proto_docs/google/cloud/geminidataanalytics/v1beta/conversation.rb +28 -4
  50. data/proto_docs/google/cloud/geminidataanalytics/v1beta/credentials.rb +1 -1
  51. data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_a2a_service.rb +825 -0
  52. data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_agent.rb +52 -1
  53. data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_agent_service.rb +101 -1
  54. data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_analytics_agent.rb +1 -1
  55. data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_chat_service.rb +23 -4
  56. data/proto_docs/google/cloud/geminidataanalytics/v1beta/datasource.rb +108 -18
  57. data/proto_docs/google/cloud/geminidataanalytics/v1beta/usage.rb +38 -0
  58. data/proto_docs/google/iam/v1/iam_policy.rb +1 -1
  59. data/proto_docs/google/iam/v1/options.rb +1 -1
  60. data/proto_docs/google/iam/v1/policy.rb +1 -1
  61. data/proto_docs/google/longrunning/operations.rb +1 -1
  62. data/proto_docs/google/protobuf/any.rb +1 -1
  63. data/proto_docs/google/protobuf/duration.rb +1 -1
  64. data/proto_docs/google/protobuf/empty.rb +1 -1
  65. data/proto_docs/google/protobuf/field_mask.rb +1 -1
  66. data/proto_docs/google/protobuf/struct.rb +1 -1
  67. data/proto_docs/google/protobuf/timestamp.rb +8 -7
  68. data/proto_docs/google/protobuf/wrappers.rb +1 -1
  69. data/proto_docs/google/rpc/status.rb +1 -1
  70. data/proto_docs/google/type/expr.rb +1 -1
  71. metadata +20 -7
@@ -0,0 +1,283 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2026 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/geminidataanalytics/v1beta/data_a2a_service_pb"
20
+
21
+ module Google
22
+ module Cloud
23
+ module GeminiDataAnalytics
24
+ module V1beta
25
+ module DataA2AService
26
+ module Rest
27
+ ##
28
+ # REST service stub for the DataA2AService service.
29
+ # Service stub contains baseline method implementations
30
+ # including transcoding, making the REST call, and deserialing the response.
31
+ #
32
+ class ServiceStub
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
35
+ # These require statements are intentionally placed here to initialize
36
+ # the REST modules only when it's required.
37
+ require "gapic/rest"
38
+
39
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
40
+ endpoint_template: endpoint_template,
41
+ universe_domain: universe_domain,
42
+ credentials: credentials,
43
+ numeric_enums: true,
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
47
+ end
48
+
49
+ ##
50
+ # The effective universe domain
51
+ #
52
+ # @return [String]
53
+ #
54
+ def universe_domain
55
+ @client_stub.universe_domain
56
+ end
57
+
58
+ ##
59
+ # The effective endpoint
60
+ #
61
+ # @return [String]
62
+ #
63
+ def endpoint
64
+ @client_stub.endpoint
65
+ end
66
+
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
76
+ ##
77
+ # Baseline implementation for the send_message REST call
78
+ #
79
+ # @param request_pb [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageRequest]
80
+ # A request object representing the call parameters. Required.
81
+ # @param options [::Gapic::CallOptions]
82
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
83
+ #
84
+ # @yield [result, operation] Access the result along with the TransportOperation object
85
+ # @yieldparam result [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageResponse]
86
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
87
+ #
88
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageResponse]
89
+ # A result object deserialized from the server's reply
90
+ def send_message request_pb, options = nil
91
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
92
+
93
+ verb, uri, query_string_params, body = ServiceStub.transcode_send_message_request request_pb
94
+ query_string_params = if query_string_params.any?
95
+ query_string_params.to_h { |p| p.split "=", 2 }
96
+ else
97
+ {}
98
+ end
99
+
100
+ response = @client_stub.make_http_request(
101
+ verb,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "send_message",
106
+ options: options
107
+ )
108
+ operation = ::Gapic::Rest::TransportOperation.new response
109
+ result = ::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageResponse.decode_json response.body, ignore_unknown_fields: true
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
114
+ end
115
+
116
+ ##
117
+ # Baseline implementation for the send_streaming_message REST call
118
+ #
119
+ # @param request_pb [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageRequest]
120
+ # A request object representing the call parameters. Required.
121
+ # @param options [::Gapic::CallOptions]
122
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
123
+ #
124
+ # @yieldparam chunk [::String] The chunk of data received during server streaming.
125
+ #
126
+ # @return [::Gapic::Rest::TransportOperation]
127
+ def send_streaming_message(request_pb, options = nil, &)
128
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
129
+
130
+ verb, uri, query_string_params, body = ServiceStub.transcode_send_streaming_message_request request_pb
131
+ query_string_params = if query_string_params.any?
132
+ query_string_params.to_h { |p| p.split "=", 2 }
133
+ else
134
+ {}
135
+ end
136
+
137
+ response = @client_stub.make_http_request(
138
+ verb,
139
+ uri: uri,
140
+ body: body || "",
141
+ params: query_string_params,
142
+ method_name: "send_streaming_message",
143
+ options: options,
144
+ is_server_streaming: true,
145
+ &
146
+ )
147
+ ::Gapic::Rest::TransportOperation.new response
148
+ end
149
+
150
+ ##
151
+ # Baseline implementation for the get_agent_card REST call
152
+ #
153
+ # @param request_pb [::Google::Cloud::GeminiDataAnalytics::V1beta::GetAgentCardRequest]
154
+ # A request object representing the call parameters. Required.
155
+ # @param options [::Gapic::CallOptions]
156
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
157
+ #
158
+ # @yield [result, operation] Access the result along with the TransportOperation object
159
+ # @yieldparam result [::Google::Cloud::GeminiDataAnalytics::V1beta::AgentCard]
160
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
161
+ #
162
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AgentCard]
163
+ # A result object deserialized from the server's reply
164
+ def get_agent_card request_pb, options = nil
165
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
166
+
167
+ verb, uri, query_string_params, body = ServiceStub.transcode_get_agent_card_request request_pb
168
+ query_string_params = if query_string_params.any?
169
+ query_string_params.to_h { |p| p.split "=", 2 }
170
+ else
171
+ {}
172
+ end
173
+
174
+ response = @client_stub.make_http_request(
175
+ verb,
176
+ uri: uri,
177
+ body: body || "",
178
+ params: query_string_params,
179
+ method_name: "get_agent_card",
180
+ options: options
181
+ )
182
+ operation = ::Gapic::Rest::TransportOperation.new response
183
+ result = ::Google::Cloud::GeminiDataAnalytics::V1beta::AgentCard.decode_json response.body, ignore_unknown_fields: true
184
+ catch :response do
185
+ yield result, operation if block_given?
186
+ result
187
+ end
188
+ end
189
+
190
+ ##
191
+ # @private
192
+ #
193
+ # GRPC transcoding helper method for the send_message REST call
194
+ #
195
+ # @param request_pb [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageRequest]
196
+ # A request object representing the call parameters. Required.
197
+ # @return [Array(String, [String, nil], Hash{String => String})]
198
+ # Uri, Body, Query string parameters
199
+ def self.transcode_send_message_request request_pb
200
+ transcoder = Gapic::Rest::GrpcTranscoder.new
201
+ .with_bindings(
202
+ uri_method: :post,
203
+ uri_template: "/v1beta/a2a/{tenant}/v1/message:send",
204
+ body: "*",
205
+ matches: [
206
+ ["tenant", %r{^projects/[^/]+/locations/[^/]+/agents/[^/]+/?$}, false]
207
+ ]
208
+ )
209
+ .with_bindings(
210
+ uri_method: :post,
211
+ uri_template: "/v1beta/a2a/{tenant}/v1/message:send",
212
+ body: "*",
213
+ matches: [
214
+ ["tenant", %r{^projects/[^/]+/locations/[^/]+/dataAgents/[^/]+/?$}, false]
215
+ ]
216
+ )
217
+ transcoder.transcode request_pb
218
+ end
219
+
220
+ ##
221
+ # @private
222
+ #
223
+ # GRPC transcoding helper method for the send_streaming_message REST call
224
+ #
225
+ # @param request_pb [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageRequest]
226
+ # A request object representing the call parameters. Required.
227
+ # @return [Array(String, [String, nil], Hash{String => String})]
228
+ # Uri, Body, Query string parameters
229
+ def self.transcode_send_streaming_message_request request_pb
230
+ transcoder = Gapic::Rest::GrpcTranscoder.new
231
+ .with_bindings(
232
+ uri_method: :post,
233
+ uri_template: "/v1beta/a2a/{tenant}/v1/message:stream",
234
+ body: "*",
235
+ matches: [
236
+ ["tenant", %r{^projects/[^/]+/locations/[^/]+/agents/[^/]+/?$}, false]
237
+ ]
238
+ )
239
+ .with_bindings(
240
+ uri_method: :post,
241
+ uri_template: "/v1beta/a2a/{tenant}/v1/message:stream",
242
+ body: "*",
243
+ matches: [
244
+ ["tenant", %r{^projects/[^/]+/locations/[^/]+/dataAgents/[^/]+/?$}, false]
245
+ ]
246
+ )
247
+ transcoder.transcode request_pb
248
+ end
249
+
250
+ ##
251
+ # @private
252
+ #
253
+ # GRPC transcoding helper method for the get_agent_card REST call
254
+ #
255
+ # @param request_pb [::Google::Cloud::GeminiDataAnalytics::V1beta::GetAgentCardRequest]
256
+ # A request object representing the call parameters. Required.
257
+ # @return [Array(String, [String, nil], Hash{String => String})]
258
+ # Uri, Body, Query string parameters
259
+ def self.transcode_get_agent_card_request request_pb
260
+ transcoder = Gapic::Rest::GrpcTranscoder.new
261
+ .with_bindings(
262
+ uri_method: :get,
263
+ uri_template: "/v1beta/a2a/{tenant}/v1/card",
264
+ matches: [
265
+ ["tenant", %r{^projects/[^/]+/locations/[^/]+/agents/[^/]+/?$}, false]
266
+ ]
267
+ )
268
+ .with_bindings(
269
+ uri_method: :get,
270
+ uri_template: "/v1beta/a2a/{tenant}/v1/card",
271
+ matches: [
272
+ ["tenant", %r{^projects/[^/]+/locations/[^/]+/dataAgents/[^/]+/?$}, false]
273
+ ]
274
+ )
275
+ transcoder.transcode request_pb
276
+ end
277
+ end
278
+ end
279
+ end
280
+ end
281
+ end
282
+ end
283
+ end
@@ -0,0 +1,53 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2026 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "gapic/rest"
20
+ require "gapic/config"
21
+ require "gapic/config/method"
22
+
23
+ require "google/cloud/gemini_data_analytics/v1beta/version"
24
+ require "google/cloud/gemini_data_analytics/v1beta/bindings_override"
25
+
26
+ require "google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/credentials"
27
+ require "google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/rest/client"
28
+
29
+ module Google
30
+ module Cloud
31
+ module GeminiDataAnalytics
32
+ module V1beta
33
+ ##
34
+ # DataA2AService defines the Agent-to-Agent (A2A) protocol service for Gemini
35
+ # Data Analytics.
36
+ #
37
+ # To load this service and instantiate a REST client:
38
+ #
39
+ # require "google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/rest"
40
+ # client = ::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Rest::Client.new
41
+ #
42
+ module DataA2AService
43
+ # Client for the REST transport
44
+ module Rest
45
+ end
46
+ end
47
+ end
48
+ end
49
+ end
50
+ end
51
+
52
+ helper_path = ::File.join __dir__, "rest", "helpers.rb"
53
+ require "google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/rest/helpers" if ::File.file? helper_path
@@ -0,0 +1,55 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2026 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "gapic/common"
20
+ require "gapic/config"
21
+ require "gapic/config/method"
22
+
23
+ require "google/cloud/gemini_data_analytics/v1beta/version"
24
+
25
+ require "google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/credentials"
26
+ require "google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/client"
27
+ require "google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/rest"
28
+
29
+ module Google
30
+ module Cloud
31
+ module GeminiDataAnalytics
32
+ module V1beta
33
+ ##
34
+ # DataA2AService defines the Agent-to-Agent (A2A) protocol service for Gemini
35
+ # Data Analytics.
36
+ #
37
+ # @example Load this service and instantiate a gRPC client
38
+ #
39
+ # require "google/cloud/gemini_data_analytics/v1beta/data_a2_a_service"
40
+ # client = ::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client.new
41
+ #
42
+ # @example Load this service and instantiate a REST client
43
+ #
44
+ # require "google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/rest"
45
+ # client = ::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Rest::Client.new
46
+ #
47
+ module DataA2AService
48
+ end
49
+ end
50
+ end
51
+ end
52
+ end
53
+
54
+ helper_path = ::File.join __dir__, "data_a2_a_service", "helpers.rb"
55
+ require "google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/helpers" if ::File.file? helper_path
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2025 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -231,7 +231,7 @@ module Google
231
231
  # @param options [::Gapic::CallOptions, ::Hash]
232
232
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
233
233
  #
234
- # @overload list_data_agents(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil, show_deleted: nil)
234
+ # @overload list_data_agents(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil, show_deleted: nil, creator_filter: nil)
235
235
  # Pass arguments to `list_data_agents` via keyword arguments. Note that at
236
236
  # least one keyword argument is required. To specify no parameters, or to keep all
237
237
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -256,6 +256,8 @@ module Google
256
256
  # @param show_deleted [::Boolean]
257
257
  # Optional. If true, the list results will include soft-deleted DataAgents.
258
258
  # Defaults to false.
259
+ # @param creator_filter [::Google::Cloud::GeminiDataAnalytics::V1beta::ListAccessibleDataAgentsRequest::CreatorFilter]
260
+ # Optional. Filter for the creator of the agent.
259
261
  #
260
262
  # @yield [response, operation] Access the result along with the RPC operation
261
263
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::GeminiDataAnalytics::V1beta::DataAgent>]
@@ -1359,6 +1361,225 @@ module Google
1359
1361
  raise ::Google::Cloud::Error.from_error(e)
1360
1362
  end
1361
1363
 
1364
+ ##
1365
+ # Enables/Disables required GCP services and configures AgentOps
1366
+ # observability settings calling the Admin Settings executable node to
1367
+ # update the AgentOps Observability feature.
1368
+ #
1369
+ # @overload set_agent_ops_observability(request, options = nil)
1370
+ # Pass arguments to `set_agent_ops_observability` via a request object, either of type
1371
+ # {::Google::Cloud::GeminiDataAnalytics::V1beta::SetAgentOpsObservabilityRequest} or an equivalent Hash.
1372
+ #
1373
+ # @param request [::Google::Cloud::GeminiDataAnalytics::V1beta::SetAgentOpsObservabilityRequest, ::Hash]
1374
+ # A request object representing the call parameters. Required. To specify no
1375
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1376
+ # @param options [::Gapic::CallOptions, ::Hash]
1377
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1378
+ #
1379
+ # @overload set_agent_ops_observability(parent: nil, telemetry_enabled: nil, data_source_type: nil, bqaa_enabled: nil, update_mask: nil)
1380
+ # Pass arguments to `set_agent_ops_observability` via keyword arguments. Note that at
1381
+ # least one keyword argument is required. To specify no parameters, or to keep all
1382
+ # the default parameter values, pass an empty Hash as a request object (see above).
1383
+ #
1384
+ # @param parent [::String]
1385
+ # Required. Parent value for SetAgentOpsObservabilityRequest.
1386
+ # Format: projects/\\{project}/locations/\\{location}
1387
+ # @param telemetry_enabled [::Boolean]
1388
+ # Optional. Whether to enable or disable AgentOps observability.
1389
+ # When update_mask is provided, this field is ignored unless specified in the
1390
+ # mask.
1391
+ # @param data_source_type [::String]
1392
+ # Required. The data source type for which to set observability settings.
1393
+ # Examples: "bigquery", "looker"
1394
+ # @param bqaa_enabled [::Boolean]
1395
+ # Optional. Whether BigQuery Agent Analytics is enabled.
1396
+ # Note: An explicit `update_mask` containing "bqaa_enabled" is required to
1397
+ # modify this field. If `update_mask` is omitted, this field is ignored and
1398
+ # an existing enabled setting cannot be disabled.
1399
+ #
1400
+ # This is a project-level setting and does not by itself enable trace
1401
+ # logging for any individual agent. Per-agent trace logging is controlled
1402
+ # by `DataAgent.bigquery_agent_analytics_enabled` together with
1403
+ # `DataAgent.bigquery_agent_analytics_table`; an agent does not inherit
1404
+ # this setting.
1405
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1406
+ # Optional. Field mask is used to specify the fields to be overwritten by the
1407
+ # update. The fields specified in the update_mask are relative to the
1408
+ # resource. A field will be overwritten if it is in the mask.
1409
+ #
1410
+ # If the user does not provide a mask, only `telemetry_enabled` will be
1411
+ # updated (for backward compatibility with legacy callers). Note that
1412
+ # disabling BigQuery Agent Analytics (`bqaa_enabled = false`) requires
1413
+ # providing an explicit `update_mask` containing "bqaa_enabled".
1414
+ #
1415
+ # Per AIP-161:
1416
+ # - The special wildcard value '*' is supported to update all fields.
1417
+ # - Field paths should use snake_case, though camelCase equivalents
1418
+ # (`telemetryEnabled`, `bqaaEnabled`) are accepted for REST/JSON
1419
+ # transcoding compatibility.
1420
+ #
1421
+ # @yield [response, operation] Access the result along with the RPC operation
1422
+ # @yieldparam response [::Gapic::Operation]
1423
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1424
+ #
1425
+ # @return [::Gapic::Operation]
1426
+ #
1427
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1428
+ #
1429
+ # @example Basic example
1430
+ # require "google/cloud/gemini_data_analytics/v1beta"
1431
+ #
1432
+ # # Create a client object. The client can be reused for multiple calls.
1433
+ # client = Google::Cloud::GeminiDataAnalytics::V1beta::DataAgentService::Client.new
1434
+ #
1435
+ # # Create a request. To set request fields, pass in keyword arguments.
1436
+ # request = Google::Cloud::GeminiDataAnalytics::V1beta::SetAgentOpsObservabilityRequest.new
1437
+ #
1438
+ # # Call the set_agent_ops_observability method.
1439
+ # result = client.set_agent_ops_observability request
1440
+ #
1441
+ # # The returned object is of type Gapic::Operation. You can use it to
1442
+ # # check the status of an operation, cancel it, or wait for results.
1443
+ # # Here is how to wait for a response.
1444
+ # result.wait_until_done! timeout: 60
1445
+ # if result.response?
1446
+ # p result.response
1447
+ # else
1448
+ # puts "No response received."
1449
+ # end
1450
+ #
1451
+ def set_agent_ops_observability request, options = nil
1452
+ raise ::ArgumentError, "request must be provided" if request.nil?
1453
+
1454
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::GeminiDataAnalytics::V1beta::SetAgentOpsObservabilityRequest
1455
+
1456
+ # Converts hash and nil to an options object
1457
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1458
+
1459
+ # Customize the options with defaults
1460
+ metadata = @config.rpcs.set_agent_ops_observability.metadata.to_h
1461
+
1462
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1463
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1464
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1465
+ gapic_version: ::Google::Cloud::GeminiDataAnalytics::V1beta::VERSION
1466
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1467
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1468
+
1469
+ header_params = {}
1470
+ if request.parent
1471
+ header_params["parent"] = request.parent
1472
+ end
1473
+
1474
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1475
+ metadata[:"x-goog-request-params"] ||= request_params_header
1476
+
1477
+ options.apply_defaults timeout: @config.rpcs.set_agent_ops_observability.timeout,
1478
+ metadata: metadata,
1479
+ retry_policy: @config.rpcs.set_agent_ops_observability.retry_policy
1480
+
1481
+ options.apply_defaults timeout: @config.timeout,
1482
+ metadata: @config.metadata,
1483
+ retry_policy: @config.retry_policy
1484
+
1485
+ @data_agent_service_stub.call_rpc :set_agent_ops_observability, request, options: options do |response, operation|
1486
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1487
+ yield response, operation if block_given?
1488
+ throw :response, response
1489
+ end
1490
+ rescue ::GRPC::BadStatus => e
1491
+ raise ::Google::Cloud::Error.from_error(e)
1492
+ end
1493
+
1494
+ ##
1495
+ # Gets AgentOps observability settings and status of required services.
1496
+ #
1497
+ # @overload retrieve_agent_ops_observability(request, options = nil)
1498
+ # Pass arguments to `retrieve_agent_ops_observability` via a request object, either of type
1499
+ # {::Google::Cloud::GeminiDataAnalytics::V1beta::RetrieveAgentOpsObservabilityRequest} or an equivalent Hash.
1500
+ #
1501
+ # @param request [::Google::Cloud::GeminiDataAnalytics::V1beta::RetrieveAgentOpsObservabilityRequest, ::Hash]
1502
+ # A request object representing the call parameters. Required. To specify no
1503
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1504
+ # @param options [::Gapic::CallOptions, ::Hash]
1505
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1506
+ #
1507
+ # @overload retrieve_agent_ops_observability(parent: nil, data_source_type: nil)
1508
+ # Pass arguments to `retrieve_agent_ops_observability` via keyword arguments. Note that at
1509
+ # least one keyword argument is required. To specify no parameters, or to keep all
1510
+ # the default parameter values, pass an empty Hash as a request object (see above).
1511
+ #
1512
+ # @param parent [::String]
1513
+ # Required. Parent value for RetrieveAgentOpsObservabilityRequest.
1514
+ # Format: projects/\\{project}/locations/\\{location}
1515
+ # @param data_source_type [::String]
1516
+ # Required. The data source type for which to retrieve observability
1517
+ # settings. Examples: "bigquery", "looker"
1518
+ #
1519
+ # @yield [response, operation] Access the result along with the RPC operation
1520
+ # @yieldparam response [::Google::Cloud::GeminiDataAnalytics::V1beta::RetrieveAgentOpsObservabilityResponse]
1521
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1522
+ #
1523
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::RetrieveAgentOpsObservabilityResponse]
1524
+ #
1525
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1526
+ #
1527
+ # @example Basic example
1528
+ # require "google/cloud/gemini_data_analytics/v1beta"
1529
+ #
1530
+ # # Create a client object. The client can be reused for multiple calls.
1531
+ # client = Google::Cloud::GeminiDataAnalytics::V1beta::DataAgentService::Client.new
1532
+ #
1533
+ # # Create a request. To set request fields, pass in keyword arguments.
1534
+ # request = Google::Cloud::GeminiDataAnalytics::V1beta::RetrieveAgentOpsObservabilityRequest.new
1535
+ #
1536
+ # # Call the retrieve_agent_ops_observability method.
1537
+ # result = client.retrieve_agent_ops_observability request
1538
+ #
1539
+ # # The returned object is of type Google::Cloud::GeminiDataAnalytics::V1beta::RetrieveAgentOpsObservabilityResponse.
1540
+ # p result
1541
+ #
1542
+ def retrieve_agent_ops_observability request, options = nil
1543
+ raise ::ArgumentError, "request must be provided" if request.nil?
1544
+
1545
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::GeminiDataAnalytics::V1beta::RetrieveAgentOpsObservabilityRequest
1546
+
1547
+ # Converts hash and nil to an options object
1548
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1549
+
1550
+ # Customize the options with defaults
1551
+ metadata = @config.rpcs.retrieve_agent_ops_observability.metadata.to_h
1552
+
1553
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1554
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1555
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1556
+ gapic_version: ::Google::Cloud::GeminiDataAnalytics::V1beta::VERSION
1557
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1558
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1559
+
1560
+ header_params = {}
1561
+ if request.parent
1562
+ header_params["parent"] = request.parent
1563
+ end
1564
+
1565
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1566
+ metadata[:"x-goog-request-params"] ||= request_params_header
1567
+
1568
+ options.apply_defaults timeout: @config.rpcs.retrieve_agent_ops_observability.timeout,
1569
+ metadata: metadata,
1570
+ retry_policy: @config.rpcs.retrieve_agent_ops_observability.retry_policy
1571
+
1572
+ options.apply_defaults timeout: @config.timeout,
1573
+ metadata: @config.metadata,
1574
+ retry_policy: @config.retry_policy
1575
+
1576
+ @data_agent_service_stub.call_rpc :retrieve_agent_ops_observability, request, options: options do |response, operation|
1577
+ yield response, operation if block_given?
1578
+ end
1579
+ rescue ::GRPC::BadStatus => e
1580
+ raise ::Google::Cloud::Error.from_error(e)
1581
+ end
1582
+
1362
1583
  ##
1363
1584
  # Configuration class for the DataAgentService API.
1364
1585
  #
@@ -1599,6 +1820,16 @@ module Google
1599
1820
  # @return [::Gapic::Config::Method]
1600
1821
  #
1601
1822
  attr_reader :set_iam_policy
1823
+ ##
1824
+ # RPC-specific configuration for `set_agent_ops_observability`
1825
+ # @return [::Gapic::Config::Method]
1826
+ #
1827
+ attr_reader :set_agent_ops_observability
1828
+ ##
1829
+ # RPC-specific configuration for `retrieve_agent_ops_observability`
1830
+ # @return [::Gapic::Config::Method]
1831
+ #
1832
+ attr_reader :retrieve_agent_ops_observability
1602
1833
 
1603
1834
  # @private
1604
1835
  def initialize parent_rpcs = nil
@@ -1624,6 +1855,10 @@ module Google
1624
1855
  @get_iam_policy = ::Gapic::Config::Method.new get_iam_policy_config
1625
1856
  set_iam_policy_config = parent_rpcs.set_iam_policy if parent_rpcs.respond_to? :set_iam_policy
1626
1857
  @set_iam_policy = ::Gapic::Config::Method.new set_iam_policy_config
1858
+ set_agent_ops_observability_config = parent_rpcs.set_agent_ops_observability if parent_rpcs.respond_to? :set_agent_ops_observability
1859
+ @set_agent_ops_observability = ::Gapic::Config::Method.new set_agent_ops_observability_config
1860
+ retrieve_agent_ops_observability_config = parent_rpcs.retrieve_agent_ops_observability if parent_rpcs.respond_to? :retrieve_agent_ops_observability
1861
+ @retrieve_agent_ops_observability = ::Gapic::Config::Method.new retrieve_agent_ops_observability_config
1627
1862
 
1628
1863
  yield self if block_given?
1629
1864
  end