google-apis-ces_v1 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9bc1b2541133ca9fa5fc618d0718d327745498fe274dd7f02f2ac0e098df68fd
-  data.tar.gz: 93c6f06caee89e04cd285e82139b683258ff6c6db23e9dd5ba098c74ee87941e
+  metadata.gz: bf45178bf3c68ee20684f5f428ec6103cd30c68934e23dae9c935718726258ec
+  data.tar.gz: 977cfabdd6487dd54535811523e00265f1b9520ec195cd204af64b0706bb899b
 SHA512:
-  metadata.gz: 5939499dc9722cdd27629556ceec809ef43a0ba5f5386a02a87decab0a439620cbb3f9f3202ad96e47217bd9e5766055d59d42162c01114996a905acb5de4247
-  data.tar.gz: b7e5252f4e572a1a114fae6d9ad693c170a364728a9857f6a09a62af56a4e1fd5ce3a72171ac3685ce546dda7fa2194b6ef78dbfe815bb556e6cf680baabb620
+  metadata.gz: 0a03b9e31664a8f19bd65047e51044583ffd84030bb3878e3a3c1280379bc9b37ef1d5ef164afac6376c334dac79d97aeba41b36edf3bdc96fa450004677229e
+  data.tar.gz: df73ef5fb0e38b0d169728dc1d1ccde663a1ae28b26de32c0215ac7e4d3f3a63dceffb9c1f8775175d0aa72f5fb5d75d0fa37ca172214cb3fb8cfd059ba08a6f

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-ces_v1
 
+### v0.5.0 (2026-03-15)
+
+* Regenerated from discovery document revision 20260312
+
 ### v0.4.0 (2026-03-08)
 
 * Regenerated from discovery document revision 20260227

data/OVERVIEW.md

@@ -79,7 +79,7 @@ Gem names for modern clients are often of the form `google-cloud-<service_name>`
 
 **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.
 
-The [product documentation](https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference) may provide guidance regarding the preferred client library to use.
+The [product documentation](https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps) may provide guidance regarding the preferred client library to use.
 
 ## Supported Ruby versions
 

data/lib/google/apis/ces_v1/classes.rb

@@ -373,6 +373,38 @@ module Google
         end
       end
       
+      # Represents a tool that allows the agent to call another agent.
+      class AgentTool
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Description of the tool's purpose.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Required. The name of the agent tool.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Optional. The resource name of the root agent that is the entry point of the
+        # tool. Format: `projects/`project`/locations/`location`/agents/`agent``
+        # Corresponds to the JSON property `rootAgent`
+        # @return [String]
+        attr_accessor :root_agent
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @description = args[:description] if args.key?(:description)
+          @name = args[:name] if args.key?(:name)
+          @root_agent = args[:root_agent] if args.key?(:root_agent)
+        end
+      end
+      
       # Represents an event indicating the transfer of a conversation to a different
       # agent.
       class AgentTransfer
@@ -2885,6 +2917,13 @@ module Google
         # @return [Hash<String,Object>]
         attr_accessor :args
       
+        # Optional. The [ToolCallContext](https://docs.cloud.google.com/customer-
+        # engagement-ai/conversational-agents/ps/tool/python#environment for details) to
+        # be passed to the Python tool.
+        # Corresponds to the JSON property `context`
+        # @return [Hash<String,Object>]
+        attr_accessor :context
+      
         # Optional. The name of the tool to execute. Format: projects/`project`/
         # locations/`location`/apps/`app`/tools/`tool`
         # Corresponds to the JSON property `tool`
@@ -2908,6 +2947,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @args = args[:args] if args.key?(:args)
+          @context = args[:context] if args.key?(:context)
           @tool = args[:tool] if args.key?(:tool)
           @toolset_tool = args[:toolset_tool] if args.key?(:toolset_tool)
           @variables = args[:variables] if args.key?(:variables)
@@ -2959,6 +2999,12 @@ module Google
       class ExportAppRequest
         include Google::Apis::Core::Hashable
       
+        # Optional. The resource name of the app version to export. Format: `projects/`
+        # project`/locations/`location`/apps/`app`/versions/`version``.
+        # Corresponds to the JSON property `appVersion`
+        # @return [String]
+        attr_accessor :app_version
+      
         # Required. The format to export the app in.
         # Corresponds to the JSON property `exportFormat`
         # @return [String]
@@ -2977,6 +3023,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @app_version = args[:app_version] if args.key?(:app_version)
           @export_format = args[:export_format] if args.key?(:export_format)
           @gcs_uri = args[:gcs_uri] if args.key?(:gcs_uri)
         end
@@ -3078,6 +3125,12 @@ module Google
         # @return [String]
         attr_accessor :deployment
       
+        # Optional. Indicates if live handoff is enabled for the session.
+        # Corresponds to the JSON property `liveHandoffEnabled`
+        # @return [Boolean]
+        attr_accessor :live_handoff_enabled
+        alias_method :live_handoff_enabled?, :live_handoff_enabled
+      
         # Optional. The reCAPTCHA token generated by the client-side chat widget.
         # Corresponds to the JSON property `recaptchaToken`
         # @return [String]
@@ -3090,6 +3143,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @deployment = args[:deployment] if args.key?(:deployment)
+          @live_handoff_enabled = args[:live_handoff_enabled] if args.key?(:live_handoff_enabled)
           @recaptcha_token = args[:recaptcha_token] if args.key?(:recaptcha_token)
         end
       end
@@ -4232,6 +4286,14 @@ module Google
         # @return [Google::Apis::CesV1::ApiAuthentication]
         attr_accessor :api_authentication
       
+        # Optional. The custom headers to send in the request to the MCP server. The
+        # values must be in the format `$context.variables.` and can be set in the
+        # session variables. See https://docs.cloud.google.com/customer-engagement-ai/
+        # conversational-agents/ps/tool/open-api#openapi-injection for more details.
+        # Corresponds to the JSON property `customHeaders`
+        # @return [Hash<String,String>]
+        attr_accessor :custom_headers
+      
         # Optional. The description of the MCP tool.
         # Corresponds to the JSON property `description`
         # @return [String]
@@ -4278,6 +4340,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @api_authentication = args[:api_authentication] if args.key?(:api_authentication)
+          @custom_headers = args[:custom_headers] if args.key?(:custom_headers)
           @description = args[:description] if args.key?(:description)
           @input_schema = args[:input_schema] if args.key?(:input_schema)
           @name = args[:name] if args.key?(:name)
@@ -4297,6 +4360,14 @@ module Google
         # @return [Google::Apis::CesV1::ApiAuthentication]
         attr_accessor :api_authentication
       
+        # Optional. The custom headers to send in the request to the MCP server. The
+        # values must be in the format `$context.variables.` and can be set in the
+        # session variables. See https://docs.cloud.google.com/customer-engagement-ai/
+        # conversational-agents/ps/tool/open-api#openapi-injection for more details.
+        # Corresponds to the JSON property `customHeaders`
+        # @return [Hash<String,String>]
+        attr_accessor :custom_headers
+      
         # Required. The address of the MCP server, for example, "https://example.com/mcp/
         # ". If the server is built with the MCP SDK, the url should be suffixed with "/
         # mcp/". Only Streamable HTTP transport based servers are supported. See https://
@@ -4323,6 +4394,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @api_authentication = args[:api_authentication] if args.key?(:api_authentication)
+          @custom_headers = args[:custom_headers] if args.key?(:custom_headers)
           @server_address = args[:server_address] if args.key?(:server_address)
           @service_directory_config = args[:service_directory_config] if args.key?(:service_directory_config)
           @tls_config = args[:tls_config] if args.key?(:tls_config)
@@ -5995,6 +6067,11 @@ module Google
       class Tool
         include Google::Apis::Core::Hashable
       
+        # Represents a tool that allows the agent to call another agent.
+        # Corresponds to the JSON property `agentTool`
+        # @return [Google::Apis::CesV1::AgentTool]
+        attr_accessor :agent_tool
+      
         # Represents a client-side function that the agent can invoke. When the tool is
         # chosen by the agent, control is handed off to the client. The client is
         # responsible for executing the function and returning the result as a
@@ -6115,6 +6192,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @agent_tool = args[:agent_tool] if args.key?(:agent_tool)
           @client_function = args[:client_function] if args.key?(:client_function)
           @connector_tool = args[:connector_tool] if args.key?(:connector_tool)
           @create_time = args[:create_time] if args.key?(:create_time)
@@ -6636,6 +6714,12 @@ module Google
       class WidgetTool
         include Google::Apis::Core::Hashable
       
+        # Configuration for mapping data from a source tool to the widget's input
+        # parameters.
+        # Corresponds to the JSON property `dataMapping`
+        # @return [Google::Apis::CesV1::WidgetToolDataMapping]
+        attr_accessor :data_mapping
+      
         # Optional. The description of the widget tool.
         # Corresponds to the JSON property `description`
         # @return [String]
@@ -6651,6 +6735,11 @@ module Google
         # @return [Google::Apis::CesV1::Schema]
         attr_accessor :parameters
       
+        # Optional. Configuration for rendering the widget.
+        # Corresponds to the JSON property `uiConfig`
+        # @return [Hash<String,Object>]
+        attr_accessor :ui_config
+      
         # Optional. The type of the widget tool. If not specified, the default type will
         # be CUSTOMIZED.
         # Corresponds to the JSON property `widgetType`
@@ -6663,12 +6752,57 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @data_mapping = args[:data_mapping] if args.key?(:data_mapping)
           @description = args[:description] if args.key?(:description)
           @name = args[:name] if args.key?(:name)
           @parameters = args[:parameters] if args.key?(:parameters)
+          @ui_config = args[:ui_config] if args.key?(:ui_config)
           @widget_type = args[:widget_type] if args.key?(:widget_type)
         end
       end
+      
+      # Configuration for mapping data from a source tool to the widget's input
+      # parameters.
+      class WidgetToolDataMapping
+        include Google::Apis::Core::Hashable
+      
+        # Optional. A map of widget input parameter fields to the corresponding output
+        # fields of the source tool.
+        # Corresponds to the JSON property `fieldMappings`
+        # @return [Hash<String,String>]
+        attr_accessor :field_mappings
+      
+        # Optional. The mode of the data mapping.
+        # Corresponds to the JSON property `mode`
+        # @return [String]
+        attr_accessor :mode
+      
+        # Optional. A Python script used to transform the source tool's output into the
+        # widget's input format. This is used when the mapping is too complex for simple
+        # field mappings.
+        # Corresponds to the JSON property `pythonScript`
+        # @return [String]
+        attr_accessor :python_script
+      
+        # Optional. The resource name of the tool that provides the data for the widget (
+        # e.g., a search tool or a custom function). Format: `projects/`project`/
+        # locations/`location`/agents/`agent`/tools/`tool``
+        # Corresponds to the JSON property `sourceToolName`
+        # @return [String]
+        attr_accessor :source_tool_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @field_mappings = args[:field_mappings] if args.key?(:field_mappings)
+          @mode = args[:mode] if args.key?(:mode)
+          @python_script = args[:python_script] if args.key?(:python_script)
+          @source_tool_name = args[:source_tool_name] if args.key?(:source_tool_name)
+        end
+      end
     end
   end
 end

data/lib/google/apis/ces_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CesV1
       # Version of the google-apis-ces_v1 gem
-      GEM_VERSION = "0.4.0"
+      GEM_VERSION = "0.5.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20260227"
+      REVISION = "20260312"
     end
   end
 end

data/lib/google/apis/ces_v1/representations.rb

@@ -58,6 +58,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AgentTool
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AgentTransfer
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1066,6 +1072,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class WidgetToolDataMapping
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Action
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1150,6 +1162,15 @@ module Google
         end
       end
       
+      class AgentTool
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :description, as: 'description'
+          property :name, as: 'name'
+          property :root_agent, as: 'rootAgent'
+        end
+      end
+      
       class AgentTransfer
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1853,6 +1874,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           hash :args, as: 'args'
+          hash :context, as: 'context'
           property :tool, as: 'tool'
           property :toolset_tool, as: 'toolsetTool', class: Google::Apis::CesV1::ToolsetTool, decorator: Google::Apis::CesV1::ToolsetTool::Representation
       
@@ -1874,6 +1896,7 @@ module Google
       class ExportAppRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :app_version, as: 'appVersion'
           property :export_format, as: 'exportFormat'
           property :gcs_uri, as: 'gcsUri'
         end
@@ -1908,6 +1931,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :deployment, as: 'deployment'
+          property :live_handoff_enabled, as: 'liveHandoffEnabled'
           property :recaptcha_token, as: 'recaptchaToken'
         end
       end
@@ -2248,6 +2272,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :api_authentication, as: 'apiAuthentication', class: Google::Apis::CesV1::ApiAuthentication, decorator: Google::Apis::CesV1::ApiAuthentication::Representation
       
+          hash :custom_headers, as: 'customHeaders'
           property :description, as: 'description'
           property :input_schema, as: 'inputSchema', class: Google::Apis::CesV1::Schema, decorator: Google::Apis::CesV1::Schema::Representation
       
@@ -2267,6 +2292,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :api_authentication, as: 'apiAuthentication', class: Google::Apis::CesV1::ApiAuthentication, decorator: Google::Apis::CesV1::ApiAuthentication::Representation
       
+          hash :custom_headers, as: 'customHeaders'
           property :server_address, as: 'serverAddress'
           property :service_directory_config, as: 'serviceDirectoryConfig', class: Google::Apis::CesV1::ServiceDirectoryConfig, decorator: Google::Apis::CesV1::ServiceDirectoryConfig::Representation
       
@@ -2742,6 +2768,8 @@ module Google
       class Tool
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :agent_tool, as: 'agentTool', class: Google::Apis::CesV1::AgentTool, decorator: Google::Apis::CesV1::AgentTool::Representation
+      
           property :client_function, as: 'clientFunction', class: Google::Apis::CesV1::ClientFunction, decorator: Google::Apis::CesV1::ClientFunction::Representation
       
           property :connector_tool, as: 'connectorTool', class: Google::Apis::CesV1::ConnectorTool, decorator: Google::Apis::CesV1::ConnectorTool::Representation
@@ -2935,13 +2963,26 @@ module Google
       class WidgetTool
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :data_mapping, as: 'dataMapping', class: Google::Apis::CesV1::WidgetToolDataMapping, decorator: Google::Apis::CesV1::WidgetToolDataMapping::Representation
+      
           property :description, as: 'description'
           property :name, as: 'name'
           property :parameters, as: 'parameters', class: Google::Apis::CesV1::Schema, decorator: Google::Apis::CesV1::Schema::Representation
       
+          hash :ui_config, as: 'uiConfig'
           property :widget_type, as: 'widgetType'
         end
       end
+      
+      class WidgetToolDataMapping
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :field_mappings, as: 'fieldMappings'
+          property :mode, as: 'mode'
+          property :python_script, as: 'pythonScript'
+          property :source_tool_name, as: 'sourceToolName'
+        end
+      end
     end
   end
 end

data/lib/google/apis/ces_v1/service.rb

@@ -30,7 +30,7 @@ module Google
       #    Ces = Google::Apis::CesV1 # Alias the module
       #    service = Ces::CustomerEngagementSuiteService.new
       #
-      # @see https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference
+      # @see https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps
       class CustomerEngagementSuiteService < Google::Apis::Core::BaseService
         DEFAULT_ENDPOINT_TEMPLATE = "https://ces.$UNIVERSE_DOMAIN$/"
 
@@ -1491,7 +1491,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Initiates a single turn interaction with the CES agent within a session.
+        # Initiates a single-turn interaction with the CES agent within a session.
         # @param [String] session
         #   Required. The unique identifier of the session. Format: `projects/`project`/
         #   locations/`location`/apps/`app`/sessions/`session``

data/lib/google/apis/ces_v1.rb

@@ -23,7 +23,7 @@ module Google
     #
     # 
     #
-    # @see https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference
+    # @see https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps
     module CesV1
       # Version of the Gemini Enterprise for Customer Experience API this client connects to.
       # This is NOT the gem version.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-ces_v1
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Google LLC
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-ces_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-ces_v1/v0.4.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-ces_v1/v0.5.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-ces_v1
 rdoc_options: []
 require_paths: