google-cloud-dialogflow-cx-v3 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 647a465151383c26f0ae739d549df516a5c440724d8d85d06a70dc39c59e5b1a
-  data.tar.gz: bdd0a39f3c07d4989b5a65fabc54e29ff5cf4a0591a15ff2bd883c82257139aa
+  metadata.gz: fae7b6df61618ef1bedad366afbe94b2514144c935f8e451e8ccf824a8beac7c
+  data.tar.gz: ef40b9845fd7c8d9d76a7bd616ce5e0739d2e18575d2cad586990aac486eeb82
 SHA512:
-  metadata.gz: 76fd6117cdd2bfb8b4d9a9c776667f34c9fe219e59fa0f625ba6735287338d997f1409ce86017b08e0cbaf17cf2be3b3c931b8cd97bd222c0c1c1b975bb903f9
-  data.tar.gz: 6c88d1b99a86141f1cde52e35b33c1d9fb6a3c56349d8cb2452feaf129ca07af748c9a51bee3fd552397c68b385fb683c649952fdf382450c50bf06826e16d9c
+  metadata.gz: c7270ca47ecb593e5711fed092a94f823076bd7c558f2afa6d74b3e1c73f632b13ac7af09fffce83301fd6d5d92a275af2e90b3a9098852395d969bd3a310036
+  data.tar.gz: 04253c5e798cda18abd9671ae04bae1b1b41e8545623923c79eb38ca712f7cbb8ba0c31b1ebdc278d76f504c116cb367900ae6e6a5ff739831523add351f7133

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

@@ -6,6 +6,7 @@ require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/cloud/dialogflow/cx/v3/test_case_pb'
+require 'google/cloud/dialogflow/cx/v3/webhook_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'

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

@@ -18,6 +18,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
         optional :end_interaction, :message, 11, "google.cloud.dialogflow.cx.v3.ResponseMessage.EndInteraction"
         optional :play_audio, :message, 12, "google.cloud.dialogflow.cx.v3.ResponseMessage.PlayAudio"
         optional :mixed_audio, :message, 13, "google.cloud.dialogflow.cx.v3.ResponseMessage.MixedAudio"
+        optional :telephony_transfer_call, :message, 18, "google.cloud.dialogflow.cx.v3.ResponseMessage.TelephonyTransferCall"
       end
     end
     add_message "google.cloud.dialogflow.cx.v3.ResponseMessage.Text" do
@@ -53,6 +54,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
         optional :uri, :string, 2
       end
     end
+    add_message "google.cloud.dialogflow.cx.v3.ResponseMessage.TelephonyTransferCall" do
+      oneof :endpoint do
+        optional :phone_number, :string, 1
+      end
+    end
   end
 end
 
@@ -70,6 +76,7 @@ module Google
           ResponseMessage::PlayAudio = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.cx.v3.ResponseMessage.PlayAudio").msgclass
           ResponseMessage::MixedAudio = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.cx.v3.ResponseMessage.MixedAudio").msgclass
           ResponseMessage::MixedAudio::Segment = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.cx.v3.ResponseMessage.MixedAudio.Segment").msgclass
+          ResponseMessage::TelephonyTransferCall = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.cx.v3.ResponseMessage.TelephonyTransferCall").msgclass
         end
       end
     end

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

@@ -22,7 +22,7 @@ module Google
     module Dialogflow
       module CX
         module V3
-          VERSION = "0.3.1"
+          VERSION = "0.4.0"
         end
       end
     end

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

@@ -63,6 +63,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :name, :string, 1
       optional :allow_override_agent_resources, :bool, 2
     end
+    add_message "google.cloud.dialogflow.cx.v3.CompareVersionsRequest" do
+      optional :base_version, :string, 1
+      optional :target_version, :string, 2
+      optional :language_code, :string, 3
+    end
+    add_message "google.cloud.dialogflow.cx.v3.CompareVersionsResponse" do
+      optional :base_version_content_json, :string, 1
+      optional :target_version_content_json, :string, 2
+      optional :compare_time, :message, 3, "google.protobuf.Timestamp"
+    end
   end
 end
 
@@ -81,6 +91,8 @@ module Google
           UpdateVersionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.cx.v3.UpdateVersionRequest").msgclass
           DeleteVersionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.cx.v3.DeleteVersionRequest").msgclass
           LoadVersionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.cx.v3.LoadVersionRequest").msgclass
+          CompareVersionsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.cx.v3.CompareVersionsRequest").msgclass
+          CompareVersionsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.cx.v3.CompareVersionsResponse").msgclass
         end
       end
     end

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

@@ -62,6 +62,8 @@ module Google
               # - `response`: An [Empty
               #   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
               rpc :LoadVersion, ::Google::Cloud::Dialogflow::CX::V3::LoadVersionRequest, ::Google::Longrunning::Operation
+              # Compares the specified base version with target version.
+              rpc :CompareVersions, ::Google::Cloud::Dialogflow::CX::V3::CompareVersionsRequest, ::Google::Cloud::Dialogflow::CX::V3::CompareVersionsResponse
             end
 
             Stub = Service.rpc_stub_class

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

@@ -736,6 +736,108 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Compares the specified base version with target version.
+              #
+              # @overload compare_versions(request, options = nil)
+              #   Pass arguments to `compare_versions` via a request object, either of type
+              #   {::Google::Cloud::Dialogflow::CX::V3::CompareVersionsRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::Dialogflow::CX::V3::CompareVersionsRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+              #
+              # @overload compare_versions(base_version: nil, target_version: nil, language_code: nil)
+              #   Pass arguments to `compare_versions` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param base_version [::String]
+              #     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>`.
+              #   @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>`.
+              #   @param language_code [::String]
+              #     The language to compare the flow versions for.
+              #
+              #     If not specified, the agent's default language is used.
+              #     [Many
+              #     languages](https://cloud.google.com/dialogflow/docs/reference/language) are
+              #     supported. Note: languages must be enabled in the agent before they can be
+              #     used.
+              #
+              # @yield [response, operation] Access the result along with the RPC operation
+              # @yieldparam response [::Google::Cloud::Dialogflow::CX::V3::CompareVersionsResponse]
+              # @yieldparam operation [::GRPC::ActiveCall::Operation]
+              #
+              # @return [::Google::Cloud::Dialogflow::CX::V3::CompareVersionsResponse]
+              #
+              # @raise [::Google::Cloud::Error] if the RPC is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/dialogflow/cx/v3"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Dialogflow::CX::V3::Versions::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Dialogflow::CX::V3::CompareVersionsRequest.new
+              #
+              #   # Call the compare_versions method.
+              #   result = client.compare_versions request
+              #
+              #   # The returned object is of type Google::Cloud::Dialogflow::CX::V3::CompareVersionsResponse.
+              #   p result
+              #
+              def compare_versions request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dialogflow::CX::V3::CompareVersionsRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                metadata = @config.rpcs.compare_versions.metadata.to_h
+
+                # Set x-goog-api-client and x-goog-user-project headers
+                metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Cloud::Dialogflow::CX::V3::VERSION
+                metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                header_params = {}
+                if request.base_version
+                  header_params["base_version"] = request.base_version
+                end
+
+                request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+                metadata[:"x-goog-request-params"] ||= request_params_header
+
+                options.apply_defaults timeout:      @config.rpcs.compare_versions.timeout,
+                                       metadata:     metadata,
+                                       retry_policy: @config.rpcs.compare_versions.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @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)
+              end
+
               ##
               # Configuration class for the Versions API.
               #
@@ -901,6 +1003,11 @@ module Google
                   # @return [::Gapic::Config::Method]
                   #
                   attr_reader :load_version
+                  ##
+                  # RPC-specific configuration for `compare_versions`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :compare_versions
 
                   # @private
                   def initialize parent_rpcs = nil
@@ -916,6 +1023,8 @@ module Google
                     @delete_version = ::Gapic::Config::Method.new delete_version_config
                     load_version_config = parent_rpcs.load_version if parent_rpcs.respond_to? :load_version
                     @load_version = ::Gapic::Config::Method.new load_version_config
+                    compare_versions_config = parent_rpcs.compare_versions if parent_rpcs.respond_to? :compare_versions
+                    @compare_versions = ::Gapic::Config::Method.new compare_versions_config
 
                     yield self if block_given?
                   end

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

@@ -29,6 +29,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :username, :string, 2
       optional :password, :string, 3
       map :request_headers, :string, :string, 4
+      repeated :allowed_ca_certs, :bytes, 5
     end
     add_message "google.cloud.dialogflow.cx.v3.Webhook.ServiceDirectoryConfig" do
       optional :service, :string, 1

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

@@ -28,9 +28,9 @@ require "google/cloud/dialogflow/cx/v3/session_entity_types"
 require "google/cloud/dialogflow/cx/v3/sessions"
 require "google/cloud/dialogflow/cx/v3/transition_route_groups"
 require "google/cloud/dialogflow/cx/v3/test_cases"
+require "google/cloud/dialogflow/cx/v3/webhooks"
 require "google/cloud/dialogflow/cx/v3/environments"
 require "google/cloud/dialogflow/cx/v3/experiments"
-require "google/cloud/dialogflow/cx/v3/webhooks"
 require "google/cloud/dialogflow/cx/v3/versions"
 require "google/cloud/dialogflow/cx/v3/version"
 

data/proto_docs/google/cloud/dialogflow/cx/v3/response_message.rb

@@ -76,6 +76,10 @@ module Google
           #     {::Google::Cloud::Dialogflow::CX::V3::ResponseMessage#play_audio play_audio}.
           #     This message is generated by Dialogflow only and not supposed to be
           #     defined by the user.
+          # @!attribute [rw] telephony_transfer_call
+          #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage::TelephonyTransferCall]
+          #     A signal that the client should transfer the phone call connected to
+          #     this agent to a third-party endpoint.
           class ResponseMessage
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,6 +216,17 @@ module Google
                 extend ::Google::Protobuf::MessageExts::ClassMethods
               end
             end
+
+            # Represents the signal that telles the client to transfer the phone call
+            # connected to the agent to a third-party endpoint.
+            # @!attribute [rw] phone_number
+            #   @return [::String]
+            #     Transfer the call to a phone number
+            #     in [E.164 format](https://en.wikipedia.org/wiki/E.164).
+            class TelephonyTransferCall
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
         end
       end

data/proto_docs/google/cloud/dialogflow/cx/v3/security_settings.rb

@@ -129,6 +129,11 @@ module Google
           #     [DLP](https://cloud.google.com/dlp/docs) inspect template name. Use this
           #     template to define inspect base settings.
           #
+          #     The `DLP Inspect Templates Reader` role is needed on the Dialogflow
+          #     service identity service account (has the form
+          #     `service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com`)
+          #     for your agent's project.
+          #
           #     If empty, we use the default DLP inspect config.
           #
           #     The template name will have one of the following formats:
@@ -143,6 +148,11 @@ module Google
           #     [DLP](https://cloud.google.com/dlp/docs) deidentify template name. Use this
           #     template to define de-identification configuration for the content.
           #
+          #     The `DLP De-identify Templates Reader` role is needed on the Dialogflow
+          #     service identity service account (has the form
+          #     `service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com`)
+          #     for your agent's project.
+          #
           #     If empty, Dialogflow replaces sensitive info with `[redacted]` text.
           #
           #     The template name will have one of the following formats:
@@ -157,7 +167,7 @@ module Google
           #     Retains data in interaction logging for the specified number of days.
           #     This does not apply to Cloud logging, which is owned by the user - not
           #     Dialogflow.
-          #     User must Set a value lower than Dialogflow's default 30d TTL. Setting a
+          #     User must set a value lower than Dialogflow's default 365d TTL. Setting a
           #     value higher than that has no effect.
           #     A missing value or setting to 0 also means we use Dialogflow's default
           #     TTL.

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

@@ -175,6 +175,49 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # The request message for {::Google::Cloud::Dialogflow::CX::V3::Versions::Client#compare_versions Versions.CompareVersions}.
+          # @!attribute [rw] base_version
+          #   @return [::String]
+          #     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>`.
+          # @!attribute [rw] target_version
+          #   @return [::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>`.
+          # @!attribute [rw] language_code
+          #   @return [::String]
+          #     The language to compare the flow versions for.
+          #
+          #     If not specified, the agent's default language is used.
+          #     [Many
+          #     languages](https://cloud.google.com/dialogflow/docs/reference/language) are
+          #     supported. Note: languages must be enabled in the agent before they can be
+          #     used.
+          class CompareVersionsRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The response message for {::Google::Cloud::Dialogflow::CX::V3::Versions::Client#compare_versions Versions.CompareVersions}.
+          # @!attribute [rw] base_version_content_json
+          #   @return [::String]
+          #     JSON representation of the base version content.
+          # @!attribute [rw] target_version_content_json
+          #   @return [::String]
+          #     JSON representation of the target version content.
+          # @!attribute [rw] compare_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The timestamp when the two version compares.
+          class CompareVersionsResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
       end
     end

data/proto_docs/google/cloud/dialogflow/cx/v3/webhook.rb

@@ -69,6 +69,19 @@ module Google
             #   @return [::Google::Protobuf::Map{::String => ::String}]
             #     The HTTP request headers to send together with webhook
             #     requests.
+            # @!attribute [rw] allowed_ca_certs
+            #   @return [::Array<::String>]
+            #     Optional. Specifies a list of allowed custom CA certificates (in DER format) for
+            #     HTTPS verification. This overrides the default SSL trust store. If this
+            #     is empty or unspecified, Dialogflow will use Google's default trust store
+            #     to verify certificates.
+            #     N.B. Make sure the HTTPS server certificates are signed with "subject alt
+            #     name". For instance a certificate can be self-signed using the following
+            #     command,
+            #        openssl x509 -req -days 200 -in example.com.csr \
+            #          -signkey example.com.key \
+            #          -out example.com.crt \
+            #          -extfile <(printf "\nsubjectAltName='DNS:www.example.com'")
             class GenericWebService
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-dialogflow-cx-v3
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-08 00:00:00.000000000 Z
+date: 2021-12-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common