google-cloud-gemini_data_analytics-v1 0.2.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 (25) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +0 -1
  3. data/lib/google/cloud/gemini_data_analytics/v1/data_agent_service/client.rb +236 -1
  4. data/lib/google/cloud/gemini_data_analytics/v1/data_agent_service/rest/client.rb +222 -1
  5. data/lib/google/cloud/gemini_data_analytics/v1/data_agent_service/rest/service_stub.rb +123 -0
  6. data/lib/google/cloud/gemini_data_analytics/v1/data_chat_service/client.rb +105 -0
  7. data/lib/google/cloud/gemini_data_analytics/v1/data_chat_service/rest/client.rb +98 -0
  8. data/lib/google/cloud/gemini_data_analytics/v1/data_chat_service/rest/service_stub.rb +62 -0
  9. data/lib/google/cloud/gemini_data_analytics/v1/version.rb +1 -1
  10. data/lib/google/cloud/geminidataanalytics/v1/context_pb.rb +2 -1
  11. data/lib/google/cloud/geminidataanalytics/v1/conversation_pb.rb +3 -1
  12. data/lib/google/cloud/geminidataanalytics/v1/data_agent_pb.rb +2 -1
  13. data/lib/google/cloud/geminidataanalytics/v1/data_agent_service_pb.rb +6 -1
  14. data/lib/google/cloud/geminidataanalytics/v1/data_agent_service_services_pb.rb +6 -0
  15. data/lib/google/cloud/geminidataanalytics/v1/data_chat_service_pb.rb +1 -1
  16. data/lib/google/cloud/geminidataanalytics/v1/data_chat_service_services_pb.rb +2 -0
  17. data/lib/google/cloud/geminidataanalytics/v1/datasource_pb.rb +1 -1
  18. data/proto_docs/google/cloud/geminidataanalytics/v1/context.rb +85 -7
  19. data/proto_docs/google/cloud/geminidataanalytics/v1/conversation.rb +27 -3
  20. data/proto_docs/google/cloud/geminidataanalytics/v1/data_agent.rb +51 -0
  21. data/proto_docs/google/cloud/geminidataanalytics/v1/data_agent_service.rb +100 -0
  22. data/proto_docs/google/cloud/geminidataanalytics/v1/data_chat_service.rb +6 -8
  23. data/proto_docs/google/cloud/geminidataanalytics/v1/datasource.rb +7 -0
  24. data/proto_docs/google/protobuf/timestamp.rb +7 -6
  25. metadata +1 -1
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: b24c81d5e8afee027f6692a7d7762c918032f2fded134b0839158d1cbf3aec90
4
- data.tar.gz: 48cd9ffb5435265ecf9e562cb5b293720018dab7c8d054be5a792dea237dec8c
3
+ metadata.gz: 65d8fffc9cd508acad45cea1f7342068b82e79383bb77069f10dc8edf1cf488d
4
+ data.tar.gz: 2d674d49d5fdc8fcd62030f152151c6e8578355ba6c68a8dcf481a0e500f7138
5
5
  SHA512:
6
- metadata.gz: ea5c6ef71389a0dbfb72acb0ae448674bae24b19108b390b292bc372bba4390d88f3d953cfecbe25f596bf016d9dcbd9bd804c90b2d175a6a5142e24ac1b92f5
7
- data.tar.gz: 70a0fb6d728705affe15182aa11266c33eaf793e5e7d32f9734b8dd710ff0dbc9c8fe6e9be631fe91290535db6546a0fca48cf519b0ef85cf1fd8ad325588ba7
6
+ metadata.gz: 54c42891cb599e29cb5add6f11f31e7a14f7aa22b687fe2538c13e8c5e1545bd49bb09f132ffa4a1f98c764bdb18aa7d6bbb28fb90282c4daabfc47880f5e830
7
+ data.tar.gz: 6785859c120eab1844c126f398f5faba73eeea96eb3d91cef0a6dcb19101163c258044ef8cee091229259188e733649e273a33dfd7cbaf296f140f8dda7be76d
data/README.md CHANGED
@@ -2,7 +2,6 @@
2
2
 
3
3
  The Gemini Data Analytics API enables developers to build intelligent data analytics applications. Leverage AI-powered chat interfaces to allow users to interact with and analyze structured data using natural language.
4
4
 
5
- The Gemini Data Analytics API enables developers to build intelligent data analytics applications. Leverage AI-powered chat interfaces to allow users to interact with and analyze structured data using natural language.
6
5
 
7
6
  https://github.com/googleapis/google-cloud-ruby
8
7
 
@@ -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::V1::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::V1::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::V1::SetAgentOpsObservabilityRequest} or an equivalent Hash.
1372
+ #
1373
+ # @param request [::Google::Cloud::GeminiDataAnalytics::V1::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/v1"
1431
+ #
1432
+ # # Create a client object. The client can be reused for multiple calls.
1433
+ # client = Google::Cloud::GeminiDataAnalytics::V1::DataAgentService::Client.new
1434
+ #
1435
+ # # Create a request. To set request fields, pass in keyword arguments.
1436
+ # request = Google::Cloud::GeminiDataAnalytics::V1::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::V1::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::V1::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::V1::RetrieveAgentOpsObservabilityRequest} or an equivalent Hash.
1500
+ #
1501
+ # @param request [::Google::Cloud::GeminiDataAnalytics::V1::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::V1::RetrieveAgentOpsObservabilityResponse]
1521
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1522
+ #
1523
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1::RetrieveAgentOpsObservabilityResponse]
1524
+ #
1525
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1526
+ #
1527
+ # @example Basic example
1528
+ # require "google/cloud/gemini_data_analytics/v1"
1529
+ #
1530
+ # # Create a client object. The client can be reused for multiple calls.
1531
+ # client = Google::Cloud::GeminiDataAnalytics::V1::DataAgentService::Client.new
1532
+ #
1533
+ # # Create a request. To set request fields, pass in keyword arguments.
1534
+ # request = Google::Cloud::GeminiDataAnalytics::V1::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::V1::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::V1::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::V1::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
@@ -225,7 +225,7 @@ module Google
225
225
  # @param options [::Gapic::CallOptions, ::Hash]
226
226
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
227
227
  #
228
- # @overload list_data_agents(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil, show_deleted: nil)
228
+ # @overload list_data_agents(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil, show_deleted: nil, creator_filter: nil)
229
229
  # Pass arguments to `list_data_agents` via keyword arguments. Note that at
230
230
  # least one keyword argument is required. To specify no parameters, or to keep all
231
231
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -250,6 +250,8 @@ module Google
250
250
  # @param show_deleted [::Boolean]
251
251
  # Optional. If true, the list results will include soft-deleted DataAgents.
252
252
  # Defaults to false.
253
+ # @param creator_filter [::Google::Cloud::GeminiDataAnalytics::V1::ListAccessibleDataAgentsRequest::CreatorFilter]
254
+ # Optional. Filter for the creator of the agent.
253
255
  # @yield [result, operation] Access the result along with the TransportOperation object
254
256
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::GeminiDataAnalytics::V1::DataAgent>]
255
257
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1276,6 +1278,211 @@ module Google
1276
1278
  raise ::Google::Cloud::Error.from_error(e)
1277
1279
  end
1278
1280
 
1281
+ ##
1282
+ # Enables/Disables required GCP services and configures AgentOps
1283
+ # observability settings calling the Admin Settings executable node to
1284
+ # update the AgentOps Observability feature.
1285
+ #
1286
+ # @overload set_agent_ops_observability(request, options = nil)
1287
+ # Pass arguments to `set_agent_ops_observability` via a request object, either of type
1288
+ # {::Google::Cloud::GeminiDataAnalytics::V1::SetAgentOpsObservabilityRequest} or an equivalent Hash.
1289
+ #
1290
+ # @param request [::Google::Cloud::GeminiDataAnalytics::V1::SetAgentOpsObservabilityRequest, ::Hash]
1291
+ # A request object representing the call parameters. Required. To specify no
1292
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1293
+ # @param options [::Gapic::CallOptions, ::Hash]
1294
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1295
+ #
1296
+ # @overload set_agent_ops_observability(parent: nil, telemetry_enabled: nil, data_source_type: nil, bqaa_enabled: nil, update_mask: nil)
1297
+ # Pass arguments to `set_agent_ops_observability` via keyword arguments. Note that at
1298
+ # least one keyword argument is required. To specify no parameters, or to keep all
1299
+ # the default parameter values, pass an empty Hash as a request object (see above).
1300
+ #
1301
+ # @param parent [::String]
1302
+ # Required. Parent value for SetAgentOpsObservabilityRequest.
1303
+ # Format: projects/\\{project}/locations/\\{location}
1304
+ # @param telemetry_enabled [::Boolean]
1305
+ # Optional. Whether to enable or disable AgentOps observability.
1306
+ # When update_mask is provided, this field is ignored unless specified in the
1307
+ # mask.
1308
+ # @param data_source_type [::String]
1309
+ # Required. The data source type for which to set observability settings.
1310
+ # Examples: "bigquery", "looker"
1311
+ # @param bqaa_enabled [::Boolean]
1312
+ # Optional. Whether BigQuery Agent Analytics is enabled.
1313
+ # Note: An explicit `update_mask` containing "bqaa_enabled" is required to
1314
+ # modify this field. If `update_mask` is omitted, this field is ignored and
1315
+ # an existing enabled setting cannot be disabled.
1316
+ #
1317
+ # This is a project-level setting and does not by itself enable trace
1318
+ # logging for any individual agent. Per-agent trace logging is controlled
1319
+ # by `DataAgent.bigquery_agent_analytics_enabled` together with
1320
+ # `DataAgent.bigquery_agent_analytics_table`; an agent does not inherit
1321
+ # this setting.
1322
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1323
+ # Optional. Field mask is used to specify the fields to be overwritten by the
1324
+ # update. The fields specified in the update_mask are relative to the
1325
+ # resource. A field will be overwritten if it is in the mask.
1326
+ #
1327
+ # If the user does not provide a mask, only `telemetry_enabled` will be
1328
+ # updated (for backward compatibility with legacy callers). Note that
1329
+ # disabling BigQuery Agent Analytics (`bqaa_enabled = false`) requires
1330
+ # providing an explicit `update_mask` containing "bqaa_enabled".
1331
+ #
1332
+ # Per AIP-161:
1333
+ # - The special wildcard value '*' is supported to update all fields.
1334
+ # - Field paths should use snake_case, though camelCase equivalents
1335
+ # (`telemetryEnabled`, `bqaaEnabled`) are accepted for REST/JSON
1336
+ # transcoding compatibility.
1337
+ # @yield [result, operation] Access the result along with the TransportOperation object
1338
+ # @yieldparam result [::Gapic::Operation]
1339
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1340
+ #
1341
+ # @return [::Gapic::Operation]
1342
+ #
1343
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1344
+ #
1345
+ # @example Basic example
1346
+ # require "google/cloud/gemini_data_analytics/v1"
1347
+ #
1348
+ # # Create a client object. The client can be reused for multiple calls.
1349
+ # client = Google::Cloud::GeminiDataAnalytics::V1::DataAgentService::Rest::Client.new
1350
+ #
1351
+ # # Create a request. To set request fields, pass in keyword arguments.
1352
+ # request = Google::Cloud::GeminiDataAnalytics::V1::SetAgentOpsObservabilityRequest.new
1353
+ #
1354
+ # # Call the set_agent_ops_observability method.
1355
+ # result = client.set_agent_ops_observability request
1356
+ #
1357
+ # # The returned object is of type Gapic::Operation. You can use it to
1358
+ # # check the status of an operation, cancel it, or wait for results.
1359
+ # # Here is how to wait for a response.
1360
+ # result.wait_until_done! timeout: 60
1361
+ # if result.response?
1362
+ # p result.response
1363
+ # else
1364
+ # puts "No response received."
1365
+ # end
1366
+ #
1367
+ def set_agent_ops_observability request, options = nil
1368
+ raise ::ArgumentError, "request must be provided" if request.nil?
1369
+
1370
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::GeminiDataAnalytics::V1::SetAgentOpsObservabilityRequest
1371
+
1372
+ # Converts hash and nil to an options object
1373
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1374
+
1375
+ # Customize the options with defaults
1376
+ call_metadata = @config.rpcs.set_agent_ops_observability.metadata.to_h
1377
+
1378
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1379
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1380
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1381
+ gapic_version: ::Google::Cloud::GeminiDataAnalytics::V1::VERSION,
1382
+ transports_version_send: [:rest]
1383
+
1384
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1385
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1386
+
1387
+ options.apply_defaults timeout: @config.rpcs.set_agent_ops_observability.timeout,
1388
+ metadata: call_metadata,
1389
+ retry_policy: @config.rpcs.set_agent_ops_observability.retry_policy
1390
+
1391
+ options.apply_defaults timeout: @config.timeout,
1392
+ metadata: @config.metadata,
1393
+ retry_policy: @config.retry_policy
1394
+
1395
+ @data_agent_service_stub.set_agent_ops_observability request, options do |result, operation|
1396
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1397
+ yield result, operation if block_given?
1398
+ throw :response, result
1399
+ end
1400
+ rescue ::Gapic::Rest::Error => e
1401
+ raise ::Google::Cloud::Error.from_error(e)
1402
+ end
1403
+
1404
+ ##
1405
+ # Gets AgentOps observability settings and status of required services.
1406
+ #
1407
+ # @overload retrieve_agent_ops_observability(request, options = nil)
1408
+ # Pass arguments to `retrieve_agent_ops_observability` via a request object, either of type
1409
+ # {::Google::Cloud::GeminiDataAnalytics::V1::RetrieveAgentOpsObservabilityRequest} or an equivalent Hash.
1410
+ #
1411
+ # @param request [::Google::Cloud::GeminiDataAnalytics::V1::RetrieveAgentOpsObservabilityRequest, ::Hash]
1412
+ # A request object representing the call parameters. Required. To specify no
1413
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1414
+ # @param options [::Gapic::CallOptions, ::Hash]
1415
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1416
+ #
1417
+ # @overload retrieve_agent_ops_observability(parent: nil, data_source_type: nil)
1418
+ # Pass arguments to `retrieve_agent_ops_observability` via keyword arguments. Note that at
1419
+ # least one keyword argument is required. To specify no parameters, or to keep all
1420
+ # the default parameter values, pass an empty Hash as a request object (see above).
1421
+ #
1422
+ # @param parent [::String]
1423
+ # Required. Parent value for RetrieveAgentOpsObservabilityRequest.
1424
+ # Format: projects/\\{project}/locations/\\{location}
1425
+ # @param data_source_type [::String]
1426
+ # Required. The data source type for which to retrieve observability
1427
+ # settings. Examples: "bigquery", "looker"
1428
+ # @yield [result, operation] Access the result along with the TransportOperation object
1429
+ # @yieldparam result [::Google::Cloud::GeminiDataAnalytics::V1::RetrieveAgentOpsObservabilityResponse]
1430
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1431
+ #
1432
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1::RetrieveAgentOpsObservabilityResponse]
1433
+ #
1434
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1435
+ #
1436
+ # @example Basic example
1437
+ # require "google/cloud/gemini_data_analytics/v1"
1438
+ #
1439
+ # # Create a client object. The client can be reused for multiple calls.
1440
+ # client = Google::Cloud::GeminiDataAnalytics::V1::DataAgentService::Rest::Client.new
1441
+ #
1442
+ # # Create a request. To set request fields, pass in keyword arguments.
1443
+ # request = Google::Cloud::GeminiDataAnalytics::V1::RetrieveAgentOpsObservabilityRequest.new
1444
+ #
1445
+ # # Call the retrieve_agent_ops_observability method.
1446
+ # result = client.retrieve_agent_ops_observability request
1447
+ #
1448
+ # # The returned object is of type Google::Cloud::GeminiDataAnalytics::V1::RetrieveAgentOpsObservabilityResponse.
1449
+ # p result
1450
+ #
1451
+ def retrieve_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::V1::RetrieveAgentOpsObservabilityRequest
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
+ call_metadata = @config.rpcs.retrieve_agent_ops_observability.metadata.to_h
1461
+
1462
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1463
+ call_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::V1::VERSION,
1466
+ transports_version_send: [:rest]
1467
+
1468
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1469
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1470
+
1471
+ options.apply_defaults timeout: @config.rpcs.retrieve_agent_ops_observability.timeout,
1472
+ metadata: call_metadata,
1473
+ retry_policy: @config.rpcs.retrieve_agent_ops_observability.retry_policy
1474
+
1475
+ options.apply_defaults timeout: @config.timeout,
1476
+ metadata: @config.metadata,
1477
+ retry_policy: @config.retry_policy
1478
+
1479
+ @data_agent_service_stub.retrieve_agent_ops_observability request, options do |result, operation|
1480
+ yield result, operation if block_given?
1481
+ end
1482
+ rescue ::Gapic::Rest::Error => e
1483
+ raise ::Google::Cloud::Error.from_error(e)
1484
+ end
1485
+
1279
1486
  ##
1280
1487
  # Configuration class for the DataAgentService REST API.
1281
1488
  #
@@ -1486,6 +1693,16 @@ module Google
1486
1693
  # @return [::Gapic::Config::Method]
1487
1694
  #
1488
1695
  attr_reader :set_iam_policy
1696
+ ##
1697
+ # RPC-specific configuration for `set_agent_ops_observability`
1698
+ # @return [::Gapic::Config::Method]
1699
+ #
1700
+ attr_reader :set_agent_ops_observability
1701
+ ##
1702
+ # RPC-specific configuration for `retrieve_agent_ops_observability`
1703
+ # @return [::Gapic::Config::Method]
1704
+ #
1705
+ attr_reader :retrieve_agent_ops_observability
1489
1706
 
1490
1707
  # @private
1491
1708
  def initialize parent_rpcs = nil
@@ -1511,6 +1728,10 @@ module Google
1511
1728
  @get_iam_policy = ::Gapic::Config::Method.new get_iam_policy_config
1512
1729
  set_iam_policy_config = parent_rpcs.set_iam_policy if parent_rpcs.respond_to? :set_iam_policy
1513
1730
  @set_iam_policy = ::Gapic::Config::Method.new set_iam_policy_config
1731
+ set_agent_ops_observability_config = parent_rpcs.set_agent_ops_observability if parent_rpcs.respond_to? :set_agent_ops_observability
1732
+ @set_agent_ops_observability = ::Gapic::Config::Method.new set_agent_ops_observability_config
1733
+ retrieve_agent_ops_observability_config = parent_rpcs.retrieve_agent_ops_observability if parent_rpcs.respond_to? :retrieve_agent_ops_observability
1734
+ @retrieve_agent_ops_observability = ::Gapic::Config::Method.new retrieve_agent_ops_observability_config
1514
1735
 
1515
1736
  yield self if block_given?
1516
1737
  end