google-cloud-gemini_data_analytics-v1beta 0.11.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,697 @@
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/errors"
20
+ require "google/cloud/geminidataanalytics/v1beta/data_a2a_service_pb"
21
+ require "google/cloud/location"
22
+
23
+ module Google
24
+ module Cloud
25
+ module GeminiDataAnalytics
26
+ module V1beta
27
+ module DataA2AService
28
+ ##
29
+ # Client for the DataA2AService service.
30
+ #
31
+ # DataA2AService defines the Agent-to-Agent (A2A) protocol service for Gemini
32
+ # Data Analytics.
33
+ #
34
+ class Client
35
+ # @private
36
+ API_VERSION = ""
37
+
38
+ # @private
39
+ DEFAULT_ENDPOINT_TEMPLATE = "geminidataanalytics.$UNIVERSE_DOMAIN$"
40
+
41
+ # @private
42
+ attr_reader :data_a2_a_service_stub
43
+
44
+ ##
45
+ # Configure the DataA2AService Client class.
46
+ #
47
+ # See {::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client::Configuration}
48
+ # for a description of the configuration fields.
49
+ #
50
+ # @example
51
+ #
52
+ # # Modify the configuration for all DataA2AService clients
53
+ # ::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client.configure do |config|
54
+ # config.timeout = 10.0
55
+ # end
56
+ #
57
+ # @yield [config] Configure the Client client.
58
+ # @yieldparam config [Client::Configuration]
59
+ #
60
+ # @return [Client::Configuration]
61
+ #
62
+ def self.configure
63
+ @configure ||= begin
64
+ namespace = ["Google", "Cloud", "GeminiDataAnalytics", "V1beta"]
65
+ parent_config = while namespace.any?
66
+ parent_name = namespace.join "::"
67
+ parent_const = const_get parent_name
68
+ break parent_const.configure if parent_const.respond_to? :configure
69
+ namespace.pop
70
+ end
71
+ default_config = Client::Configuration.new parent_config
72
+
73
+ default_config.timeout = 600.0
74
+ default_config.retry_policy = {
75
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
76
+ }
77
+
78
+ default_config
79
+ end
80
+ yield @configure if block_given?
81
+ @configure
82
+ end
83
+
84
+ ##
85
+ # Configure the DataA2AService Client instance.
86
+ #
87
+ # The configuration is set to the derived mode, meaning that values can be changed,
88
+ # but structural changes (adding new fields, etc.) are not allowed. Structural changes
89
+ # should be made on {Client.configure}.
90
+ #
91
+ # See {::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client::Configuration}
92
+ # for a description of the configuration fields.
93
+ #
94
+ # @yield [config] Configure the Client client.
95
+ # @yieldparam config [Client::Configuration]
96
+ #
97
+ # @return [Client::Configuration]
98
+ #
99
+ def configure
100
+ yield @config if block_given?
101
+ @config
102
+ end
103
+
104
+ ##
105
+ # The effective universe domain
106
+ #
107
+ # @return [String]
108
+ #
109
+ def universe_domain
110
+ @data_a2_a_service_stub.universe_domain
111
+ end
112
+
113
+ ##
114
+ # Create a new DataA2AService client object.
115
+ #
116
+ # @example
117
+ #
118
+ # # Create a client using the default configuration
119
+ # client = ::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client.new
120
+ #
121
+ # # Create a client using a custom configuration
122
+ # client = ::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client.new do |config|
123
+ # config.timeout = 10.0
124
+ # end
125
+ #
126
+ # @yield [config] Configure the DataA2AService client.
127
+ # @yieldparam config [Client::Configuration]
128
+ #
129
+ def initialize
130
+ # These require statements are intentionally placed here to initialize
131
+ # the gRPC module only when it's required.
132
+ # See https://github.com/googleapis/toolkit/issues/446
133
+ require "gapic/grpc"
134
+ require "google/cloud/geminidataanalytics/v1beta/data_a2a_service_services_pb"
135
+
136
+ # Create the configuration object
137
+ @config = Configuration.new Client.configure
138
+
139
+ # Yield the configuration if needed
140
+ yield @config if block_given?
141
+
142
+ # Create credentials
143
+ credentials = @config.credentials
144
+ # Use self-signed JWT if the endpoint is unchanged from default,
145
+ # but only if the default endpoint does not have a region prefix.
146
+ enable_self_signed_jwt = @config.endpoint.nil? ||
147
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
148
+ !@config.endpoint.split(".").first.include?("-"))
149
+ credentials ||= Credentials.default scope: @config.scope,
150
+ enable_self_signed_jwt: enable_self_signed_jwt
151
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
152
+ credentials = Credentials.new credentials, scope: @config.scope
153
+ end
154
+ @quota_project_id = @config.quota_project
155
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
156
+
157
+ @data_a2_a_service_stub = ::Gapic::ServiceStub.new(
158
+ ::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Stub,
159
+ credentials: credentials,
160
+ endpoint: @config.endpoint,
161
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
162
+ universe_domain: @config.universe_domain,
163
+ channel_args: @config.channel_args,
164
+ interceptors: @config.interceptors,
165
+ channel_pool_config: @config.channel_pool,
166
+ logger: @config.logger
167
+ )
168
+
169
+ @data_a2_a_service_stub.stub_logger&.info do |entry|
170
+ entry.set_system_name
171
+ entry.set_service
172
+ entry.message = "Created client for #{entry.service}"
173
+ entry.set_credentials_fields credentials
174
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
175
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
176
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
177
+ end
178
+
179
+ @location_client = Google::Cloud::Location::Locations::Client.new do |config|
180
+ config.credentials = credentials
181
+ config.quota_project = @quota_project_id
182
+ config.endpoint = @data_a2_a_service_stub.endpoint
183
+ config.universe_domain = @data_a2_a_service_stub.universe_domain
184
+ config.logger = @data_a2_a_service_stub.logger if config.respond_to? :logger=
185
+ end
186
+ end
187
+
188
+ ##
189
+ # Get the associated client for mix-in of the Locations.
190
+ #
191
+ # @return [Google::Cloud::Location::Locations::Client]
192
+ #
193
+ attr_reader :location_client
194
+
195
+ ##
196
+ # The logger used for request/response debug logging.
197
+ #
198
+ # @return [Logger]
199
+ #
200
+ def logger
201
+ @data_a2_a_service_stub.logger
202
+ end
203
+
204
+ # Service calls
205
+
206
+ ##
207
+ # Send a message to the agent. This is a blocking call that will return the
208
+ # task once it is completed.
209
+ #
210
+ # @overload send_message(request, options = nil)
211
+ # Pass arguments to `send_message` via a request object, either of type
212
+ # {::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageRequest} or an equivalent Hash.
213
+ #
214
+ # @param request [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageRequest, ::Hash]
215
+ # A request object representing the call parameters. Required. To specify no
216
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
217
+ # @param options [::Gapic::CallOptions, ::Hash]
218
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
219
+ #
220
+ # @overload send_message(message: nil, configuration: nil, metadata: nil, tenant: nil)
221
+ # Pass arguments to `send_message` via keyword arguments. Note that at
222
+ # least one keyword argument is required. To specify no parameters, or to keep all
223
+ # the default parameter values, pass an empty Hash as a request object (see above).
224
+ #
225
+ # @param message [::Google::Cloud::GeminiDataAnalytics::V1beta::A2AMessage, ::Hash]
226
+ # Required. The message to send to the agent.
227
+ # @param configuration [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageConfiguration, ::Hash]
228
+ # Optional. Configuration for the send request.
229
+ # @param metadata [::Google::Protobuf::Struct, ::Hash]
230
+ # Optional. Optional metadata for the request.
231
+ # @param tenant [::String]
232
+ # Optional. Optional tenant, provided as a path parameter.
233
+ #
234
+ # @yield [response, operation] Access the result along with the RPC operation
235
+ # @yieldparam response [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageResponse]
236
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
237
+ #
238
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageResponse]
239
+ #
240
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
241
+ #
242
+ # @example Basic example
243
+ # require "google/cloud/gemini_data_analytics/v1beta"
244
+ #
245
+ # # Create a client object. The client can be reused for multiple calls.
246
+ # client = Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client.new
247
+ #
248
+ # # Create a request. To set request fields, pass in keyword arguments.
249
+ # request = Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageRequest.new
250
+ #
251
+ # # Call the send_message method.
252
+ # result = client.send_message request
253
+ #
254
+ # # The returned object is of type Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageResponse.
255
+ # p result
256
+ #
257
+ def send_message request, options = nil
258
+ raise ::ArgumentError, "request must be provided" if request.nil?
259
+
260
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageRequest
261
+
262
+ # Converts hash and nil to an options object
263
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
264
+
265
+ # Customize the options with defaults
266
+ metadata = @config.rpcs.send_message.metadata.to_h
267
+
268
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
269
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
270
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
271
+ gapic_version: ::Google::Cloud::GeminiDataAnalytics::V1beta::VERSION
272
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
273
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
274
+
275
+ header_params = {}
276
+ if request.tenant
277
+ header_params["tenant"] = request.tenant
278
+ end
279
+
280
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
281
+ metadata[:"x-goog-request-params"] ||= request_params_header
282
+
283
+ options.apply_defaults timeout: @config.rpcs.send_message.timeout,
284
+ metadata: metadata,
285
+ retry_policy: @config.rpcs.send_message.retry_policy
286
+
287
+ options.apply_defaults timeout: @config.timeout,
288
+ metadata: @config.metadata,
289
+ retry_policy: @config.retry_policy
290
+
291
+ @data_a2_a_service_stub.call_rpc :send_message, request, options: options do |response, operation|
292
+ yield response, operation if block_given?
293
+ end
294
+ rescue ::GRPC::BadStatus => e
295
+ raise ::Google::Cloud::Error.from_error(e)
296
+ end
297
+
298
+ ##
299
+ # SendStreamingMessage is a streaming call that will return a stream of
300
+ # task update events until the Task is in an interrupted or terminal state.
301
+ #
302
+ # @overload send_streaming_message(request, options = nil)
303
+ # Pass arguments to `send_streaming_message` via a request object, either of type
304
+ # {::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageRequest} or an equivalent Hash.
305
+ #
306
+ # @param request [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageRequest, ::Hash]
307
+ # A request object representing the call parameters. Required. To specify no
308
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
309
+ # @param options [::Gapic::CallOptions, ::Hash]
310
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
311
+ #
312
+ # @overload send_streaming_message(message: nil, configuration: nil, metadata: nil, tenant: nil)
313
+ # Pass arguments to `send_streaming_message` via keyword arguments. Note that at
314
+ # least one keyword argument is required. To specify no parameters, or to keep all
315
+ # the default parameter values, pass an empty Hash as a request object (see above).
316
+ #
317
+ # @param message [::Google::Cloud::GeminiDataAnalytics::V1beta::A2AMessage, ::Hash]
318
+ # Required. The message to send to the agent.
319
+ # @param configuration [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageConfiguration, ::Hash]
320
+ # Optional. Configuration for the send request.
321
+ # @param metadata [::Google::Protobuf::Struct, ::Hash]
322
+ # Optional. Optional metadata for the request.
323
+ # @param tenant [::String]
324
+ # Optional. Optional tenant, provided as a path parameter.
325
+ #
326
+ # @yield [response, operation] Access the result along with the RPC operation
327
+ # @yieldparam response [::Enumerable<::Google::Cloud::GeminiDataAnalytics::V1beta::StreamResponse>]
328
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
329
+ #
330
+ # @return [::Enumerable<::Google::Cloud::GeminiDataAnalytics::V1beta::StreamResponse>]
331
+ #
332
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
333
+ #
334
+ # @example Basic example
335
+ # require "google/cloud/gemini_data_analytics/v1beta"
336
+ #
337
+ # # Create a client object. The client can be reused for multiple calls.
338
+ # client = Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client.new
339
+ #
340
+ # # Create a request. To set request fields, pass in keyword arguments.
341
+ # request = Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageRequest.new
342
+ #
343
+ # # Call the send_streaming_message method to start streaming.
344
+ # output = client.send_streaming_message request
345
+ #
346
+ # # The returned object is a streamed enumerable yielding elements of type
347
+ # # ::Google::Cloud::GeminiDataAnalytics::V1beta::StreamResponse
348
+ # output.each do |current_response|
349
+ # p current_response
350
+ # end
351
+ #
352
+ def send_streaming_message request, options = nil
353
+ raise ::ArgumentError, "request must be provided" if request.nil?
354
+
355
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageRequest
356
+
357
+ # Converts hash and nil to an options object
358
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
359
+
360
+ # Customize the options with defaults
361
+ metadata = @config.rpcs.send_streaming_message.metadata.to_h
362
+
363
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
364
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
365
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
366
+ gapic_version: ::Google::Cloud::GeminiDataAnalytics::V1beta::VERSION
367
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
368
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
369
+
370
+ header_params = {}
371
+ if request.tenant
372
+ header_params["tenant"] = request.tenant
373
+ end
374
+
375
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
376
+ metadata[:"x-goog-request-params"] ||= request_params_header
377
+
378
+ options.apply_defaults timeout: @config.rpcs.send_streaming_message.timeout,
379
+ metadata: metadata,
380
+ retry_policy: @config.rpcs.send_streaming_message.retry_policy
381
+
382
+ options.apply_defaults timeout: @config.timeout,
383
+ metadata: @config.metadata,
384
+ retry_policy: @config.retry_policy
385
+
386
+ @data_a2_a_service_stub.call_rpc :send_streaming_message, request, options: options do |response, operation|
387
+ yield response, operation if block_given?
388
+ end
389
+ rescue ::GRPC::BadStatus => e
390
+ raise ::Google::Cloud::Error.from_error(e)
391
+ end
392
+
393
+ ##
394
+ # GetAgentCard returns the agent card for the agent.
395
+ #
396
+ # @overload get_agent_card(request, options = nil)
397
+ # Pass arguments to `get_agent_card` via a request object, either of type
398
+ # {::Google::Cloud::GeminiDataAnalytics::V1beta::GetAgentCardRequest} or an equivalent Hash.
399
+ #
400
+ # @param request [::Google::Cloud::GeminiDataAnalytics::V1beta::GetAgentCardRequest, ::Hash]
401
+ # A request object representing the call parameters. Required. To specify no
402
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
403
+ # @param options [::Gapic::CallOptions, ::Hash]
404
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
405
+ #
406
+ # @overload get_agent_card(tenant: nil)
407
+ # Pass arguments to `get_agent_card` via keyword arguments. Note that at
408
+ # least one keyword argument is required. To specify no parameters, or to keep all
409
+ # the default parameter values, pass an empty Hash as a request object (see above).
410
+ #
411
+ # @param tenant [::String]
412
+ # Optional. Optional tenant, provided as a path parameter.
413
+ #
414
+ # @yield [response, operation] Access the result along with the RPC operation
415
+ # @yieldparam response [::Google::Cloud::GeminiDataAnalytics::V1beta::AgentCard]
416
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
417
+ #
418
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AgentCard]
419
+ #
420
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
421
+ #
422
+ # @example Basic example
423
+ # require "google/cloud/gemini_data_analytics/v1beta"
424
+ #
425
+ # # Create a client object. The client can be reused for multiple calls.
426
+ # client = Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client.new
427
+ #
428
+ # # Create a request. To set request fields, pass in keyword arguments.
429
+ # request = Google::Cloud::GeminiDataAnalytics::V1beta::GetAgentCardRequest.new
430
+ #
431
+ # # Call the get_agent_card method.
432
+ # result = client.get_agent_card request
433
+ #
434
+ # # The returned object is of type Google::Cloud::GeminiDataAnalytics::V1beta::AgentCard.
435
+ # p result
436
+ #
437
+ def get_agent_card request, options = nil
438
+ raise ::ArgumentError, "request must be provided" if request.nil?
439
+
440
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::GeminiDataAnalytics::V1beta::GetAgentCardRequest
441
+
442
+ # Converts hash and nil to an options object
443
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
444
+
445
+ # Customize the options with defaults
446
+ metadata = @config.rpcs.get_agent_card.metadata.to_h
447
+
448
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
449
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
450
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
451
+ gapic_version: ::Google::Cloud::GeminiDataAnalytics::V1beta::VERSION
452
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
453
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
454
+
455
+ header_params = {}
456
+ if request.tenant
457
+ header_params["tenant"] = request.tenant
458
+ end
459
+
460
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
461
+ metadata[:"x-goog-request-params"] ||= request_params_header
462
+
463
+ options.apply_defaults timeout: @config.rpcs.get_agent_card.timeout,
464
+ metadata: metadata,
465
+ retry_policy: @config.rpcs.get_agent_card.retry_policy
466
+
467
+ options.apply_defaults timeout: @config.timeout,
468
+ metadata: @config.metadata,
469
+ retry_policy: @config.retry_policy
470
+
471
+ @data_a2_a_service_stub.call_rpc :get_agent_card, request, options: options do |response, operation|
472
+ yield response, operation if block_given?
473
+ end
474
+ rescue ::GRPC::BadStatus => e
475
+ raise ::Google::Cloud::Error.from_error(e)
476
+ end
477
+
478
+ ##
479
+ # Configuration class for the DataA2AService API.
480
+ #
481
+ # This class represents the configuration for DataA2AService,
482
+ # providing control over timeouts, retry behavior, logging, transport
483
+ # parameters, and other low-level controls. Certain parameters can also be
484
+ # applied individually to specific RPCs. See
485
+ # {::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client::Configuration::Rpcs}
486
+ # for a list of RPCs that can be configured independently.
487
+ #
488
+ # Configuration can be applied globally to all clients, or to a single client
489
+ # on construction.
490
+ #
491
+ # @example
492
+ #
493
+ # # Modify the global config, setting the timeout for
494
+ # # send_message to 20 seconds,
495
+ # # and all remaining timeouts to 10 seconds.
496
+ # ::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client.configure do |config|
497
+ # config.timeout = 10.0
498
+ # config.rpcs.send_message.timeout = 20.0
499
+ # end
500
+ #
501
+ # # Apply the above configuration only to a new client.
502
+ # client = ::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client.new do |config|
503
+ # config.timeout = 10.0
504
+ # config.rpcs.send_message.timeout = 20.0
505
+ # end
506
+ #
507
+ # @!attribute [rw] endpoint
508
+ # A custom service endpoint, as a hostname or hostname:port. The default is
509
+ # nil, indicating to use the default endpoint in the current universe domain.
510
+ # @return [::String,nil]
511
+ # @!attribute [rw] credentials
512
+ # Credentials to send with calls. You may provide any of the following types:
513
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
514
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
515
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
516
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
517
+ # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
518
+ # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
519
+ # * (`nil`) indicating no credentials
520
+ #
521
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
522
+ # is deprecated. Providing an unvalidated credential configuration to
523
+ # Google APIs can compromise the security of your systems and data.
524
+ #
525
+ # @example
526
+ #
527
+ # # The recommended way to provide credentials is to use the `make_creds` method
528
+ # # on the appropriate credentials class for your environment.
529
+ #
530
+ # require "googleauth"
531
+ #
532
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
533
+ # json_key_io: ::File.open("/path/to/keyfile.json")
534
+ # )
535
+ #
536
+ # client = ::Google::Cloud::GeminiDataAnalytics::V1beta::DataA2AService::Client.new do |config|
537
+ # config.credentials = credentials
538
+ # end
539
+ #
540
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
541
+ # external source for authentication to Google Cloud, you must validate it before
542
+ # providing it to a Google API client library. Providing an unvalidated credential
543
+ # configuration to Google APIs can compromise the security of your systems and data.
544
+ # For more information, refer to [Validate credential configurations from external
545
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
546
+ # @return [::Object]
547
+ # @!attribute [rw] scope
548
+ # The OAuth scopes
549
+ # @return [::Array<::String>]
550
+ # @!attribute [rw] lib_name
551
+ # The library name as recorded in instrumentation and logging
552
+ # @return [::String]
553
+ # @!attribute [rw] lib_version
554
+ # The library version as recorded in instrumentation and logging
555
+ # @return [::String]
556
+ # @!attribute [rw] channel_args
557
+ # Extra parameters passed to the gRPC channel. Note: this is ignored if a
558
+ # `GRPC::Core::Channel` object is provided as the credential.
559
+ # @return [::Hash]
560
+ # @!attribute [rw] interceptors
561
+ # An array of interceptors that are run before calls are executed.
562
+ # @return [::Array<::GRPC::ClientInterceptor>]
563
+ # @!attribute [rw] timeout
564
+ # The call timeout in seconds.
565
+ # @return [::Numeric]
566
+ # @!attribute [rw] metadata
567
+ # Additional gRPC headers to be sent with the call.
568
+ # @return [::Hash{::Symbol=>::String}]
569
+ # @!attribute [rw] retry_policy
570
+ # The retry policy. The value is a hash with the following keys:
571
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
572
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
573
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
574
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
575
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
576
+ # trigger a retry.
577
+ # @return [::Hash]
578
+ # @!attribute [rw] quota_project
579
+ # A separate project against which to charge quota.
580
+ # @return [::String]
581
+ # @!attribute [rw] universe_domain
582
+ # The universe domain within which to make requests. This determines the
583
+ # default endpoint URL. The default value of nil uses the environment
584
+ # universe (usually the default "googleapis.com" universe).
585
+ # @return [::String,nil]
586
+ # @!attribute [rw] logger
587
+ # A custom logger to use for request/response debug logging, or the value
588
+ # `:default` (the default) to construct a default logger, or `nil` to
589
+ # explicitly disable logging.
590
+ # @return [::Logger,:default,nil]
591
+ #
592
+ class Configuration
593
+ extend ::Gapic::Config
594
+
595
+ # @private
596
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
597
+ DEFAULT_ENDPOINT = "geminidataanalytics.googleapis.com"
598
+
599
+ config_attr :endpoint, nil, ::String, nil
600
+ config_attr :credentials, nil do |value|
601
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Google::Auth::BaseClient, ::Signet::OAuth2::Client, nil]
602
+ allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC::Core::Channel
603
+ allowed.any? { |klass| klass === value }
604
+ end
605
+ config_attr :scope, nil, ::String, ::Array, nil
606
+ config_attr :lib_name, nil, ::String, nil
607
+ config_attr :lib_version, nil, ::String, nil
608
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
609
+ config_attr :interceptors, nil, ::Array, nil
610
+ config_attr :timeout, nil, ::Numeric, nil
611
+ config_attr :metadata, nil, ::Hash, nil
612
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
613
+ config_attr :quota_project, nil, ::String, nil
614
+ config_attr :universe_domain, nil, ::String, nil
615
+ config_attr :logger, :default, ::Logger, nil, :default
616
+
617
+ # @private
618
+ def initialize parent_config = nil
619
+ @parent_config = parent_config unless parent_config.nil?
620
+
621
+ yield self if block_given?
622
+ end
623
+
624
+ ##
625
+ # Configurations for individual RPCs
626
+ # @return [Rpcs]
627
+ #
628
+ def rpcs
629
+ @rpcs ||= begin
630
+ parent_rpcs = nil
631
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
632
+ Rpcs.new parent_rpcs
633
+ end
634
+ end
635
+
636
+ ##
637
+ # Configuration for the channel pool
638
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
639
+ #
640
+ def channel_pool
641
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
642
+ end
643
+
644
+ ##
645
+ # Configuration RPC class for the DataA2AService API.
646
+ #
647
+ # Includes fields providing the configuration for each RPC in this service.
648
+ # Each configuration object is of type `Gapic::Config::Method` and includes
649
+ # the following configuration fields:
650
+ #
651
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
652
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
653
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
654
+ # include the following keys:
655
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
656
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
657
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
658
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
659
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
660
+ # trigger a retry.
661
+ #
662
+ class Rpcs
663
+ ##
664
+ # RPC-specific configuration for `send_message`
665
+ # @return [::Gapic::Config::Method]
666
+ #
667
+ attr_reader :send_message
668
+ ##
669
+ # RPC-specific configuration for `send_streaming_message`
670
+ # @return [::Gapic::Config::Method]
671
+ #
672
+ attr_reader :send_streaming_message
673
+ ##
674
+ # RPC-specific configuration for `get_agent_card`
675
+ # @return [::Gapic::Config::Method]
676
+ #
677
+ attr_reader :get_agent_card
678
+
679
+ # @private
680
+ def initialize parent_rpcs = nil
681
+ send_message_config = parent_rpcs.send_message if parent_rpcs.respond_to? :send_message
682
+ @send_message = ::Gapic::Config::Method.new send_message_config
683
+ send_streaming_message_config = parent_rpcs.send_streaming_message if parent_rpcs.respond_to? :send_streaming_message
684
+ @send_streaming_message = ::Gapic::Config::Method.new send_streaming_message_config
685
+ get_agent_card_config = parent_rpcs.get_agent_card if parent_rpcs.respond_to? :get_agent_card
686
+ @get_agent_card = ::Gapic::Config::Method.new get_agent_card_config
687
+
688
+ yield self if block_given?
689
+ end
690
+ end
691
+ end
692
+ end
693
+ end
694
+ end
695
+ end
696
+ end
697
+ end