google-cloud-dialogflow-cx 1.3.1 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 425d3d292ac691f9a39d215377fca6f62957ec9cb1a6fe3f693baee1d5a54066
-  data.tar.gz: 8f779589cdddc7a1633261031fd5bbd805b0cfeff3af7a38c52729d8bf52fef3
+  metadata.gz: 7cc4ac659541f0524f270611d053d72a401ff14a360fc6b023bbd41a65870554
+  data.tar.gz: 1d1286e521a2501d51e66502190df51b0045df781520ecee9482382bf9adc5c4
 SHA512:
-  metadata.gz: c4a5d7d9a4184492aae65a3a783abec3c3a40fe7dc301ae1544759bff595a652cac63abe4f4adec78293d1361d84d442084d789bc350692a52d45fccb367defe
-  data.tar.gz: 1657dfc360b1c4ba4c2011c4159883d63a83c55260b142b11a7eeb663e172ba75b840a72eca5be26ffb757940434bdbaa8367542f9e770136455d40f127f9dda
+  metadata.gz: a53a49b3f3fc4faa3ca21bb917205ea1cca6f909d8dd1966f31b815a6ec83f1a5ce946f3c061743cf2e9646449b4dbf41e42bf9f53848b5e5c383f4153488e88
+  data.tar.gz: 77b2ce530e34a36f1fcd33360fb82d87afa20e5becc2cd30e139210ddb654904b1e52a698857402b3616dd842eae0535ae794121d01123f5532dcb21a7a4f4d9

data/README.md

@@ -34,6 +34,14 @@ In order to use this library, you first need to go through the following steps:
 1. [Enable the API.](https://console.cloud.google.com/apis/library/dialogflow.googleapis.com)
 1. {file:AUTHENTICATION.md Set up authentication.}
 
+```ruby
+require "google/cloud/dialogflow/cx"
+
+client = Google::Cloud::Dialogflow::CX.pages
+request = ::Google::Cloud::Dialogflow::CX::V3::ListPagesRequest.new # (request fields as keyword arguments...)
+response = client.list_pages request
+```
+
 ## Debug Logging
 
 This library comes with opt-in Debug Logging that can help you troubleshoot

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Dialogflow
       module CX
-        VERSION = "1.3.1"
+        VERSION = "1.4.0"
       end
     end
   end

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

@@ -963,6 +963,76 @@ module Google
           false
         end
 
+        ##
+        # Create a new client object for Examples.
+        #
+        # By default, this returns an instance of
+        # [Google::Cloud::Dialogflow::CX::V3::Examples::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-cx-v3/latest/Google-Cloud-Dialogflow-CX-V3-Examples-Client)
+        # for a gRPC client for version V3 of the API.
+        # However, you can specify a different API version by passing it in the
+        # `version` parameter. If the Examples service is
+        # supported by that API version, and the corresponding gem is available, the
+        # appropriate versioned client will be returned.
+        # You can also specify a different transport by passing `:rest` or `:grpc` in
+        # the `transport` parameter.
+        #
+        # Raises an exception if the currently installed versioned client gem for the
+        # given API version does not support the given transport of the Examples service.
+        # You can determine whether the method will succeed by calling
+        # {Google::Cloud::Dialogflow::CX.examples_available?}.
+        #
+        # ## About Examples
+        #
+        # Service for managing Examples.
+        #
+        # @param version [::String, ::Symbol] The API version to connect to. Optional.
+        #   Defaults to `:v3`.
+        # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+        # @return [::Object] A client object for the specified version.
+        #
+        def self.examples version: :v3, transport: :grpc, &block
+          require "google/cloud/dialogflow/cx/#{version.to_s.downcase}"
+
+          package_name = Google::Cloud::Dialogflow::CX
+                         .constants
+                         .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                         .first
+          service_module = Google::Cloud::Dialogflow::CX.const_get(package_name).const_get(:Examples)
+          service_module = service_module.const_get(:Rest) if transport == :rest
+          service_module.const_get(:Client).new(&block)
+        end
+
+        ##
+        # Determines whether the Examples service is supported by the current client.
+        # If true, you can retrieve a client object by calling {Google::Cloud::Dialogflow::CX.examples}.
+        # If false, that method will raise an exception. This could happen if the given
+        # API version does not exist or does not support the Examples service,
+        # or if the versioned client gem needs an update to support the Examples service.
+        #
+        # @param version [::String, ::Symbol] The API version to connect to. Optional.
+        #   Defaults to `:v3`.
+        # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+        # @return [boolean] Whether the service is available.
+        #
+        def self.examples_available? version: :v3, transport: :grpc
+          require "google/cloud/dialogflow/cx/#{version.to_s.downcase}"
+          package_name = Google::Cloud::Dialogflow::CX
+                         .constants
+                         .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                         .first
+          return false unless package_name
+          service_module = Google::Cloud::Dialogflow::CX.const_get package_name
+          return false unless service_module.const_defined? :Examples
+          service_module = service_module.const_get :Examples
+          if transport == :rest
+            return false unless service_module.const_defined? :Rest
+            service_module = service_module.const_get :Rest
+          end
+          service_module.const_defined? :Client
+        rescue ::LoadError
+          false
+        end
+
         ##
         # Create a new client object for Experiments.
         #
@@ -1103,6 +1173,76 @@ module Google
           false
         end
 
+        ##
+        # Create a new client object for Playbooks.
+        #
+        # By default, this returns an instance of
+        # [Google::Cloud::Dialogflow::CX::V3::Playbooks::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-cx-v3/latest/Google-Cloud-Dialogflow-CX-V3-Playbooks-Client)
+        # for a gRPC client for version V3 of the API.
+        # However, you can specify a different API version by passing it in the
+        # `version` parameter. If the Playbooks service is
+        # supported by that API version, and the corresponding gem is available, the
+        # appropriate versioned client will be returned.
+        # You can also specify a different transport by passing `:rest` or `:grpc` in
+        # the `transport` parameter.
+        #
+        # Raises an exception if the currently installed versioned client gem for the
+        # given API version does not support the given transport of the Playbooks service.
+        # You can determine whether the method will succeed by calling
+        # {Google::Cloud::Dialogflow::CX.playbooks_available?}.
+        #
+        # ## About Playbooks
+        #
+        # Service for managing Playbooks.
+        #
+        # @param version [::String, ::Symbol] The API version to connect to. Optional.
+        #   Defaults to `:v3`.
+        # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+        # @return [::Object] A client object for the specified version.
+        #
+        def self.playbooks version: :v3, transport: :grpc, &block
+          require "google/cloud/dialogflow/cx/#{version.to_s.downcase}"
+
+          package_name = Google::Cloud::Dialogflow::CX
+                         .constants
+                         .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                         .first
+          service_module = Google::Cloud::Dialogflow::CX.const_get(package_name).const_get(:Playbooks)
+          service_module = service_module.const_get(:Rest) if transport == :rest
+          service_module.const_get(:Client).new(&block)
+        end
+
+        ##
+        # Determines whether the Playbooks service is supported by the current client.
+        # If true, you can retrieve a client object by calling {Google::Cloud::Dialogflow::CX.playbooks}.
+        # If false, that method will raise an exception. This could happen if the given
+        # API version does not exist or does not support the Playbooks service,
+        # or if the versioned client gem needs an update to support the Playbooks service.
+        #
+        # @param version [::String, ::Symbol] The API version to connect to. Optional.
+        #   Defaults to `:v3`.
+        # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+        # @return [boolean] Whether the service is available.
+        #
+        def self.playbooks_available? version: :v3, transport: :grpc
+          require "google/cloud/dialogflow/cx/#{version.to_s.downcase}"
+          package_name = Google::Cloud::Dialogflow::CX
+                         .constants
+                         .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                         .first
+          return false unless package_name
+          service_module = Google::Cloud::Dialogflow::CX.const_get package_name
+          return false unless service_module.const_defined? :Playbooks
+          service_module = service_module.const_get :Playbooks
+          if transport == :rest
+            return false unless service_module.const_defined? :Rest
+            service_module = service_module.const_get :Rest
+          end
+          service_module.const_defined? :Client
+        rescue ::LoadError
+          false
+        end
+
         ##
         # Create a new client object for SecuritySettingsService.
         #
@@ -1173,6 +1313,76 @@ module Google
           false
         end
 
+        ##
+        # Create a new client object for Tools.
+        #
+        # By default, this returns an instance of
+        # [Google::Cloud::Dialogflow::CX::V3::Tools::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-cx-v3/latest/Google-Cloud-Dialogflow-CX-V3-Tools-Client)
+        # for a gRPC client for version V3 of the API.
+        # However, you can specify a different API version by passing it in the
+        # `version` parameter. If the Tools service is
+        # supported by that API version, and the corresponding gem is available, the
+        # appropriate versioned client will be returned.
+        # You can also specify a different transport by passing `:rest` or `:grpc` in
+        # the `transport` parameter.
+        #
+        # Raises an exception if the currently installed versioned client gem for the
+        # given API version does not support the given transport of the Tools service.
+        # You can determine whether the method will succeed by calling
+        # {Google::Cloud::Dialogflow::CX.tools_available?}.
+        #
+        # ## About Tools
+        #
+        # Service for managing Tools.
+        #
+        # @param version [::String, ::Symbol] The API version to connect to. Optional.
+        #   Defaults to `:v3`.
+        # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+        # @return [::Object] A client object for the specified version.
+        #
+        def self.tools version: :v3, transport: :grpc, &block
+          require "google/cloud/dialogflow/cx/#{version.to_s.downcase}"
+
+          package_name = Google::Cloud::Dialogflow::CX
+                         .constants
+                         .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                         .first
+          service_module = Google::Cloud::Dialogflow::CX.const_get(package_name).const_get(:Tools)
+          service_module = service_module.const_get(:Rest) if transport == :rest
+          service_module.const_get(:Client).new(&block)
+        end
+
+        ##
+        # Determines whether the Tools service is supported by the current client.
+        # If true, you can retrieve a client object by calling {Google::Cloud::Dialogflow::CX.tools}.
+        # If false, that method will raise an exception. This could happen if the given
+        # API version does not exist or does not support the Tools service,
+        # or if the versioned client gem needs an update to support the Tools service.
+        #
+        # @param version [::String, ::Symbol] The API version to connect to. Optional.
+        #   Defaults to `:v3`.
+        # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+        # @return [boolean] Whether the service is available.
+        #
+        def self.tools_available? version: :v3, transport: :grpc
+          require "google/cloud/dialogflow/cx/#{version.to_s.downcase}"
+          package_name = Google::Cloud::Dialogflow::CX
+                         .constants
+                         .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                         .first
+          return false unless package_name
+          service_module = Google::Cloud::Dialogflow::CX.const_get package_name
+          return false unless service_module.const_defined? :Tools
+          service_module = service_module.const_get :Tools
+          if transport == :rest
+            return false unless service_module.const_defined? :Rest
+            service_module = service_module.const_get :Rest
+          end
+          service_module.const_defined? :Client
+        rescue ::LoadError
+          false
+        end
+
         ##
         # Create a new client object for Versions.
         #

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-dialogflow-cx
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.4.0
 platform: ruby
 authors:
 - Google LLC
@@ -72,14 +72,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.8
+rubygems_version: 3.6.9
 specification_version: 4
 summary: API Client library for the Dialogflow CX API
 test_files: []