RubyGems - google-cloud-discovery_engine - Versions diffs - 2.2.0 → 2.3.0 - Mend

google-cloud-discovery_engine 2.2.0 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

checksums.yaml +4 -4
data/AUTHENTICATION.md +3 -3
data/lib/google/cloud/discovery_engine/version.rb +1 -1
data/lib/google/cloud/discovery_engine.rb +207 -67
metadata +1 -1

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb4ceb96719fd35e63d93d810ea1d8d3af43dcec653873f08b9272ac56ebe104
-  data.tar.gz: fc1464e350098d8b41d9fc7da946c8851efa98919633999cd534b3c0b02a7180
+  metadata.gz: 4746637b6d60d527b86a4b2a83bee92c4e87af1763312758cbb5b5f786f9a0d4
+  data.tar.gz: fa8450d7fa4d7696132cf2dcf832ba17985a5545daac360a2a7c8602187439b8
 SHA512:
-  metadata.gz: cb654c8efebba561f7e03cfe0c868a725b59c58a08e12dd8abc236d3696b6e36cc678f3e87d89b0309e42f925d2a582b972623eb6d81304be65fb7626fb6c5af
-  data.tar.gz: 5a2b7b61709fe7a597374db131a0b18e0b4c91ada91c23300e5d364cc3c181aae4f762eba0c08e0936f832908b92e5507872c9734b69c7fb55e9b091d418a2fc
+  metadata.gz: 65a4074b249504feaef862ca4923ab13d61a225bd3514dffd784afe13d7fb4a179876f55473e0050c1259c90c44226dd0383845c53b69900ed3342e437de8d56
+  data.tar.gz: 3be508227faea3c122ac6ef7890d30f512dacc969a50c947785dcc7b06dc45957df6e4e0a59f5374739052526984dbbfb25bcfef0680b62f0ca25ad9414edd9e

data/AUTHENTICATION.md CHANGED Viewed

@@ -56,7 +56,7 @@ To configure a credentials file for an individual client initialization:
 ```ruby
 require "google/cloud/discovery_engine"
-client = Google::Cloud::DiscoveryEngine.cmek_config_service do |config|
+client = Google::Cloud::DiscoveryEngine.search_service do |config|
   config.credentials = "path/to/credentialfile.json"
 end
 ```
@@ -70,7 +70,7 @@ Google::Cloud::DiscoveryEngine.configure do |config|
   config.credentials = "path/to/credentialfile.json"
 end
-client = Google::Cloud::DiscoveryEngine.cmek_config_service
+client = Google::Cloud::DiscoveryEngine.search_service
 ```
 ### Environment Variables
@@ -100,7 +100,7 @@ require "google/cloud/discovery_engine"
 ENV["GOOGLE_APPLICATION_CREDENTIALS"] = "path/to/credentialfile.json"
-client = Google::Cloud::DiscoveryEngine.cmek_config_service
+client = Google::Cloud::DiscoveryEngine.search_service
 ```
 ### Local ADC file

data/lib/google/cloud/discovery_engine/version.rb CHANGED Viewed

@@ -20,7 +20,7 @@
 module Google
   module Cloud
     module DiscoveryEngine
-      VERSION = "2.2.0"
+      VERSION = "2.3.0"
     end
   end
 end

data/lib/google/cloud/discovery_engine.rb CHANGED Viewed

@@ -46,57 +46,57 @@ module Google
   module Cloud
     module DiscoveryEngine
       ##
-      # Create a new client object for CmekConfigService.
+      # Create a new client object for SearchService.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::DiscoveryEngine::V1::CmekConfigService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-discovery_engine-v1/latest/Google-Cloud-DiscoveryEngine-V1-CmekConfigService-Client)
+      # [Google::Cloud::DiscoveryEngine::V1::SearchService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-discovery_engine-v1/latest/Google-Cloud-DiscoveryEngine-V1-SearchService-Client)
       # for a gRPC client for version V1 of the API.
       # However, you can specify a different API version by passing it in the
-      # `version` parameter. If the CmekConfigService service is
+      # `version` parameter. If the SearchService 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 CmekConfigService service.
+      # given API version does not support the given transport of the SearchService service.
       # You can determine whether the method will succeed by calling
-      # {Google::Cloud::DiscoveryEngine.cmek_config_service_available?}.
+      # {Google::Cloud::DiscoveryEngine.search_service_available?}.
       #
-      # ## About CmekConfigService
+      # ## About SearchService
       #
-      # Service for managing CMEK related tasks
+      # Service for search.
       #
       # @param version [::String, ::Symbol] The API version to connect to. Optional.
       #   Defaults to `:v1`.
       # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
       # @return [::Object] A client object for the specified version.
       #
-      def self.cmek_config_service version: :v1, transport: :grpc, &block
+      def self.search_service version: :v1, transport: :grpc, &block
         require "google/cloud/discovery_engine/#{version.to_s.downcase}"
         package_name = Google::Cloud::DiscoveryEngine
                        .constants
                        .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                        .first
-        service_module = Google::Cloud::DiscoveryEngine.const_get(package_name).const_get(:CmekConfigService)
+        service_module = Google::Cloud::DiscoveryEngine.const_get(package_name).const_get(:SearchService)
         service_module = service_module.const_get(:Rest) if transport == :rest
         service_module.const_get(:Client).new(&block)
       end
       ##
-      # Determines whether the CmekConfigService service is supported by the current client.
-      # If true, you can retrieve a client object by calling {Google::Cloud::DiscoveryEngine.cmek_config_service}.
+      # Determines whether the SearchService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Cloud::DiscoveryEngine.search_service}.
       # If false, that method will raise an exception. This could happen if the given
-      # API version does not exist or does not support the CmekConfigService service,
-      # or if the versioned client gem needs an update to support the CmekConfigService service.
+      # API version does not exist or does not support the SearchService service,
+      # or if the versioned client gem needs an update to support the SearchService service.
       #
       # @param version [::String, ::Symbol] The API version to connect to. Optional.
       #   Defaults to `:v1`.
       # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
       # @return [boolean] Whether the service is available.
       #
-      def self.cmek_config_service_available? version: :v1, transport: :grpc
+      def self.search_service_available? version: :v1, transport: :grpc
         require "google/cloud/discovery_engine/#{version.to_s.downcase}"
         package_name = Google::Cloud::DiscoveryEngine
                        .constants
@@ -104,8 +104,8 @@ module Google
                        .first
         return false unless package_name
         service_module = Google::Cloud::DiscoveryEngine.const_get package_name
-        return false unless service_module.const_defined? :CmekConfigService
-        service_module = service_module.const_get :CmekConfigService
+        return false unless service_module.const_defined? :SearchService
+        service_module = service_module.const_get :SearchService
         if transport == :rest
           return false unless service_module.const_defined? :Rest
           service_module = service_module.const_get :Rest
@@ -116,57 +116,57 @@ module Google
       end
       ##
-      # Create a new client object for CompletionService.
+      # Create a new client object for AssistantService.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::DiscoveryEngine::V1::CompletionService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-discovery_engine-v1/latest/Google-Cloud-DiscoveryEngine-V1-CompletionService-Client)
+      # [Google::Cloud::DiscoveryEngine::V1::AssistantService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-discovery_engine-v1/latest/Google-Cloud-DiscoveryEngine-V1-AssistantService-Client)
       # for a gRPC client for version V1 of the API.
       # However, you can specify a different API version by passing it in the
-      # `version` parameter. If the CompletionService service is
+      # `version` parameter. If the AssistantService 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 CompletionService service.
+      # given API version does not support the given transport of the AssistantService service.
       # You can determine whether the method will succeed by calling
-      # {Google::Cloud::DiscoveryEngine.completion_service_available?}.
+      # {Google::Cloud::DiscoveryEngine.assistant_service_available?}.
       #
-      # ## About CompletionService
+      # ## About AssistantService
       #
-      # Service for Auto-Completion.
+      # Service for managing Assistant configuration and assisting users.
       #
       # @param version [::String, ::Symbol] The API version to connect to. Optional.
       #   Defaults to `:v1`.
       # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
       # @return [::Object] A client object for the specified version.
       #
-      def self.completion_service version: :v1, transport: :grpc, &block
+      def self.assistant_service version: :v1, transport: :grpc, &block
         require "google/cloud/discovery_engine/#{version.to_s.downcase}"
         package_name = Google::Cloud::DiscoveryEngine
                        .constants
                        .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                        .first
-        service_module = Google::Cloud::DiscoveryEngine.const_get(package_name).const_get(:CompletionService)
+        service_module = Google::Cloud::DiscoveryEngine.const_get(package_name).const_get(:AssistantService)
         service_module = service_module.const_get(:Rest) if transport == :rest
         service_module.const_get(:Client).new(&block)
       end
       ##
-      # Determines whether the CompletionService service is supported by the current client.
-      # If true, you can retrieve a client object by calling {Google::Cloud::DiscoveryEngine.completion_service}.
+      # Determines whether the AssistantService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Cloud::DiscoveryEngine.assistant_service}.
       # If false, that method will raise an exception. This could happen if the given
-      # API version does not exist or does not support the CompletionService service,
-      # or if the versioned client gem needs an update to support the CompletionService service.
+      # API version does not exist or does not support the AssistantService service,
+      # or if the versioned client gem needs an update to support the AssistantService service.
       #
       # @param version [::String, ::Symbol] The API version to connect to. Optional.
       #   Defaults to `:v1`.
       # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
       # @return [boolean] Whether the service is available.
       #
-      def self.completion_service_available? version: :v1, transport: :grpc
+      def self.assistant_service_available? version: :v1, transport: :grpc
         require "google/cloud/discovery_engine/#{version.to_s.downcase}"
         package_name = Google::Cloud::DiscoveryEngine
                        .constants
@@ -174,8 +174,8 @@ module Google
                        .first
         return false unless package_name
         service_module = Google::Cloud::DiscoveryEngine.const_get package_name
-        return false unless service_module.const_defined? :CompletionService
-        service_module = service_module.const_get :CompletionService
+        return false unless service_module.const_defined? :AssistantService
+        service_module = service_module.const_get :AssistantService
         if transport == :rest
           return false unless service_module.const_defined? :Rest
           service_module = service_module.const_get :Rest
@@ -186,60 +186,57 @@ module Google
       end
       ##
-      # Create a new client object for ControlService.
+      # Create a new client object for CmekConfigService.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::DiscoveryEngine::V1::ControlService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-discovery_engine-v1/latest/Google-Cloud-DiscoveryEngine-V1-ControlService-Client)
+      # [Google::Cloud::DiscoveryEngine::V1::CmekConfigService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-discovery_engine-v1/latest/Google-Cloud-DiscoveryEngine-V1-CmekConfigService-Client)
       # for a gRPC client for version V1 of the API.
       # However, you can specify a different API version by passing it in the
-      # `version` parameter. If the ControlService service is
+      # `version` parameter. If the CmekConfigService 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 ControlService service.
+      # given API version does not support the given transport of the CmekConfigService service.
       # You can determine whether the method will succeed by calling
-      # {Google::Cloud::DiscoveryEngine.control_service_available?}.
+      # {Google::Cloud::DiscoveryEngine.cmek_config_service_available?}.
       #
-      # ## About ControlService
+      # ## About CmekConfigService
       #
-      # Service for performing CRUD operations on Controls.
-      # Controls allow for custom logic to be implemented in the serving path.
-      # Controls need to be attached to a Serving Config to be considered during a
-      # request.
+      # Service for managing CMEK related tasks
       #
       # @param version [::String, ::Symbol] The API version to connect to. Optional.
       #   Defaults to `:v1`.
       # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
       # @return [::Object] A client object for the specified version.
       #
-      def self.control_service version: :v1, transport: :grpc, &block
+      def self.cmek_config_service version: :v1, transport: :grpc, &block
         require "google/cloud/discovery_engine/#{version.to_s.downcase}"
         package_name = Google::Cloud::DiscoveryEngine
                        .constants
                        .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                        .first
-        service_module = Google::Cloud::DiscoveryEngine.const_get(package_name).const_get(:ControlService)
+        service_module = Google::Cloud::DiscoveryEngine.const_get(package_name).const_get(:CmekConfigService)
         service_module = service_module.const_get(:Rest) if transport == :rest
         service_module.const_get(:Client).new(&block)
       end
       ##
-      # Determines whether the ControlService service is supported by the current client.
-      # If true, you can retrieve a client object by calling {Google::Cloud::DiscoveryEngine.control_service}.
+      # Determines whether the CmekConfigService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Cloud::DiscoveryEngine.cmek_config_service}.
       # If false, that method will raise an exception. This could happen if the given
-      # API version does not exist or does not support the ControlService service,
-      # or if the versioned client gem needs an update to support the ControlService service.
+      # API version does not exist or does not support the CmekConfigService service,
+      # or if the versioned client gem needs an update to support the CmekConfigService service.
       #
       # @param version [::String, ::Symbol] The API version to connect to. Optional.
       #   Defaults to `:v1`.
       # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
       # @return [boolean] Whether the service is available.
       #
-      def self.control_service_available? version: :v1, transport: :grpc
+      def self.cmek_config_service_available? version: :v1, transport: :grpc
         require "google/cloud/discovery_engine/#{version.to_s.downcase}"
         package_name = Google::Cloud::DiscoveryEngine
                        .constants
@@ -247,8 +244,8 @@ module Google
                        .first
         return false unless package_name
         service_module = Google::Cloud::DiscoveryEngine.const_get package_name
-        return false unless service_module.const_defined? :ControlService
-        service_module = service_module.const_get :ControlService
+        return false unless service_module.const_defined? :CmekConfigService
+        service_module = service_module.const_get :CmekConfigService
         if transport == :rest
           return false unless service_module.const_defined? :Rest
           service_module = service_module.const_get :Rest
@@ -259,57 +256,57 @@ module Google
       end
       ##
-      # Create a new client object for SearchService.
+      # Create a new client object for CompletionService.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::DiscoveryEngine::V1::SearchService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-discovery_engine-v1/latest/Google-Cloud-DiscoveryEngine-V1-SearchService-Client)
+      # [Google::Cloud::DiscoveryEngine::V1::CompletionService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-discovery_engine-v1/latest/Google-Cloud-DiscoveryEngine-V1-CompletionService-Client)
       # for a gRPC client for version V1 of the API.
       # However, you can specify a different API version by passing it in the
-      # `version` parameter. If the SearchService service is
+      # `version` parameter. If the CompletionService 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 SearchService service.
+      # given API version does not support the given transport of the CompletionService service.
       # You can determine whether the method will succeed by calling
-      # {Google::Cloud::DiscoveryEngine.search_service_available?}.
+      # {Google::Cloud::DiscoveryEngine.completion_service_available?}.
       #
-      # ## About SearchService
+      # ## About CompletionService
       #
-      # Service for search.
+      # Service for Auto-Completion.
       #
       # @param version [::String, ::Symbol] The API version to connect to. Optional.
       #   Defaults to `:v1`.
       # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
       # @return [::Object] A client object for the specified version.
       #
-      def self.search_service version: :v1, transport: :grpc, &block
+      def self.completion_service version: :v1, transport: :grpc, &block
         require "google/cloud/discovery_engine/#{version.to_s.downcase}"
         package_name = Google::Cloud::DiscoveryEngine
                        .constants
                        .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                        .first
-        service_module = Google::Cloud::DiscoveryEngine.const_get(package_name).const_get(:SearchService)
+        service_module = Google::Cloud::DiscoveryEngine.const_get(package_name).const_get(:CompletionService)
         service_module = service_module.const_get(:Rest) if transport == :rest
         service_module.const_get(:Client).new(&block)
       end
       ##
-      # Determines whether the SearchService service is supported by the current client.
-      # If true, you can retrieve a client object by calling {Google::Cloud::DiscoveryEngine.search_service}.
+      # Determines whether the CompletionService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Cloud::DiscoveryEngine.completion_service}.
       # If false, that method will raise an exception. This could happen if the given
-      # API version does not exist or does not support the SearchService service,
-      # or if the versioned client gem needs an update to support the SearchService service.
+      # API version does not exist or does not support the CompletionService service,
+      # or if the versioned client gem needs an update to support the CompletionService service.
       #
       # @param version [::String, ::Symbol] The API version to connect to. Optional.
       #   Defaults to `:v1`.
       # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
       # @return [boolean] Whether the service is available.
       #
-      def self.search_service_available? version: :v1, transport: :grpc
+      def self.completion_service_available? version: :v1, transport: :grpc
         require "google/cloud/discovery_engine/#{version.to_s.downcase}"
         package_name = Google::Cloud::DiscoveryEngine
                        .constants
@@ -317,8 +314,81 @@ module Google
                        .first
         return false unless package_name
         service_module = Google::Cloud::DiscoveryEngine.const_get package_name
-        return false unless service_module.const_defined? :SearchService
-        service_module = service_module.const_get :SearchService
+        return false unless service_module.const_defined? :CompletionService
+        service_module = service_module.const_get :CompletionService
+        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 ControlService.
+      #
+      # By default, this returns an instance of
+      # [Google::Cloud::DiscoveryEngine::V1::ControlService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-discovery_engine-v1/latest/Google-Cloud-DiscoveryEngine-V1-ControlService-Client)
+      # for a gRPC client for version V1 of the API.
+      # However, you can specify a different API version by passing it in the
+      # `version` parameter. If the ControlService 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 ControlService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Cloud::DiscoveryEngine.control_service_available?}.
+      #
+      # ## About ControlService
+      #
+      # Service for performing CRUD operations on Controls.
+      # Controls allow for custom logic to be implemented in the serving path.
+      # Controls need to be attached to a Serving Config to be considered during a
+      # request.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+      # @return [::Object] A client object for the specified version.
+      #
+      def self.control_service version: :v1, transport: :grpc, &block
+        require "google/cloud/discovery_engine/#{version.to_s.downcase}"
+        package_name = Google::Cloud::DiscoveryEngine
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        service_module = Google::Cloud::DiscoveryEngine.const_get(package_name).const_get(:ControlService)
+        service_module = service_module.const_get(:Rest) if transport == :rest
+        service_module.const_get(:Client).new(&block)
+      end
+      ##
+      # Determines whether the ControlService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Cloud::DiscoveryEngine.control_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the ControlService service,
+      # or if the versioned client gem needs an update to support the ControlService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.control_service_available? version: :v1, transport: :grpc
+        require "google/cloud/discovery_engine/#{version.to_s.downcase}"
+        package_name = Google::Cloud::DiscoveryEngine
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Cloud::DiscoveryEngine.const_get package_name
+        return false unless service_module.const_defined? :ControlService
+        service_module = service_module.const_get :ControlService
         if transport == :rest
           return false unless service_module.const_defined? :Rest
           service_module = service_module.const_get :Rest
@@ -1173,6 +1243,76 @@ module Google
         false
       end
+      ##
+      # Create a new client object for SessionService.
+      #
+      # By default, this returns an instance of
+      # [Google::Cloud::DiscoveryEngine::V1::SessionService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-discovery_engine-v1/latest/Google-Cloud-DiscoveryEngine-V1-SessionService-Client)
+      # for a gRPC client for version V1 of the API.
+      # However, you can specify a different API version by passing it in the
+      # `version` parameter. If the SessionService 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 SessionService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Cloud::DiscoveryEngine.session_service_available?}.
+      #
+      # ## About SessionService
+      #
+      # Service for managing Sessions and Session-related resources.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+      # @return [::Object] A client object for the specified version.
+      #
+      def self.session_service version: :v1, transport: :grpc, &block
+        require "google/cloud/discovery_engine/#{version.to_s.downcase}"
+        package_name = Google::Cloud::DiscoveryEngine
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        service_module = Google::Cloud::DiscoveryEngine.const_get(package_name).const_get(:SessionService)
+        service_module = service_module.const_get(:Rest) if transport == :rest
+        service_module.const_get(:Client).new(&block)
+      end
+      ##
+      # Determines whether the SessionService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Cloud::DiscoveryEngine.session_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the SessionService service,
+      # or if the versioned client gem needs an update to support the SessionService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.session_service_available? version: :v1, transport: :grpc
+        require "google/cloud/discovery_engine/#{version.to_s.downcase}"
+        package_name = Google::Cloud::DiscoveryEngine
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Cloud::DiscoveryEngine.const_get package_name
+        return false unless service_module.const_defined? :SessionService
+        service_module = service_module.const_get :SessionService
+        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 SiteSearchEngineService.
       #

metadata CHANGED Viewed

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-discovery_engine
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.3.0
 platform: ruby
 authors:
 - Google LLC