google-cloud-dialogflow-cx-v3 1.1.1 → 1.3.0

data/lib/google/cloud/dialogflow/cx/v3/transition_route_groups/rest/client.rb

@@ -158,15 +158,27 @@ module Google
                     endpoint: @config.endpoint,
                     endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
                     universe_domain: @config.universe_domain,
-                    credentials: credentials
+                    credentials: credentials,
+                    logger: @config.logger
                   )
 
+                  @transition_route_groups_stub.logger(stub: true)&.info do |entry|
+                    entry.set_system_name
+                    entry.set_service
+                    entry.message = "Created client for #{entry.service}"
+                    entry.set_credentials_fields credentials
+                    entry.set "customEndpoint", @config.endpoint if @config.endpoint
+                    entry.set "defaultTimeout", @config.timeout if @config.timeout
+                    entry.set "quotaProject", @quota_project_id if @quota_project_id
+                  end
+
                   @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
                     config.credentials = credentials
                     config.quota_project = @quota_project_id
                     config.endpoint = @transition_route_groups_stub.endpoint
                     config.universe_domain = @transition_route_groups_stub.universe_domain
                     config.bindings_override = @config.bindings_override
+                    config.logger = @transition_route_groups_stub.logger if config.respond_to? :logger=
                   end
                 end
 
@@ -177,6 +189,15 @@ module Google
                 #
                 attr_reader :location_client
 
+                ##
+                # The logger used for request/response debug logging.
+                #
+                # @return [Logger]
+                #
+                def logger
+                  @transition_route_groups_stub.logger
+                end
+
                 # Service calls
 
                 ##
@@ -199,9 +220,9 @@ module Google
                 #
                 #   @param parent [::String]
                 #     Required. The flow to list all transition route groups for.
-                #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
-                #     ID>/flows/<Flow ID>`
-                #     or `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>.
+                #     Format:
+                #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>`
+                #      or `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.
                 #   @param page_size [::Integer]
                 #     The maximum number of items to return in a single page. By default 100 and
                 #     at most 1000.
@@ -215,7 +236,6 @@ module Google
                 #     *
                 #     `TransitionRouteGroup.transition_routes.trigger_fulfillment.conditional_cases`
                 #
-                #
                 #     If not specified, the agent's default language is used.
                 #     [Many
                 #     languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
@@ -279,7 +299,7 @@ module Google
                   @transition_route_groups_stub.list_transition_route_groups request, options do |result, operation|
                     result = ::Gapic::Rest::PagedEnumerable.new @transition_route_groups_stub, :list_transition_route_groups, "transition_route_groups", request, result, options
                     yield result, operation if block_given?
-                    return result
+                    throw :response, result
                   end
                 rescue ::Gapic::Rest::Error => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -307,10 +327,10 @@ module Google
                 #   @param name [::String]
                 #     Required. The name of the
                 #     {::Google::Cloud::Dialogflow::CX::V3::TransitionRouteGroup TransitionRouteGroup}.
-                #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
-                #     ID>/flows/<Flow ID>/transitionRouteGroups/<Transition Route Group ID>`
-                #     or `projects/<Project ID>/locations/<Location ID>/agents/<Agent
-                #     ID>/transitionRouteGroups/<Transition Route Group ID>`.
+                #     Format:
+                #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/transitionRouteGroups/<TransitionRouteGroupID>`
+                #     or
+                #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/transitionRouteGroups/<TransitionRouteGroupID>`.
                 #   @param language_code [::String]
                 #     The language to retrieve the transition route group for. The following
                 #     fields are language dependent:
@@ -377,7 +397,6 @@ module Google
 
                   @transition_route_groups_stub.get_transition_route_group request, options do |result, operation|
                     yield result, operation if block_given?
-                    return result
                   end
                 rescue ::Gapic::Rest::Error => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -410,9 +429,9 @@ module Google
                 #   @param parent [::String]
                 #     Required. The flow to create an
                 #     {::Google::Cloud::Dialogflow::CX::V3::TransitionRouteGroup TransitionRouteGroup}
-                #     for. Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
-                #     ID>/flows/<Flow ID>`
-                #     or `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>`
+                #     for. Format:
+                #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>`
+                #     or `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>`
                 #     for agent-level groups.
                 #   @param transition_route_group [::Google::Cloud::Dialogflow::CX::V3::TransitionRouteGroup, ::Hash]
                 #     Required. The transition route group to create.
@@ -481,7 +500,6 @@ module Google
 
                   @transition_route_groups_stub.create_transition_route_group request, options do |result, operation|
                     yield result, operation if block_given?
-                    return result
                   end
                 rescue ::Gapic::Rest::Error => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -579,7 +597,6 @@ module Google
 
                   @transition_route_groups_stub.update_transition_route_group request, options do |result, operation|
                     yield result, operation if block_given?
-                    return result
                   end
                 rescue ::Gapic::Rest::Error => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -611,10 +628,10 @@ module Google
                 #   @param name [::String]
                 #     Required. The name of the
                 #     {::Google::Cloud::Dialogflow::CX::V3::TransitionRouteGroup TransitionRouteGroup}
-                #     to delete. Format: `projects/<Project ID>/locations/<Location
-                #     ID>/agents/<Agent ID>/flows/<Flow ID>/transitionRouteGroups/<Transition
-                #     Route Group ID>` or `projects/<Project ID>/locations/<Location
-                #     ID>/agents/<Agent ID>/transitionRouteGroups/<Transition Route Group ID>`.
+                #     to delete. Format:
+                #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/transitionRouteGroups/<TransitionRouteGroupID>`
+                #     or
+                #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/transitionRouteGroups/<TransitionRouteGroupID>`.
                 #   @param force [::Boolean]
                 #     This field has no effect for transition route group that no page is using.
                 #     If the transition route group is referenced by any page:
@@ -676,7 +693,6 @@ module Google
 
                   @transition_route_groups_stub.delete_transition_route_group request, options do |result, operation|
                     yield result, operation if block_given?
-                    return result
                   end
                 rescue ::Gapic::Rest::Error => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -756,6 +772,11 @@ module Google
                 #   default endpoint URL. The default value of nil uses the environment
                 #   universe (usually the default "googleapis.com" universe).
                 #   @return [::String,nil]
+                # @!attribute [rw] logger
+                #   A custom logger to use for request/response debug logging, or the value
+                #   `:default` (the default) to construct a default logger, or `nil` to
+                #   explicitly disable logging.
+                #   @return [::Logger,:default,nil]
                 #
                 class Configuration
                   extend ::Gapic::Config
@@ -784,6 +805,7 @@ module Google
                   # by the host service.
                   # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
                   config_attr :bindings_override, {}, ::Hash, nil
+                  config_attr :logger, :default, ::Logger, nil, :default
 
                   # @private
                   def initialize parent_config = nil

data/lib/google/cloud/dialogflow/cx/v3/transition_route_groups/rest/service_stub.rb

@@ -31,7 +31,8 @@ module Google
               # including transcoding, making the REST call, and deserialing the response.
               #
               class ServiceStub
-                def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
+                # @private
+                def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
                   # These require statements are intentionally placed here to initialize
                   # the REST modules only when it's required.
                   require "gapic/rest"
@@ -41,7 +42,9 @@ module Google
                                                                universe_domain: universe_domain,
                                                                credentials: credentials,
                                                                numeric_enums: true,
-                                                               raise_faraday_errors: false
+                                                               service_name: self.class,
+                                                               raise_faraday_errors: false,
+                                                               logger: logger
                 end
 
                 ##
@@ -62,6 +65,15 @@ module Google
                   @client_stub.endpoint
                 end
 
+                ##
+                # The logger used for request/response debug logging.
+                #
+                # @return [Logger]
+                #
+                def logger stub: false
+                  stub ? @client_stub.stub_logger : @client_stub.logger
+                end
+
                 ##
                 # Baseline implementation for the list_transition_route_groups REST call
                 #
@@ -88,16 +100,18 @@ module Google
 
                   response = @client_stub.make_http_request(
                     verb,
-                    uri:     uri,
-                    body:    body || "",
-                    params:  query_string_params,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "list_transition_route_groups",
                     options: options
                   )
                   operation = ::Gapic::Rest::TransportOperation.new response
                   result = ::Google::Cloud::Dialogflow::CX::V3::ListTransitionRouteGroupsResponse.decode_json response.body, ignore_unknown_fields: true
-
-                  yield result, operation if block_given?
-                  result
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
                 end
 
                 ##
@@ -126,16 +140,18 @@ module Google
 
                   response = @client_stub.make_http_request(
                     verb,
-                    uri:     uri,
-                    body:    body || "",
-                    params:  query_string_params,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "get_transition_route_group",
                     options: options
                   )
                   operation = ::Gapic::Rest::TransportOperation.new response
                   result = ::Google::Cloud::Dialogflow::CX::V3::TransitionRouteGroup.decode_json response.body, ignore_unknown_fields: true
-
-                  yield result, operation if block_given?
-                  result
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
                 end
 
                 ##
@@ -164,16 +180,18 @@ module Google
 
                   response = @client_stub.make_http_request(
                     verb,
-                    uri:     uri,
-                    body:    body || "",
-                    params:  query_string_params,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "create_transition_route_group",
                     options: options
                   )
                   operation = ::Gapic::Rest::TransportOperation.new response
                   result = ::Google::Cloud::Dialogflow::CX::V3::TransitionRouteGroup.decode_json response.body, ignore_unknown_fields: true
-
-                  yield result, operation if block_given?
-                  result
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
                 end
 
                 ##
@@ -202,16 +220,18 @@ module Google
 
                   response = @client_stub.make_http_request(
                     verb,
-                    uri:     uri,
-                    body:    body || "",
-                    params:  query_string_params,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "update_transition_route_group",
                     options: options
                   )
                   operation = ::Gapic::Rest::TransportOperation.new response
                   result = ::Google::Cloud::Dialogflow::CX::V3::TransitionRouteGroup.decode_json response.body, ignore_unknown_fields: true
-
-                  yield result, operation if block_given?
-                  result
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
                 end
 
                 ##
@@ -240,16 +260,18 @@ module Google
 
                   response = @client_stub.make_http_request(
                     verb,
-                    uri:     uri,
-                    body:    body || "",
-                    params:  query_string_params,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "delete_transition_route_group",
                     options: options
                   )
                   operation = ::Gapic::Rest::TransportOperation.new response
                   result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
-
-                  yield result, operation if block_given?
-                  result
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
                 end
 
                 ##

data/lib/google/cloud/dialogflow/cx/v3/validation_message_pb.rb

@@ -5,7 +5,7 @@
 require 'google/protobuf'
 
 
-descriptor_data = "\n6google/cloud/dialogflow/cx/v3/validation_message.proto\x12\x1dgoogle.cloud.dialogflow.cx.v3\"\x9a\x05\n\x11ValidationMessage\x12T\n\rresource_type\x18\x01 \x01(\x0e\x32=.google.cloud.dialogflow.cx.v3.ValidationMessage.ResourceType\x12\x15\n\tresources\x18\x02 \x03(\tB\x02\x18\x01\x12\x43\n\x0eresource_names\x18\x06 \x03(\x0b\x32+.google.cloud.dialogflow.cx.v3.ResourceName\x12K\n\x08severity\x18\x03 \x01(\x0e\x32\x39.google.cloud.dialogflow.cx.v3.ValidationMessage.Severity\x12\x0e\n\x06\x64\x65tail\x18\x04 \x01(\t\"\xad\x02\n\x0cResourceType\x12\x1d\n\x19RESOURCE_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05\x41GENT\x10\x01\x12\n\n\x06INTENT\x10\x02\x12\x1a\n\x16INTENT_TRAINING_PHRASE\x10\x08\x12\x14\n\x10INTENT_PARAMETER\x10\t\x12\x0b\n\x07INTENTS\x10\n\x12\x1b\n\x17INTENT_TRAINING_PHRASES\x10\x0b\x12\x0f\n\x0b\x45NTITY_TYPE\x10\x03\x12\x10\n\x0c\x45NTITY_TYPES\x10\x0c\x12\x0b\n\x07WEBHOOK\x10\x04\x12\x08\n\x04\x46LOW\x10\x05\x12\x08\n\x04PAGE\x10\x06\x12\t\n\x05PAGES\x10\r\x12\x1a\n\x16TRANSITION_ROUTE_GROUP\x10\x07\x12 \n\x1c\x41GENT_TRANSITION_ROUTE_GROUP\x10\x0e\"F\n\x08Severity\x12\x18\n\x14SEVERITY_UNSPECIFIED\x10\x00\x12\x08\n\x04INFO\x10\x01\x12\x0b\n\x07WARNING\x10\x02\x12\t\n\x05\x45RROR\x10\x03\"2\n\x0cResourceName\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\tB\xbc\x01\n!com.google.cloud.dialogflow.cx.v3B\x16ValidationMessageProtoP\x01Z1cloud.google.com/go/dialogflow/cx/apiv3/cxpb;cxpb\xf8\x01\x01\xa2\x02\x02\x44\x46\xaa\x02\x1dGoogle.Cloud.Dialogflow.Cx.V3\xea\x02!Google::Cloud::Dialogflow::CX::V3b\x06proto3"
+descriptor_data = "\n6google/cloud/dialogflow/cx/v3/validation_message.proto\x12\x1dgoogle.cloud.dialogflow.cx.v3\"\x9a\x05\n\x11ValidationMessage\x12T\n\rresource_type\x18\x01 \x01(\x0e\x32=.google.cloud.dialogflow.cx.v3.ValidationMessage.ResourceType\x12\x15\n\tresources\x18\x02 \x03(\tB\x02\x18\x01\x12\x43\n\x0eresource_names\x18\x06 \x03(\x0b\x32+.google.cloud.dialogflow.cx.v3.ResourceName\x12K\n\x08severity\x18\x03 \x01(\x0e\x32\x39.google.cloud.dialogflow.cx.v3.ValidationMessage.Severity\x12\x0e\n\x06\x64\x65tail\x18\x04 \x01(\t\"\xad\x02\n\x0cResourceType\x12\x1d\n\x19RESOURCE_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05\x41GENT\x10\x01\x12\n\n\x06INTENT\x10\x02\x12\x1a\n\x16INTENT_TRAINING_PHRASE\x10\x08\x12\x14\n\x10INTENT_PARAMETER\x10\t\x12\x0b\n\x07INTENTS\x10\n\x12\x1b\n\x17INTENT_TRAINING_PHRASES\x10\x0b\x12\x0f\n\x0b\x45NTITY_TYPE\x10\x03\x12\x10\n\x0c\x45NTITY_TYPES\x10\x0c\x12\x0b\n\x07WEBHOOK\x10\x04\x12\x08\n\x04\x46LOW\x10\x05\x12\x08\n\x04PAGE\x10\x06\x12\t\n\x05PAGES\x10\r\x12\x1a\n\x16TRANSITION_ROUTE_GROUP\x10\x07\x12 \n\x1c\x41GENT_TRANSITION_ROUTE_GROUP\x10\x0e\"F\n\x08Severity\x12\x18\n\x14SEVERITY_UNSPECIFIED\x10\x00\x12\x08\n\x04INFO\x10\x01\x12\x0b\n\x07WARNING\x10\x02\x12\t\n\x05\x45RROR\x10\x03\"2\n\x0cResourceName\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\tB\xb9\x01\n!com.google.cloud.dialogflow.cx.v3B\x16ValidationMessageProtoP\x01Z1cloud.google.com/go/dialogflow/cx/apiv3/cxpb;cxpb\xa2\x02\x02\x44\x46\xaa\x02\x1dGoogle.Cloud.Dialogflow.Cx.V3\xea\x02!Google::Cloud::Dialogflow::CX::V3b\x06proto3"
 
 pool = Google::Protobuf::DescriptorPool.generated_pool
 

data/lib/google/cloud/dialogflow/cx/v3/version.rb

@@ -22,7 +22,7 @@ module Google
     module Dialogflow
       module CX
         module V3
-          VERSION = "1.1.1"
+          VERSION = "1.3.0"
         end
       end
     end

data/lib/google/cloud/dialogflow/cx/v3/version_pb.rb

@@ -16,7 +16,7 @@ require 'google/protobuf/struct_pb'
 require 'google/protobuf/timestamp_pb'
 
 
-descriptor_data = "\n+google/cloud/dialogflow/cx/v3/version.proto\x12\x1dgoogle.cloud.dialogflow.cx.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a(google/cloud/dialogflow/cx/v3/flow.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"Y\n\x1e\x43reateVersionOperationMetadata\x12\x37\n\x07version\x18\x01 \x01(\tB&\xfa\x41#\n!dialogflow.googleapis.com/Version\"\xce\x03\n\x07Version\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x19\n\x0c\x64isplay_name\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x45\n\x0cnlu_settings\x18\x04 \x01(\x0b\x32*.google.cloud.dialogflow.cx.v3.NluSettingsB\x03\xe0\x41\x03\x12\x34\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12@\n\x05state\x18\x06 \x01(\x0e\x32,.google.cloud.dialogflow.cx.v3.Version.StateB\x03\xe0\x41\x03\"F\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\r\n\tSUCCEEDED\x10\x02\x12\n\n\x06\x46\x41ILED\x10\x03:~\xea\x41{\n!dialogflow.googleapis.com/Version\x12Vprojects/{project}/locations/{location}/agents/{agent}/flows/{flow}/versions/{version}\"w\n\x13ListVersionsRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!dialogflow.googleapis.com/Version\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\"i\n\x14ListVersionsResponse\x12\x38\n\x08versions\x18\x01 \x03(\x0b\x32&.google.cloud.dialogflow.cx.v3.Version\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"L\n\x11GetVersionRequest\x12\x37\n\x04name\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!dialogflow.googleapis.com/Version\"\x8f\x01\n\x14\x43reateVersionRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!dialogflow.googleapis.com/Version\x12<\n\x07version\x18\x02 \x01(\x0b\x32&.google.cloud.dialogflow.cx.v3.VersionB\x03\xe0\x41\x02\"\x8a\x01\n\x14UpdateVersionRequest\x12<\n\x07version\x18\x01 \x01(\x0b\x32&.google.cloud.dialogflow.cx.v3.VersionB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x02\"O\n\x14\x44\x65leteVersionRequest\x12\x37\n\x04name\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!dialogflow.googleapis.com/Version\"u\n\x12LoadVersionRequest\x12\x37\n\x04name\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!dialogflow.googleapis.com/Version\x12&\n\x1e\x61llow_override_agent_resources\x18\x02 \x01(\x08\"\xb3\x01\n\x16\x43ompareVersionsRequest\x12?\n\x0c\x62\x61se_version\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!dialogflow.googleapis.com/Version\x12\x41\n\x0etarget_version\x18\x02 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!dialogflow.googleapis.com/Version\x12\x15\n\rlanguage_code\x18\x03 \x01(\t\"\x93\x01\n\x17\x43ompareVersionsResponse\x12!\n\x19\x62\x61se_version_content_json\x18\x01 \x01(\t\x12#\n\x1btarget_version_content_json\x18\x02 \x01(\t\x12\x30\n\x0c\x63ompare_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp2\xe2\x0c\n\x08Versions\x12\xc7\x01\n\x0cListVersions\x12\x32.google.cloud.dialogflow.cx.v3.ListVersionsRequest\x1a\x33.google.cloud.dialogflow.cx.v3.ListVersionsResponse\"N\xda\x41\x06parent\x82\xd3\xe4\x93\x02?\x12=/v3/{parent=projects/*/locations/*/agents/*/flows/*}/versions\x12\xb4\x01\n\nGetVersion\x12\x30.google.cloud.dialogflow.cx.v3.GetVersionRequest\x1a&.google.cloud.dialogflow.cx.v3.Version\"L\xda\x41\x04name\x82\xd3\xe4\x93\x02?\x12=/v3/{name=projects/*/locations/*/agents/*/flows/*/versions/*}\x12\xf1\x01\n\rCreateVersion\x12\x33.google.cloud.dialogflow.cx.v3.CreateVersionRequest\x1a\x1d.google.longrunning.Operation\"\x8b\x01\xca\x41)\n\x07Version\x12\x1e\x43reateVersionOperationMetadata\xda\x41\x0eparent,version\x82\xd3\xe4\x93\x02H\"=/v3/{parent=projects/*/locations/*/agents/*/flows/*}/versions:\x07version\x12\xda\x01\n\rUpdateVersion\x12\x33.google.cloud.dialogflow.cx.v3.UpdateVersionRequest\x1a&.google.cloud.dialogflow.cx.v3.Version\"l\xda\x41\x13version,update_mask\x82\xd3\xe4\x93\x02P2E/v3/{version.name=projects/*/locations/*/agents/*/flows/*/versions/*}:\x07version\x12\xaa\x01\n\rDeleteVersion\x12\x33.google.cloud.dialogflow.cx.v3.DeleteVersionRequest\x1a\x16.google.protobuf.Empty\"L\xda\x41\x04name\x82\xd3\xe4\x93\x02?*=/v3/{name=projects/*/locations/*/agents/*/flows/*/versions/*}\x12\xe8\x01\n\x0bLoadVersion\x12\x31.google.cloud.dialogflow.cx.v3.LoadVersionRequest\x1a\x1d.google.longrunning.Operation\"\x86\x01\xca\x41/\n\x15google.protobuf.Empty\x12\x16google.protobuf.Struct\xda\x41\x04name\x82\xd3\xe4\x93\x02G\"B/v3/{name=projects/*/locations/*/agents/*/flows/*/versions/*}:load:\x01*\x12\xf1\x01\n\x0f\x43ompareVersions\x12\x35.google.cloud.dialogflow.cx.v3.CompareVersionsRequest\x1a\x36.google.cloud.dialogflow.cx.v3.CompareVersionsResponse\"o\xda\x41\x0c\x62\x61se_version\x82\xd3\xe4\x93\x02Z\"U/v3/{base_version=projects/*/locations/*/agents/*/flows/*/versions/*}:compareVersions:\x01*\x1ax\xca\x41\x19\x64ialogflow.googleapis.com\xd2\x41Yhttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/dialogflowB\xb2\x01\n!com.google.cloud.dialogflow.cx.v3B\x0cVersionProtoP\x01Z1cloud.google.com/go/dialogflow/cx/apiv3/cxpb;cxpb\xf8\x01\x01\xa2\x02\x02\x44\x46\xaa\x02\x1dGoogle.Cloud.Dialogflow.Cx.V3\xea\x02!Google::Cloud::Dialogflow::CX::V3b\x06proto3"
+descriptor_data = "\n+google/cloud/dialogflow/cx/v3/version.proto\x12\x1dgoogle.cloud.dialogflow.cx.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a(google/cloud/dialogflow/cx/v3/flow.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"Y\n\x1e\x43reateVersionOperationMetadata\x12\x37\n\x07version\x18\x01 \x01(\tB&\xfa\x41#\n!dialogflow.googleapis.com/Version\"\xce\x03\n\x07Version\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x19\n\x0c\x64isplay_name\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x45\n\x0cnlu_settings\x18\x04 \x01(\x0b\x32*.google.cloud.dialogflow.cx.v3.NluSettingsB\x03\xe0\x41\x03\x12\x34\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12@\n\x05state\x18\x06 \x01(\x0e\x32,.google.cloud.dialogflow.cx.v3.Version.StateB\x03\xe0\x41\x03\"F\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\r\n\tSUCCEEDED\x10\x02\x12\n\n\x06\x46\x41ILED\x10\x03:~\xea\x41{\n!dialogflow.googleapis.com/Version\x12Vprojects/{project}/locations/{location}/agents/{agent}/flows/{flow}/versions/{version}\"w\n\x13ListVersionsRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!dialogflow.googleapis.com/Version\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\"i\n\x14ListVersionsResponse\x12\x38\n\x08versions\x18\x01 \x03(\x0b\x32&.google.cloud.dialogflow.cx.v3.Version\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"L\n\x11GetVersionRequest\x12\x37\n\x04name\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!dialogflow.googleapis.com/Version\"\x8f\x01\n\x14\x43reateVersionRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!dialogflow.googleapis.com/Version\x12<\n\x07version\x18\x02 \x01(\x0b\x32&.google.cloud.dialogflow.cx.v3.VersionB\x03\xe0\x41\x02\"\x8a\x01\n\x14UpdateVersionRequest\x12<\n\x07version\x18\x01 \x01(\x0b\x32&.google.cloud.dialogflow.cx.v3.VersionB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x02\"O\n\x14\x44\x65leteVersionRequest\x12\x37\n\x04name\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!dialogflow.googleapis.com/Version\"u\n\x12LoadVersionRequest\x12\x37\n\x04name\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!dialogflow.googleapis.com/Version\x12&\n\x1e\x61llow_override_agent_resources\x18\x02 \x01(\x08\"\xb3\x01\n\x16\x43ompareVersionsRequest\x12?\n\x0c\x62\x61se_version\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!dialogflow.googleapis.com/Version\x12\x41\n\x0etarget_version\x18\x02 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!dialogflow.googleapis.com/Version\x12\x15\n\rlanguage_code\x18\x03 \x01(\t\"\x93\x01\n\x17\x43ompareVersionsResponse\x12!\n\x19\x62\x61se_version_content_json\x18\x01 \x01(\t\x12#\n\x1btarget_version_content_json\x18\x02 \x01(\t\x12\x30\n\x0c\x63ompare_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp2\xe2\x0c\n\x08Versions\x12\xc7\x01\n\x0cListVersions\x12\x32.google.cloud.dialogflow.cx.v3.ListVersionsRequest\x1a\x33.google.cloud.dialogflow.cx.v3.ListVersionsResponse\"N\xda\x41\x06parent\x82\xd3\xe4\x93\x02?\x12=/v3/{parent=projects/*/locations/*/agents/*/flows/*}/versions\x12\xb4\x01\n\nGetVersion\x12\x30.google.cloud.dialogflow.cx.v3.GetVersionRequest\x1a&.google.cloud.dialogflow.cx.v3.Version\"L\xda\x41\x04name\x82\xd3\xe4\x93\x02?\x12=/v3/{name=projects/*/locations/*/agents/*/flows/*/versions/*}\x12\xf1\x01\n\rCreateVersion\x12\x33.google.cloud.dialogflow.cx.v3.CreateVersionRequest\x1a\x1d.google.longrunning.Operation\"\x8b\x01\xca\x41)\n\x07Version\x12\x1e\x43reateVersionOperationMetadata\xda\x41\x0eparent,version\x82\xd3\xe4\x93\x02H\"=/v3/{parent=projects/*/locations/*/agents/*/flows/*}/versions:\x07version\x12\xda\x01\n\rUpdateVersion\x12\x33.google.cloud.dialogflow.cx.v3.UpdateVersionRequest\x1a&.google.cloud.dialogflow.cx.v3.Version\"l\xda\x41\x13version,update_mask\x82\xd3\xe4\x93\x02P2E/v3/{version.name=projects/*/locations/*/agents/*/flows/*/versions/*}:\x07version\x12\xaa\x01\n\rDeleteVersion\x12\x33.google.cloud.dialogflow.cx.v3.DeleteVersionRequest\x1a\x16.google.protobuf.Empty\"L\xda\x41\x04name\x82\xd3\xe4\x93\x02?*=/v3/{name=projects/*/locations/*/agents/*/flows/*/versions/*}\x12\xe8\x01\n\x0bLoadVersion\x12\x31.google.cloud.dialogflow.cx.v3.LoadVersionRequest\x1a\x1d.google.longrunning.Operation\"\x86\x01\xca\x41/\n\x15google.protobuf.Empty\x12\x16google.protobuf.Struct\xda\x41\x04name\x82\xd3\xe4\x93\x02G\"B/v3/{name=projects/*/locations/*/agents/*/flows/*/versions/*}:load:\x01*\x12\xf1\x01\n\x0f\x43ompareVersions\x12\x35.google.cloud.dialogflow.cx.v3.CompareVersionsRequest\x1a\x36.google.cloud.dialogflow.cx.v3.CompareVersionsResponse\"o\xda\x41\x0c\x62\x61se_version\x82\xd3\xe4\x93\x02Z\"U/v3/{base_version=projects/*/locations/*/agents/*/flows/*/versions/*}:compareVersions:\x01*\x1ax\xca\x41\x19\x64ialogflow.googleapis.com\xd2\x41Yhttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/dialogflowB\xaf\x01\n!com.google.cloud.dialogflow.cx.v3B\x0cVersionProtoP\x01Z1cloud.google.com/go/dialogflow/cx/apiv3/cxpb;cxpb\xa2\x02\x02\x44\x46\xaa\x02\x1dGoogle.Cloud.Dialogflow.Cx.V3\xea\x02!Google::Cloud::Dialogflow::CX::V3b\x06proto3"
 
 pool = Google::Protobuf::DescriptorPool.generated_pool
 

data/lib/google/cloud/dialogflow/cx/v3/versions/client.rb

@@ -171,14 +171,26 @@ module Google
                   universe_domain: @config.universe_domain,
                   channel_args: @config.channel_args,
                   interceptors: @config.interceptors,
-                  channel_pool_config: @config.channel_pool
+                  channel_pool_config: @config.channel_pool,
+                  logger: @config.logger
                 )
 
+                @versions_stub.stub_logger&.info do |entry|
+                  entry.set_system_name
+                  entry.set_service
+                  entry.message = "Created client for #{entry.service}"
+                  entry.set_credentials_fields credentials
+                  entry.set "customEndpoint", @config.endpoint if @config.endpoint
+                  entry.set "defaultTimeout", @config.timeout if @config.timeout
+                  entry.set "quotaProject", @quota_project_id if @quota_project_id
+                end
+
                 @location_client = Google::Cloud::Location::Locations::Client.new do |config|
                   config.credentials = credentials
                   config.quota_project = @quota_project_id
                   config.endpoint = @versions_stub.endpoint
                   config.universe_domain = @versions_stub.universe_domain
+                  config.logger = @versions_stub.logger if config.respond_to? :logger=
                 end
               end
 
@@ -196,6 +208,15 @@ module Google
               #
               attr_reader :location_client
 
+              ##
+              # The logger used for request/response debug logging.
+              #
+              # @return [Logger]
+              #
+              def logger
+                @versions_stub.logger
+              end
+
               # Service calls
 
               ##
@@ -219,8 +240,8 @@ module Google
               #
               #   @param parent [::String]
               #     Required. The {::Google::Cloud::Dialogflow::CX::V3::Flow Flow} to list all
-              #     versions for. Format: `projects/<Project ID>/locations/<Location
-              #     ID>/agents/<Agent ID>/flows/<Flow ID>`.
+              #     versions for. Format:
+              #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>`.
               #   @param page_size [::Integer]
               #     The maximum number of items to return in a single page. By default 20 and
               #     at most 100.
@@ -291,7 +312,7 @@ module Google
                 @versions_stub.call_rpc :list_versions, request, options: options do |response, operation|
                   response = ::Gapic::PagedEnumerable.new @versions_stub, :list_versions, request, response, operation, options
                   yield response, operation if block_given?
-                  return response
+                  throw :response, response
                 end
               rescue ::GRPC::BadStatus => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -317,8 +338,8 @@ module Google
               #
               #   @param name [::String]
               #     Required. The name of the {::Google::Cloud::Dialogflow::CX::V3::Version Version}.
-              #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
-              #     ID>/flows/<Flow ID>/versions/<Version ID>`.
+              #     Format:
+              #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>`.
               #
               # @yield [response, operation] Access the result along with the RPC operation
               # @yieldparam response [::Google::Cloud::Dialogflow::CX::V3::Version]
@@ -379,7 +400,6 @@ module Google
 
                 @versions_stub.call_rpc :get_version, request, options: options do |response, operation|
                   yield response, operation if block_given?
-                  return response
                 end
               rescue ::GRPC::BadStatus => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -415,8 +435,7 @@ module Google
               #   @param parent [::String]
               #     Required. The {::Google::Cloud::Dialogflow::CX::V3::Flow Flow} to create an
               #     {::Google::Cloud::Dialogflow::CX::V3::Version Version} for. Format:
-              #     `projects/<Project ID>/locations/<Location ID>/agents/<Agent
-              #     ID>/flows/<Flow ID>`.
+              #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>`.
               #   @param version [::Google::Cloud::Dialogflow::CX::V3::Version, ::Hash]
               #     Required. The version to create.
               #
@@ -487,7 +506,7 @@ module Google
                 @versions_stub.call_rpc :create_version, request, options: options do |response, operation|
                   response = ::Gapic::Operation.new response, @operations_client, options: options
                   yield response, operation if block_given?
-                  return response
+                  throw :response, response
                 end
               rescue ::GRPC::BadStatus => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -576,7 +595,6 @@ module Google
 
                 @versions_stub.call_rpc :update_version, request, options: options do |response, operation|
                   yield response, operation if block_given?
-                  return response
                 end
               rescue ::GRPC::BadStatus => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -602,8 +620,8 @@ module Google
               #
               #   @param name [::String]
               #     Required. The name of the {::Google::Cloud::Dialogflow::CX::V3::Version Version}
-              #     to delete. Format: `projects/<Project ID>/locations/<Location
-              #     ID>/agents/<Agent ID>/flows/<Flow ID>/versions/<Version ID>`.
+              #     to delete. Format:
+              #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>`.
               #
               # @yield [response, operation] Access the result along with the RPC operation
               # @yieldparam response [::Google::Protobuf::Empty]
@@ -664,7 +682,6 @@ module Google
 
                 @versions_stub.call_rpc :delete_version, request, options: options do |response, operation|
                   yield response, operation if block_given?
-                  return response
                 end
               rescue ::GRPC::BadStatus => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -699,8 +716,8 @@ module Google
               #
               #   @param name [::String]
               #     Required. The {::Google::Cloud::Dialogflow::CX::V3::Version Version} to be loaded
-              #     to draft flow. Format: `projects/<Project ID>/locations/<Location
-              #     ID>/agents/<Agent ID>/flows/<Flow ID>/versions/<Version ID>`.
+              #     to draft flow. Format:
+              #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>`.
               #   @param allow_override_agent_resources [::Boolean]
               #     This field is used to prevent accidental overwrite of other agent
               #     resources, which can potentially impact other flow's behavior. If
@@ -774,7 +791,7 @@ module Google
                 @versions_stub.call_rpc :load_version, request, options: options do |response, operation|
                   response = ::Gapic::Operation.new response, @operations_client, options: options
                   yield response, operation if block_given?
-                  return response
+                  throw :response, response
                 end
               rescue ::GRPC::BadStatus => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -802,13 +819,13 @@ module Google
               #     Required. Name of the base flow version to compare with the target version.
               #     Use version ID `0` to indicate the draft version of the specified flow.
               #
-              #     Format: `projects/<Project ID>/locations/<Location ID>/agents/
-              #     <Agent ID>/flows/<Flow ID>/versions/<Version ID>`.
+              #     Format:
+              #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>`.
               #   @param target_version [::String]
               #     Required. Name of the target flow version to compare with the
               #     base version. Use version ID `0` to indicate the draft version of the
-              #     specified flow. Format: `projects/<Project ID>/locations/<Location
-              #     ID>/agents/<Agent ID>/flows/<Flow ID>/versions/<Version ID>`.
+              #     specified flow. Format:
+              #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>`.
               #   @param language_code [::String]
               #     The language to compare the flow versions for.
               #
@@ -877,7 +894,6 @@ module Google
 
                 @versions_stub.call_rpc :compare_versions, request, options: options do |response, operation|
                   yield response, operation if block_given?
-                  return response
                 end
               rescue ::GRPC::BadStatus => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -966,6 +982,11 @@ module Google
               #   default endpoint URL. The default value of nil uses the environment
               #   universe (usually the default "googleapis.com" universe).
               #   @return [::String,nil]
+              # @!attribute [rw] logger
+              #   A custom logger to use for request/response debug logging, or the value
+              #   `:default` (the default) to construct a default logger, or `nil` to
+              #   explicitly disable logging.
+              #   @return [::Logger,:default,nil]
               #
               class Configuration
                 extend ::Gapic::Config
@@ -990,6 +1011,7 @@ module Google
                 config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
                 config_attr :quota_project, nil, ::String, nil
                 config_attr :universe_domain, nil, ::String, nil
+                config_attr :logger, :default, ::Logger, nil, :default
 
                 # @private
                 def initialize parent_config = nil