google-apis-ces_v1 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 165f88f4cad55d03c739d1393ff421391f637a024eb6b417905414bc40a564b8
4
- data.tar.gz: d2ef3ac0db512900a506895a1b4539f8bb78cfe22c3ce5bb083cc19c53bd487a
3
+ metadata.gz: bf45178bf3c68ee20684f5f428ec6103cd30c68934e23dae9c935718726258ec
4
+ data.tar.gz: 977cfabdd6487dd54535811523e00265f1b9520ec195cd204af64b0706bb899b
5
5
  SHA512:
6
- metadata.gz: d426b05ed8234c2705ca2ddccbbb432393a9a11c82aeb1050a8d9ddf20bfb9ab79b3fc9e20062816e9c436c6568e62e0ea99e53c9249daab19e8ea40f5ee5b7e
7
- data.tar.gz: 8005f4dff6ce4059a696df021df4b68350c1c19dca1af8accf0eac0e28898961f9b00f9800bbbb0a8ecd60c8c8a8b528d10e7ea63d3041e3058c1e7fc1342e6e
6
+ metadata.gz: 0a03b9e31664a8f19bd65047e51044583ffd84030bb3878e3a3c1280379bc9b37ef1d5ef164afac6376c334dac79d97aeba41b36edf3bdc96fa450004677229e
7
+ data.tar.gz: df73ef5fb0e38b0d169728dc1d1ccde663a1ae28b26de32c0215ac7e4d3f3a63dceffb9c1f8775175d0aa72f5fb5d75d0fa37ca172214cb3fb8cfd059ba08a6f
data/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Release history for google-apis-ces_v1
2
2
 
3
+ ### v0.5.0 (2026-03-15)
4
+
5
+ * Regenerated from discovery document revision 20260312
6
+
7
+ ### v0.4.0 (2026-03-08)
8
+
9
+ * Regenerated from discovery document revision 20260227
10
+
3
11
  ### v0.3.0 (2026-03-01)
4
12
 
5
13
  * Regenerated from discovery document revision 20260218
data/OVERVIEW.md CHANGED
@@ -79,7 +79,7 @@ Gem names for modern clients are often of the form `google-cloud-<service_name>`
79
79
 
80
80
  **For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure.
81
81
 
82
- The [product documentation](https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference) may provide guidance regarding the preferred client library to use.
82
+ The [product documentation](https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps) may provide guidance regarding the preferred client library to use.
83
83
 
84
84
  ## Supported Ruby versions
85
85
 
@@ -373,6 +373,38 @@ module Google
373
373
  end
374
374
  end
375
375
 
376
+ # Represents a tool that allows the agent to call another agent.
377
+ class AgentTool
378
+ include Google::Apis::Core::Hashable
379
+
380
+ # Optional. Description of the tool's purpose.
381
+ # Corresponds to the JSON property `description`
382
+ # @return [String]
383
+ attr_accessor :description
384
+
385
+ # Required. The name of the agent tool.
386
+ # Corresponds to the JSON property `name`
387
+ # @return [String]
388
+ attr_accessor :name
389
+
390
+ # Optional. The resource name of the root agent that is the entry point of the
391
+ # tool. Format: `projects/`project`/locations/`location`/agents/`agent``
392
+ # Corresponds to the JSON property `rootAgent`
393
+ # @return [String]
394
+ attr_accessor :root_agent
395
+
396
+ def initialize(**args)
397
+ update!(**args)
398
+ end
399
+
400
+ # Update properties of this object
401
+ def update!(**args)
402
+ @description = args[:description] if args.key?(:description)
403
+ @name = args[:name] if args.key?(:name)
404
+ @root_agent = args[:root_agent] if args.key?(:root_agent)
405
+ end
406
+ end
407
+
376
408
  # Represents an event indicating the transfer of a conversation to a different
377
409
  # agent.
378
410
  class AgentTransfer
@@ -580,6 +612,11 @@ module Google
580
612
  # @return [String]
581
613
  attr_accessor :display_name
582
614
 
615
+ # Settings to describe how errors should be handled in the app.
616
+ # Corresponds to the JSON property `errorHandlingSettings`
617
+ # @return [Google::Apis::CesV1::ErrorHandlingSettings]
618
+ attr_accessor :error_handling_settings
619
+
583
620
  # Output only. Etag used to ensure the object hasn't changed during a read-
584
621
  # modify-write operation. If the etag is empty, the update will overwrite any
585
622
  # concurrent changes.
@@ -690,6 +727,7 @@ module Google
690
727
  @deployment_count = args[:deployment_count] if args.key?(:deployment_count)
691
728
  @description = args[:description] if args.key?(:description)
692
729
  @display_name = args[:display_name] if args.key?(:display_name)
730
+ @error_handling_settings = args[:error_handling_settings] if args.key?(:error_handling_settings)
693
731
  @etag = args[:etag] if args.key?(:etag)
694
732
  @evaluation_metrics_thresholds = args[:evaluation_metrics_thresholds] if args.key?(:evaluation_metrics_thresholds)
695
733
  @global_instruction = args[:global_instruction] if args.key?(:global_instruction)
@@ -1387,6 +1425,11 @@ module Google
1387
1425
  # @return [Google::Apis::CesV1::AgentTransfer]
1388
1426
  attr_accessor :agent_transfer
1389
1427
 
1428
+ # Represents a blob input or output in the conversation.
1429
+ # Corresponds to the JSON property `blob`
1430
+ # @return [Google::Apis::CesV1::Blob]
1431
+ attr_accessor :blob
1432
+
1390
1433
  # A struct represents default variables at the start of the conversation, keyed
1391
1434
  # by variable names.
1392
1435
  # Corresponds to the JSON property `defaultVariables`
@@ -1436,6 +1479,7 @@ module Google
1436
1479
  # Update properties of this object
1437
1480
  def update!(**args)
1438
1481
  @agent_transfer = args[:agent_transfer] if args.key?(:agent_transfer)
1482
+ @blob = args[:blob] if args.key?(:blob)
1439
1483
  @default_variables = args[:default_variables] if args.key?(:default_variables)
1440
1484
  @image = args[:image] if args.key?(:image)
1441
1485
  @payload = args[:payload] if args.key?(:payload)
@@ -2404,8 +2448,9 @@ module Google
2404
2448
  class Deployment
2405
2449
  include Google::Apis::Core::Hashable
2406
2450
 
2407
- # Required. The resource name of the app version to deploy. Format: projects/`
2408
- # project`/locations/`location`/apps/`app`/versions/`version`
2451
+ # Optional. The resource name of the app version to deploy. Format: `projects/`
2452
+ # project`/locations/`location`/apps/`app`/versions/`version`` Use `projects/`
2453
+ # project`/locations/`location`/apps/`app`/versions/-` to use the draft app.
2409
2454
  # Corresponds to the JSON property `appVersion`
2410
2455
  # @return [String]
2411
2456
  attr_accessor :app_version
@@ -2433,8 +2478,8 @@ module Google
2433
2478
  # @return [String]
2434
2479
  attr_accessor :etag
2435
2480
 
2436
- # Identifier. The resource name of the deployment. Format: projects/`project`/
2437
- # locations/`location`/apps/`app`/deployments/`deployment`
2481
+ # Identifier. The resource name of the deployment. Format: `projects/`project`/
2482
+ # locations/`location`/apps/`app`/deployments/`deployment``
2438
2483
  # Corresponds to the JSON property `name`
2439
2484
  # @return [String]
2440
2485
  attr_accessor :name
@@ -2580,6 +2625,55 @@ module Google
2580
2625
  end
2581
2626
  end
2582
2627
 
2628
+ # Defines project/location level endpoint control policy.
2629
+ class EndpointControlPolicy
2630
+ include Google::Apis::Core::Hashable
2631
+
2632
+ # Optional. The allowed HTTP(s) origins that tools in the App are able to
2633
+ # directly call. The enforcement depends on the value of enforcement_scope and
2634
+ # the VPC-SC status of the project. If a port number is not provided, all ports
2635
+ # will be allowed. Otherwise, the port number must match exactly. For example, "
2636
+ # https://example.com" will match "https://example.com:443" and any other port. "
2637
+ # https://example.com:443" will only match "https://example.com:443".
2638
+ # Corresponds to the JSON property `allowedOrigins`
2639
+ # @return [Array<String>]
2640
+ attr_accessor :allowed_origins
2641
+
2642
+ # Optional. The scope in which this policy's allowed_origins list is enforced.
2643
+ # Corresponds to the JSON property `enforcementScope`
2644
+ # @return [String]
2645
+ attr_accessor :enforcement_scope
2646
+
2647
+ def initialize(**args)
2648
+ update!(**args)
2649
+ end
2650
+
2651
+ # Update properties of this object
2652
+ def update!(**args)
2653
+ @allowed_origins = args[:allowed_origins] if args.key?(:allowed_origins)
2654
+ @enforcement_scope = args[:enforcement_scope] if args.key?(:enforcement_scope)
2655
+ end
2656
+ end
2657
+
2658
+ # Settings to describe how errors should be handled in the app.
2659
+ class ErrorHandlingSettings
2660
+ include Google::Apis::Core::Hashable
2661
+
2662
+ # Optional. The strategy to use for error handling.
2663
+ # Corresponds to the JSON property `errorHandlingStrategy`
2664
+ # @return [String]
2665
+ attr_accessor :error_handling_strategy
2666
+
2667
+ def initialize(**args)
2668
+ update!(**args)
2669
+ end
2670
+
2671
+ # Update properties of this object
2672
+ def update!(**args)
2673
+ @error_handling_strategy = args[:error_handling_strategy] if args.key?(:error_handling_strategy)
2674
+ end
2675
+ end
2676
+
2583
2677
  # Threshold settings for metrics in an Evaluation.
2584
2678
  class EvaluationMetricsThresholds
2585
2679
  include Google::Apis::Core::Hashable
@@ -2823,6 +2917,13 @@ module Google
2823
2917
  # @return [Hash<String,Object>]
2824
2918
  attr_accessor :args
2825
2919
 
2920
+ # Optional. The [ToolCallContext](https://docs.cloud.google.com/customer-
2921
+ # engagement-ai/conversational-agents/ps/tool/python#environment for details) to
2922
+ # be passed to the Python tool.
2923
+ # Corresponds to the JSON property `context`
2924
+ # @return [Hash<String,Object>]
2925
+ attr_accessor :context
2926
+
2826
2927
  # Optional. The name of the tool to execute. Format: projects/`project`/
2827
2928
  # locations/`location`/apps/`app`/tools/`tool`
2828
2929
  # Corresponds to the JSON property `tool`
@@ -2846,6 +2947,7 @@ module Google
2846
2947
  # Update properties of this object
2847
2948
  def update!(**args)
2848
2949
  @args = args[:args] if args.key?(:args)
2950
+ @context = args[:context] if args.key?(:context)
2849
2951
  @tool = args[:tool] if args.key?(:tool)
2850
2952
  @toolset_tool = args[:toolset_tool] if args.key?(:toolset_tool)
2851
2953
  @variables = args[:variables] if args.key?(:variables)
@@ -2897,6 +2999,12 @@ module Google
2897
2999
  class ExportAppRequest
2898
3000
  include Google::Apis::Core::Hashable
2899
3001
 
3002
+ # Optional. The resource name of the app version to export. Format: `projects/`
3003
+ # project`/locations/`location`/apps/`app`/versions/`version``.
3004
+ # Corresponds to the JSON property `appVersion`
3005
+ # @return [String]
3006
+ attr_accessor :app_version
3007
+
2900
3008
  # Required. The format to export the app in.
2901
3009
  # Corresponds to the JSON property `exportFormat`
2902
3010
  # @return [String]
@@ -2915,6 +3023,7 @@ module Google
2915
3023
 
2916
3024
  # Update properties of this object
2917
3025
  def update!(**args)
3026
+ @app_version = args[:app_version] if args.key?(:app_version)
2918
3027
  @export_format = args[:export_format] if args.key?(:export_format)
2919
3028
  @gcs_uri = args[:gcs_uri] if args.key?(:gcs_uri)
2920
3029
  end
@@ -3016,6 +3125,12 @@ module Google
3016
3125
  # @return [String]
3017
3126
  attr_accessor :deployment
3018
3127
 
3128
+ # Optional. Indicates if live handoff is enabled for the session.
3129
+ # Corresponds to the JSON property `liveHandoffEnabled`
3130
+ # @return [Boolean]
3131
+ attr_accessor :live_handoff_enabled
3132
+ alias_method :live_handoff_enabled?, :live_handoff_enabled
3133
+
3019
3134
  # Optional. The reCAPTCHA token generated by the client-side chat widget.
3020
3135
  # Corresponds to the JSON property `recaptchaToken`
3021
3136
  # @return [String]
@@ -3028,6 +3143,7 @@ module Google
3028
3143
  # Update properties of this object
3029
3144
  def update!(**args)
3030
3145
  @deployment = args[:deployment] if args.key?(:deployment)
3146
+ @live_handoff_enabled = args[:live_handoff_enabled] if args.key?(:live_handoff_enabled)
3031
3147
  @recaptcha_token = args[:recaptcha_token] if args.key?(:recaptcha_token)
3032
3148
  end
3033
3149
  end
@@ -4170,6 +4286,14 @@ module Google
4170
4286
  # @return [Google::Apis::CesV1::ApiAuthentication]
4171
4287
  attr_accessor :api_authentication
4172
4288
 
4289
+ # Optional. The custom headers to send in the request to the MCP server. The
4290
+ # values must be in the format `$context.variables.` and can be set in the
4291
+ # session variables. See https://docs.cloud.google.com/customer-engagement-ai/
4292
+ # conversational-agents/ps/tool/open-api#openapi-injection for more details.
4293
+ # Corresponds to the JSON property `customHeaders`
4294
+ # @return [Hash<String,String>]
4295
+ attr_accessor :custom_headers
4296
+
4173
4297
  # Optional. The description of the MCP tool.
4174
4298
  # Corresponds to the JSON property `description`
4175
4299
  # @return [String]
@@ -4216,6 +4340,7 @@ module Google
4216
4340
  # Update properties of this object
4217
4341
  def update!(**args)
4218
4342
  @api_authentication = args[:api_authentication] if args.key?(:api_authentication)
4343
+ @custom_headers = args[:custom_headers] if args.key?(:custom_headers)
4219
4344
  @description = args[:description] if args.key?(:description)
4220
4345
  @input_schema = args[:input_schema] if args.key?(:input_schema)
4221
4346
  @name = args[:name] if args.key?(:name)
@@ -4235,6 +4360,14 @@ module Google
4235
4360
  # @return [Google::Apis::CesV1::ApiAuthentication]
4236
4361
  attr_accessor :api_authentication
4237
4362
 
4363
+ # Optional. The custom headers to send in the request to the MCP server. The
4364
+ # values must be in the format `$context.variables.` and can be set in the
4365
+ # session variables. See https://docs.cloud.google.com/customer-engagement-ai/
4366
+ # conversational-agents/ps/tool/open-api#openapi-injection for more details.
4367
+ # Corresponds to the JSON property `customHeaders`
4368
+ # @return [Hash<String,String>]
4369
+ attr_accessor :custom_headers
4370
+
4238
4371
  # Required. The address of the MCP server, for example, "https://example.com/mcp/
4239
4372
  # ". If the server is built with the MCP SDK, the url should be suffixed with "/
4240
4373
  # mcp/". Only Streamable HTTP transport based servers are supported. See https://
@@ -4261,6 +4394,7 @@ module Google
4261
4394
  # Update properties of this object
4262
4395
  def update!(**args)
4263
4396
  @api_authentication = args[:api_authentication] if args.key?(:api_authentication)
4397
+ @custom_headers = args[:custom_headers] if args.key?(:custom_headers)
4264
4398
  @server_address = args[:server_address] if args.key?(:server_address)
4265
4399
  @service_directory_config = args[:service_directory_config] if args.key?(:service_directory_config)
4266
4400
  @tls_config = args[:tls_config] if args.key?(:tls_config)
@@ -5299,6 +5433,50 @@ module Google
5299
5433
  end
5300
5434
  end
5301
5435
 
5436
+ # Project/Location level security settings for CES.
5437
+ class SecuritySettings
5438
+ include Google::Apis::Core::Hashable
5439
+
5440
+ # Output only. Create time of the security settings.
5441
+ # Corresponds to the JSON property `createTime`
5442
+ # @return [String]
5443
+ attr_accessor :create_time
5444
+
5445
+ # Defines project/location level endpoint control policy.
5446
+ # Corresponds to the JSON property `endpointControlPolicy`
5447
+ # @return [Google::Apis::CesV1::EndpointControlPolicy]
5448
+ attr_accessor :endpoint_control_policy
5449
+
5450
+ # Output only. Etag of the security settings.
5451
+ # Corresponds to the JSON property `etag`
5452
+ # @return [String]
5453
+ attr_accessor :etag
5454
+
5455
+ # Identifier. The unique identifier of the security settings. Format: `projects/`
5456
+ # project`/locations/`location`/securitySettings`
5457
+ # Corresponds to the JSON property `name`
5458
+ # @return [String]
5459
+ attr_accessor :name
5460
+
5461
+ # Output only. Last update time of the security settings.
5462
+ # Corresponds to the JSON property `updateTime`
5463
+ # @return [String]
5464
+ attr_accessor :update_time
5465
+
5466
+ def initialize(**args)
5467
+ update!(**args)
5468
+ end
5469
+
5470
+ # Update properties of this object
5471
+ def update!(**args)
5472
+ @create_time = args[:create_time] if args.key?(:create_time)
5473
+ @endpoint_control_policy = args[:endpoint_control_policy] if args.key?(:endpoint_control_policy)
5474
+ @etag = args[:etag] if args.key?(:etag)
5475
+ @name = args[:name] if args.key?(:name)
5476
+ @update_time = args[:update_time] if args.key?(:update_time)
5477
+ end
5478
+ end
5479
+
5302
5480
  # Configurations for authentication using a custom service account.
5303
5481
  class ServiceAccountAuthConfig
5304
5482
  include Google::Apis::Core::Hashable
@@ -5377,7 +5555,7 @@ module Google
5377
5555
 
5378
5556
  # Optional. The entry agent to handle the session. If not specified, the session
5379
5557
  # will be handled by the root agent of the app. Format: `projects/`project`/
5380
- # locations/`location`/agents/`agent``
5558
+ # locations/`location`/apps/`app`/agents/`agent``
5381
5559
  # Corresponds to the JSON property `entryAgent`
5382
5560
  # @return [String]
5383
5561
  attr_accessor :entry_agent
@@ -5420,6 +5598,13 @@ module Google
5420
5598
  # @return [String]
5421
5599
  attr_accessor :time_zone
5422
5600
 
5601
+ # Optional. Whether to use tool fakes for the session. If this field is set, the
5602
+ # agent will attempt use tool fakes instead of calling the real tools.
5603
+ # Corresponds to the JSON property `useToolFakes`
5604
+ # @return [Boolean]
5605
+ attr_accessor :use_tool_fakes
5606
+ alias_method :use_tool_fakes?, :use_tool_fakes
5607
+
5423
5608
  def initialize(**args)
5424
5609
  update!(**args)
5425
5610
  end
@@ -5433,6 +5618,7 @@ module Google
5433
5618
  @output_audio_config = args[:output_audio_config] if args.key?(:output_audio_config)
5434
5619
  @remote_dialogflow_query_parameters = args[:remote_dialogflow_query_parameters] if args.key?(:remote_dialogflow_query_parameters)
5435
5620
  @time_zone = args[:time_zone] if args.key?(:time_zone)
5621
+ @use_tool_fakes = args[:use_tool_fakes] if args.key?(:use_tool_fakes)
5436
5622
  end
5437
5623
  end
5438
5624
 
@@ -5850,10 +6036,10 @@ module Google
5850
6036
  # verification. This overrides the default SSL trust store. If this is empty or
5851
6037
  # unspecified, CES will use Google's default trust store to verify certificates.
5852
6038
  # N.B. Make sure the HTTPS server certificates are signed with "subject alt name"
5853
- # . For instance a certificate can be self-signed using the following command,
5854
- # openssl x509 -req -days 200 -in example.com.csr \ -signkey example.com.key \ -
5855
- # out example.com.crt \ -extfile <(printf "\nsubjectAltName='DNS:www.example.com'
5856
- # ")
6039
+ # . For instance a certificate can be self-signed using the following command: ``
6040
+ # ` openssl x509 -req -days 200 -in example.com.csr \ -signkey example.com.key \
6041
+ # -out example.com.crt \ -extfile <(printf "\nsubjectAltName='DNS:www.example.
6042
+ # com'") ```
5857
6043
  # Corresponds to the JSON property `cert`
5858
6044
  # NOTE: Values are automatically base64 encoded/decoded in the client library.
5859
6045
  # @return [String]
@@ -5881,6 +6067,11 @@ module Google
5881
6067
  class Tool
5882
6068
  include Google::Apis::Core::Hashable
5883
6069
 
6070
+ # Represents a tool that allows the agent to call another agent.
6071
+ # Corresponds to the JSON property `agentTool`
6072
+ # @return [Google::Apis::CesV1::AgentTool]
6073
+ attr_accessor :agent_tool
6074
+
5884
6075
  # Represents a client-side function that the agent can invoke. When the tool is
5885
6076
  # chosen by the agent, control is handed off to the client. The client is
5886
6077
  # responsible for executing the function and returning the result as a
@@ -5953,11 +6144,11 @@ module Google
5953
6144
  # @return [Google::Apis::CesV1::McpTool]
5954
6145
  attr_accessor :mcp_tool
5955
6146
 
5956
- # Identifier. The unique identifier of the tool. Format: - `projects/`project`/
5957
- # locations/`location`/apps/`app`/tools/`tool`` for ## standalone tools. `
6147
+ # Identifier. The resource name of the tool. Format: * `projects/`project`/
6148
+ # locations/`location`/apps/`app`/tools/`tool`` for standalone tools. * `
5958
6149
  # projects/`project`/locations/`location`/apps/`app`/toolsets/`toolset`/tools/`
5959
6150
  # tool`` for tools retrieved from a toolset. These tools are dynamic and output-
5960
- # only, they cannot be referenced directly where a tool is expected.
6151
+ # only; they cannot be referenced directly where a tool is expected.
5961
6152
  # Corresponds to the JSON property `name`
5962
6153
  # @return [String]
5963
6154
  attr_accessor :name
@@ -6001,6 +6192,7 @@ module Google
6001
6192
 
6002
6193
  # Update properties of this object
6003
6194
  def update!(**args)
6195
+ @agent_tool = args[:agent_tool] if args.key?(:agent_tool)
6004
6196
  @client_function = args[:client_function] if args.key?(:client_function)
6005
6197
  @connector_tool = args[:connector_tool] if args.key?(:connector_tool)
6006
6198
  @create_time = args[:create_time] if args.key?(:create_time)
@@ -6522,6 +6714,12 @@ module Google
6522
6714
  class WidgetTool
6523
6715
  include Google::Apis::Core::Hashable
6524
6716
 
6717
+ # Configuration for mapping data from a source tool to the widget's input
6718
+ # parameters.
6719
+ # Corresponds to the JSON property `dataMapping`
6720
+ # @return [Google::Apis::CesV1::WidgetToolDataMapping]
6721
+ attr_accessor :data_mapping
6722
+
6525
6723
  # Optional. The description of the widget tool.
6526
6724
  # Corresponds to the JSON property `description`
6527
6725
  # @return [String]
@@ -6537,6 +6735,11 @@ module Google
6537
6735
  # @return [Google::Apis::CesV1::Schema]
6538
6736
  attr_accessor :parameters
6539
6737
 
6738
+ # Optional. Configuration for rendering the widget.
6739
+ # Corresponds to the JSON property `uiConfig`
6740
+ # @return [Hash<String,Object>]
6741
+ attr_accessor :ui_config
6742
+
6540
6743
  # Optional. The type of the widget tool. If not specified, the default type will
6541
6744
  # be CUSTOMIZED.
6542
6745
  # Corresponds to the JSON property `widgetType`
@@ -6549,12 +6752,57 @@ module Google
6549
6752
 
6550
6753
  # Update properties of this object
6551
6754
  def update!(**args)
6755
+ @data_mapping = args[:data_mapping] if args.key?(:data_mapping)
6552
6756
  @description = args[:description] if args.key?(:description)
6553
6757
  @name = args[:name] if args.key?(:name)
6554
6758
  @parameters = args[:parameters] if args.key?(:parameters)
6759
+ @ui_config = args[:ui_config] if args.key?(:ui_config)
6555
6760
  @widget_type = args[:widget_type] if args.key?(:widget_type)
6556
6761
  end
6557
6762
  end
6763
+
6764
+ # Configuration for mapping data from a source tool to the widget's input
6765
+ # parameters.
6766
+ class WidgetToolDataMapping
6767
+ include Google::Apis::Core::Hashable
6768
+
6769
+ # Optional. A map of widget input parameter fields to the corresponding output
6770
+ # fields of the source tool.
6771
+ # Corresponds to the JSON property `fieldMappings`
6772
+ # @return [Hash<String,String>]
6773
+ attr_accessor :field_mappings
6774
+
6775
+ # Optional. The mode of the data mapping.
6776
+ # Corresponds to the JSON property `mode`
6777
+ # @return [String]
6778
+ attr_accessor :mode
6779
+
6780
+ # Optional. A Python script used to transform the source tool's output into the
6781
+ # widget's input format. This is used when the mapping is too complex for simple
6782
+ # field mappings.
6783
+ # Corresponds to the JSON property `pythonScript`
6784
+ # @return [String]
6785
+ attr_accessor :python_script
6786
+
6787
+ # Optional. The resource name of the tool that provides the data for the widget (
6788
+ # e.g., a search tool or a custom function). Format: `projects/`project`/
6789
+ # locations/`location`/agents/`agent`/tools/`tool``
6790
+ # Corresponds to the JSON property `sourceToolName`
6791
+ # @return [String]
6792
+ attr_accessor :source_tool_name
6793
+
6794
+ def initialize(**args)
6795
+ update!(**args)
6796
+ end
6797
+
6798
+ # Update properties of this object
6799
+ def update!(**args)
6800
+ @field_mappings = args[:field_mappings] if args.key?(:field_mappings)
6801
+ @mode = args[:mode] if args.key?(:mode)
6802
+ @python_script = args[:python_script] if args.key?(:python_script)
6803
+ @source_tool_name = args[:source_tool_name] if args.key?(:source_tool_name)
6804
+ end
6805
+ end
6558
6806
  end
6559
6807
  end
6560
6808
  end
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module CesV1
18
18
  # Version of the google-apis-ces_v1 gem
19
- GEM_VERSION = "0.3.0"
19
+ GEM_VERSION = "0.5.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.18.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20260218"
25
+ REVISION = "20260312"
26
26
  end
27
27
  end
28
28
  end
@@ -58,6 +58,12 @@ module Google
58
58
  include Google::Apis::Core::JsonObjectSupport
59
59
  end
60
60
 
61
+ class AgentTool
62
+ class Representation < Google::Apis::Core::JsonRepresentation; end
63
+
64
+ include Google::Apis::Core::JsonObjectSupport
65
+ end
66
+
61
67
  class AgentTransfer
62
68
  class Representation < Google::Apis::Core::JsonRepresentation; end
63
69
 
@@ -394,6 +400,18 @@ module Google
394
400
  include Google::Apis::Core::JsonObjectSupport
395
401
  end
396
402
 
403
+ class EndpointControlPolicy
404
+ class Representation < Google::Apis::Core::JsonRepresentation; end
405
+
406
+ include Google::Apis::Core::JsonObjectSupport
407
+ end
408
+
409
+ class ErrorHandlingSettings
410
+ class Representation < Google::Apis::Core::JsonRepresentation; end
411
+
412
+ include Google::Apis::Core::JsonObjectSupport
413
+ end
414
+
397
415
  class EvaluationMetricsThresholds
398
416
  class Representation < Google::Apis::Core::JsonRepresentation; end
399
417
 
@@ -850,6 +868,12 @@ module Google
850
868
  include Google::Apis::Core::JsonObjectSupport
851
869
  end
852
870
 
871
+ class SecuritySettings
872
+ class Representation < Google::Apis::Core::JsonRepresentation; end
873
+
874
+ include Google::Apis::Core::JsonObjectSupport
875
+ end
876
+
853
877
  class ServiceAccountAuthConfig
854
878
  class Representation < Google::Apis::Core::JsonRepresentation; end
855
879
 
@@ -1048,6 +1072,12 @@ module Google
1048
1072
  include Google::Apis::Core::JsonObjectSupport
1049
1073
  end
1050
1074
 
1075
+ class WidgetToolDataMapping
1076
+ class Representation < Google::Apis::Core::JsonRepresentation; end
1077
+
1078
+ include Google::Apis::Core::JsonObjectSupport
1079
+ end
1080
+
1051
1081
  class Action
1052
1082
  # @private
1053
1083
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1132,6 +1162,15 @@ module Google
1132
1162
  end
1133
1163
  end
1134
1164
 
1165
+ class AgentTool
1166
+ # @private
1167
+ class Representation < Google::Apis::Core::JsonRepresentation
1168
+ property :description, as: 'description'
1169
+ property :name, as: 'name'
1170
+ property :root_agent, as: 'rootAgent'
1171
+ end
1172
+ end
1173
+
1135
1174
  class AgentTransfer
1136
1175
  # @private
1137
1176
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1190,6 +1229,8 @@ module Google
1190
1229
  property :deployment_count, as: 'deploymentCount'
1191
1230
  property :description, as: 'description'
1192
1231
  property :display_name, as: 'displayName'
1232
+ property :error_handling_settings, as: 'errorHandlingSettings', class: Google::Apis::CesV1::ErrorHandlingSettings, decorator: Google::Apis::CesV1::ErrorHandlingSettings::Representation
1233
+
1193
1234
  property :etag, as: 'etag'
1194
1235
  property :evaluation_metrics_thresholds, as: 'evaluationMetricsThresholds', class: Google::Apis::CesV1::EvaluationMetricsThresholds, decorator: Google::Apis::CesV1::EvaluationMetricsThresholds::Representation
1195
1236
 
@@ -1401,6 +1442,8 @@ module Google
1401
1442
  class Representation < Google::Apis::Core::JsonRepresentation
1402
1443
  property :agent_transfer, as: 'agentTransfer', class: Google::Apis::CesV1::AgentTransfer, decorator: Google::Apis::CesV1::AgentTransfer::Representation
1403
1444
 
1445
+ property :blob, as: 'blob', class: Google::Apis::CesV1::Blob, decorator: Google::Apis::CesV1::Blob::Representation
1446
+
1404
1447
  hash :default_variables, as: 'defaultVariables'
1405
1448
  property :image, as: 'image', class: Google::Apis::CesV1::Image, decorator: Google::Apis::CesV1::Image::Representation
1406
1449
 
@@ -1743,6 +1786,21 @@ module Google
1743
1786
  end
1744
1787
  end
1745
1788
 
1789
+ class EndpointControlPolicy
1790
+ # @private
1791
+ class Representation < Google::Apis::Core::JsonRepresentation
1792
+ collection :allowed_origins, as: 'allowedOrigins'
1793
+ property :enforcement_scope, as: 'enforcementScope'
1794
+ end
1795
+ end
1796
+
1797
+ class ErrorHandlingSettings
1798
+ # @private
1799
+ class Representation < Google::Apis::Core::JsonRepresentation
1800
+ property :error_handling_strategy, as: 'errorHandlingStrategy'
1801
+ end
1802
+ end
1803
+
1746
1804
  class EvaluationMetricsThresholds
1747
1805
  # @private
1748
1806
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1816,6 +1874,7 @@ module Google
1816
1874
  # @private
1817
1875
  class Representation < Google::Apis::Core::JsonRepresentation
1818
1876
  hash :args, as: 'args'
1877
+ hash :context, as: 'context'
1819
1878
  property :tool, as: 'tool'
1820
1879
  property :toolset_tool, as: 'toolsetTool', class: Google::Apis::CesV1::ToolsetTool, decorator: Google::Apis::CesV1::ToolsetTool::Representation
1821
1880
 
@@ -1837,6 +1896,7 @@ module Google
1837
1896
  class ExportAppRequest
1838
1897
  # @private
1839
1898
  class Representation < Google::Apis::Core::JsonRepresentation
1899
+ property :app_version, as: 'appVersion'
1840
1900
  property :export_format, as: 'exportFormat'
1841
1901
  property :gcs_uri, as: 'gcsUri'
1842
1902
  end
@@ -1871,6 +1931,7 @@ module Google
1871
1931
  # @private
1872
1932
  class Representation < Google::Apis::Core::JsonRepresentation
1873
1933
  property :deployment, as: 'deployment'
1934
+ property :live_handoff_enabled, as: 'liveHandoffEnabled'
1874
1935
  property :recaptcha_token, as: 'recaptchaToken'
1875
1936
  end
1876
1937
  end
@@ -2211,6 +2272,7 @@ module Google
2211
2272
  class Representation < Google::Apis::Core::JsonRepresentation
2212
2273
  property :api_authentication, as: 'apiAuthentication', class: Google::Apis::CesV1::ApiAuthentication, decorator: Google::Apis::CesV1::ApiAuthentication::Representation
2213
2274
 
2275
+ hash :custom_headers, as: 'customHeaders'
2214
2276
  property :description, as: 'description'
2215
2277
  property :input_schema, as: 'inputSchema', class: Google::Apis::CesV1::Schema, decorator: Google::Apis::CesV1::Schema::Representation
2216
2278
 
@@ -2230,6 +2292,7 @@ module Google
2230
2292
  class Representation < Google::Apis::Core::JsonRepresentation
2231
2293
  property :api_authentication, as: 'apiAuthentication', class: Google::Apis::CesV1::ApiAuthentication, decorator: Google::Apis::CesV1::ApiAuthentication::Representation
2232
2294
 
2295
+ hash :custom_headers, as: 'customHeaders'
2233
2296
  property :server_address, as: 'serverAddress'
2234
2297
  property :service_directory_config, as: 'serviceDirectoryConfig', class: Google::Apis::CesV1::ServiceDirectoryConfig, decorator: Google::Apis::CesV1::ServiceDirectoryConfig::Representation
2235
2298
 
@@ -2531,6 +2594,18 @@ module Google
2531
2594
  end
2532
2595
  end
2533
2596
 
2597
+ class SecuritySettings
2598
+ # @private
2599
+ class Representation < Google::Apis::Core::JsonRepresentation
2600
+ property :create_time, as: 'createTime'
2601
+ property :endpoint_control_policy, as: 'endpointControlPolicy', class: Google::Apis::CesV1::EndpointControlPolicy, decorator: Google::Apis::CesV1::EndpointControlPolicy::Representation
2602
+
2603
+ property :etag, as: 'etag'
2604
+ property :name, as: 'name'
2605
+ property :update_time, as: 'updateTime'
2606
+ end
2607
+ end
2608
+
2534
2609
  class ServiceAccountAuthConfig
2535
2610
  # @private
2536
2611
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -2566,6 +2641,7 @@ module Google
2566
2641
  property :remote_dialogflow_query_parameters, as: 'remoteDialogflowQueryParameters', class: Google::Apis::CesV1::SessionConfigRemoteDialogflowQueryParameters, decorator: Google::Apis::CesV1::SessionConfigRemoteDialogflowQueryParameters::Representation
2567
2642
 
2568
2643
  property :time_zone, as: 'timeZone'
2644
+ property :use_tool_fakes, as: 'useToolFakes'
2569
2645
  end
2570
2646
  end
2571
2647
 
@@ -2692,6 +2768,8 @@ module Google
2692
2768
  class Tool
2693
2769
  # @private
2694
2770
  class Representation < Google::Apis::Core::JsonRepresentation
2771
+ property :agent_tool, as: 'agentTool', class: Google::Apis::CesV1::AgentTool, decorator: Google::Apis::CesV1::AgentTool::Representation
2772
+
2695
2773
  property :client_function, as: 'clientFunction', class: Google::Apis::CesV1::ClientFunction, decorator: Google::Apis::CesV1::ClientFunction::Representation
2696
2774
 
2697
2775
  property :connector_tool, as: 'connectorTool', class: Google::Apis::CesV1::ConnectorTool, decorator: Google::Apis::CesV1::ConnectorTool::Representation
@@ -2885,13 +2963,26 @@ module Google
2885
2963
  class WidgetTool
2886
2964
  # @private
2887
2965
  class Representation < Google::Apis::Core::JsonRepresentation
2966
+ property :data_mapping, as: 'dataMapping', class: Google::Apis::CesV1::WidgetToolDataMapping, decorator: Google::Apis::CesV1::WidgetToolDataMapping::Representation
2967
+
2888
2968
  property :description, as: 'description'
2889
2969
  property :name, as: 'name'
2890
2970
  property :parameters, as: 'parameters', class: Google::Apis::CesV1::Schema, decorator: Google::Apis::CesV1::Schema::Representation
2891
2971
 
2972
+ hash :ui_config, as: 'uiConfig'
2892
2973
  property :widget_type, as: 'widgetType'
2893
2974
  end
2894
2975
  end
2976
+
2977
+ class WidgetToolDataMapping
2978
+ # @private
2979
+ class Representation < Google::Apis::Core::JsonRepresentation
2980
+ hash :field_mappings, as: 'fieldMappings'
2981
+ property :mode, as: 'mode'
2982
+ property :python_script, as: 'pythonScript'
2983
+ property :source_tool_name, as: 'sourceToolName'
2984
+ end
2985
+ end
2895
2986
  end
2896
2987
  end
2897
2988
  end
@@ -30,7 +30,7 @@ module Google
30
30
  # Ces = Google::Apis::CesV1 # Alias the module
31
31
  # service = Ces::CustomerEngagementSuiteService.new
32
32
  #
33
- # @see https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference
33
+ # @see https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps
34
34
  class CustomerEngagementSuiteService < Google::Apis::Core::BaseService
35
35
  DEFAULT_ENDPOINT_TEMPLATE = "https://ces.$UNIVERSE_DOMAIN$/"
36
36
 
@@ -1038,8 +1038,8 @@ module Google
1038
1038
 
1039
1039
  # Updates the specified deployment.
1040
1040
  # @param [String] name
1041
- # Identifier. The resource name of the deployment. Format: projects/`project`/
1042
- # locations/`location`/apps/`app`/deployments/`deployment`
1041
+ # Identifier. The resource name of the deployment. Format: `projects/`project`/
1042
+ # locations/`location`/apps/`app`/deployments/`deployment``
1043
1043
  # @param [Google::Apis::CesV1::Deployment] deployment_object
1044
1044
  # @param [String] update_mask
1045
1045
  # Optional. The list of fields to update.
@@ -1491,7 +1491,7 @@ module Google
1491
1491
  execute_or_queue_command(command, &block)
1492
1492
  end
1493
1493
 
1494
- # Initiates a single turn interaction with the CES agent within a session.
1494
+ # Initiates a single-turn interaction with the CES agent within a session.
1495
1495
  # @param [String] session
1496
1496
  # Required. The unique identifier of the session. Format: `projects/`project`/
1497
1497
  # locations/`location`/apps/`app`/sessions/`session``
@@ -1684,11 +1684,11 @@ module Google
1684
1684
 
1685
1685
  # Updates the specified tool.
1686
1686
  # @param [String] name
1687
- # Identifier. The unique identifier of the tool. Format: - `projects/`project`/
1688
- # locations/`location`/apps/`app`/tools/`tool`` for ## standalone tools. `
1687
+ # Identifier. The resource name of the tool. Format: * `projects/`project`/
1688
+ # locations/`location`/apps/`app`/tools/`tool`` for standalone tools. * `
1689
1689
  # projects/`project`/locations/`location`/apps/`app`/toolsets/`toolset`/tools/`
1690
1690
  # tool`` for tools retrieved from a toolset. These tools are dynamic and output-
1691
- # only, they cannot be referenced directly where a tool is expected.
1691
+ # only; they cannot be referenced directly where a tool is expected.
1692
1692
  # @param [Google::Apis::CesV1::Tool] tool_object
1693
1693
  # @param [String] update_mask
1694
1694
  # Optional. Field mask is used to control which fields get updated. If the mask
@@ -23,7 +23,7 @@ module Google
23
23
  #
24
24
  #
25
25
  #
26
- # @see https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference
26
+ # @see https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps
27
27
  module CesV1
28
28
  # Version of the Gemini Enterprise for Customer Experience API this client connects to.
29
29
  # This is NOT the gem version.
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-ces_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.3.0
4
+ version: 0.5.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-ces_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-ces_v1/v0.3.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-ces_v1/v0.5.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-ces_v1
63
63
  rdoc_options: []
64
64
  require_paths: