google-cloud-retail 1.5.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a326f2f1ee0d5dc971bfad4ab9da4471a42c96b9b21198358f70dbced31cd03e
-  data.tar.gz: c2c2a27b28126b2a994a7bb9a32b68d723724e3d4086dd0bcb8f3de35e21c0f8
+  metadata.gz: 060ad8166da2508d4e0127a9ea5e6f01006df1292a2257d839ed508831443e27
+  data.tar.gz: 805a0e8891dc8e2caecc5562e8fda00bff4ab054589ed4fd2f9eba5ca34dbd17
 SHA512:
-  metadata.gz: ad0b6f0b358e1f020498c46cb925e20889a036825179f86263720e4c46d9f18dd9b9d30fd580103004e4c0b29800f7d66e5bcb748b1df80991160fa4705c0edc
-  data.tar.gz: 4299c9e05edb3450d847c420df94ba2b064e1d382b3d921307788159db7b7f1e16eb19ff6420466358cad23d83a4c39afbd97205513cd722492b8fb6403bd2cf
+  metadata.gz: 712c9e42532350d27aacd7204c9cb1df90ee6fa25602d67bbea01ce63cc1f6970256a5145594cd086873f41e6fa32d218acf8a73d89173499637cb97bccdaf1c
+  data.tar.gz: 216e17b1fe6a35c44fc92f38802179a049519ab9b42773d87d69fc9aae98115a479d38e1fe478eace2b1835a39332493200e2e811502aa5d53dc948505a64475

data/README.md

@@ -16,7 +16,7 @@ for this library, google-cloud-retail, to see the convenience methods for
 constructing client objects. Reference documentation for the client objects
 themselves can be found in the client library documentation for the versioned
 client gems:
-[google-cloud-retail-v2](https://googleapis.dev/ruby/google-cloud-retail-v2/latest).
+[google-cloud-retail-v2](https://cloud.google.com/ruby/docs/reference/google-cloud-retail-v2/latest).
 
 See also the [Product Documentation](https://cloud.google.com/retail/docs/apis)
 for more usage information.

data/lib/google/cloud/retail/version.rb

@@ -20,7 +20,7 @@
 module Google
   module Cloud
     module Retail
-      VERSION = "1.5.0"
+      VERSION = "1.6.0"
     end
   end
 end

data/lib/google/cloud/retail.rb

@@ -48,7 +48,7 @@ module Google
       # Create a new client object for CatalogService.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::Retail::V2::CatalogService::Client](https://googleapis.dev/ruby/google-cloud-retail-v2/latest/Google/Cloud/Retail/V2/CatalogService/Client.html)
+      # [Google::Cloud::Retail::V2::CatalogService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-retail-v2/latest/Google-Cloud-Retail-V2-CatalogService-Client)
       # for a gRPC client for version V2 of the API.
       # However, you can specify a different API version by passing it in the
       # `version` parameter. If the CatalogService service is
@@ -82,7 +82,7 @@ module Google
       # Create a new client object for CompletionService.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::Retail::V2::CompletionService::Client](https://googleapis.dev/ruby/google-cloud-retail-v2/latest/Google/Cloud/Retail/V2/CompletionService/Client.html)
+      # [Google::Cloud::Retail::V2::CompletionService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-retail-v2/latest/Google-Cloud-Retail-V2-CompletionService-Client)
       # for a gRPC client for version V2 of the API.
       # However, you can specify a different API version by passing it in the
       # `version` parameter. If the CompletionService service is
@@ -93,7 +93,7 @@ module Google
       #
       # ## About CompletionService
       #
-      # Auto-completion service for retail.
+      # Autocomplete service for retail.
       #
       # This feature is only available for users who have Retail Search enabled.
       # Enable Retail Search on Cloud Console before using this feature.
@@ -119,7 +119,7 @@ module Google
       # Create a new client object for ControlService.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::Retail::V2::ControlService::Client](https://googleapis.dev/ruby/google-cloud-retail-v2/latest/Google/Cloud/Retail/V2/ControlService/Client.html)
+      # [Google::Cloud::Retail::V2::ControlService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-retail-v2/latest/Google-Cloud-Retail-V2-ControlService-Client)
       # for a gRPC client for version V2 of the API.
       # However, you can specify a different API version by passing it in the
       # `version` parameter. If the ControlService service is
@@ -149,11 +149,56 @@ module Google
         service_module.const_get(:Client).new(&block)
       end
 
+      ##
+      # Create a new client object for ModelService.
+      #
+      # By default, this returns an instance of
+      # [Google::Cloud::Retail::V2::ModelService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-retail-v2/latest/Google-Cloud-Retail-V2-ModelService-Client)
+      # for a gRPC client for version V2 of the API.
+      # However, you can specify a different API version by passing it in the
+      # `version` parameter. If the ModelService 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.
+      #
+      # ## About ModelService
+      #
+      # Service for performing CRUD operations on models.
+      # Recommendation models contain all the metadata necessary to generate a set of
+      # models for the `Predict()` API. A model is queried
+      # indirectly via a ServingConfig, which associates a model with a
+      # given Placement (e.g. Frequently Bought Together on Home Page).
+      #
+      # This service allows you to do the following:
+      #
+      # * Initiate training of a model.
+      # * Pause training of an existing model.
+      # * List all the available models along with their metadata.
+      # * Control their tuning schedule.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v2`.
+      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+      # @return [::Object] A client object for the specified version.
+      #
+      def self.model_service version: :v2, transport: :grpc, &block
+        require "google/cloud/retail/#{version.to_s.downcase}"
+
+        package_name = Google::Cloud::Retail
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        service_module = Google::Cloud::Retail.const_get(package_name).const_get(:ModelService)
+        service_module = service_module.const_get(:Rest) if transport == :rest
+        service_module.const_get(:Client).new(&block)
+      end
+
       ##
       # Create a new client object for PredictionService.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::Retail::V2::PredictionService::Client](https://googleapis.dev/ruby/google-cloud-retail-v2/latest/Google/Cloud/Retail/V2/PredictionService/Client.html)
+      # [Google::Cloud::Retail::V2::PredictionService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-retail-v2/latest/Google-Cloud-Retail-V2-PredictionService-Client)
       # for a gRPC client for version V2 of the API.
       # However, you can specify a different API version by passing it in the
       # `version` parameter. If the PredictionService service is
@@ -187,7 +232,7 @@ module Google
       # Create a new client object for ProductService.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::Retail::V2::ProductService::Client](https://googleapis.dev/ruby/google-cloud-retail-v2/latest/Google/Cloud/Retail/V2/ProductService/Client.html)
+      # [Google::Cloud::Retail::V2::ProductService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-retail-v2/latest/Google-Cloud-Retail-V2-ProductService-Client)
       # for a gRPC client for version V2 of the API.
       # However, you can specify a different API version by passing it in the
       # `version` parameter. If the ProductService service is
@@ -222,7 +267,7 @@ module Google
       # Create a new client object for SearchService.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::Retail::V2::SearchService::Client](https://googleapis.dev/ruby/google-cloud-retail-v2/latest/Google/Cloud/Retail/V2/SearchService/Client.html)
+      # [Google::Cloud::Retail::V2::SearchService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-retail-v2/latest/Google-Cloud-Retail-V2-SearchService-Client)
       # for a gRPC client for version V2 of the API.
       # However, you can specify a different API version by passing it in the
       # `version` parameter. If the SearchService service is
@@ -259,7 +304,7 @@ module Google
       # Create a new client object for ServingConfigService.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::Retail::V2::ServingConfigService::Client](https://googleapis.dev/ruby/google-cloud-retail-v2/latest/Google/Cloud/Retail/V2/ServingConfigService/Client.html)
+      # [Google::Cloud::Retail::V2::ServingConfigService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-retail-v2/latest/Google-Cloud-Retail-V2-ServingConfigService-Client)
       # for a gRPC client for version V2 of the API.
       # However, you can specify a different API version by passing it in the
       # `version` parameter. If the ServingConfigService service is
@@ -293,7 +338,7 @@ module Google
       # Create a new client object for UserEventService.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::Retail::V2::UserEventService::Client](https://googleapis.dev/ruby/google-cloud-retail-v2/latest/Google/Cloud/Retail/V2/UserEventService/Client.html)
+      # [Google::Cloud::Retail::V2::UserEventService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-retail-v2/latest/Google-Cloud-Retail-V2-UserEventService-Client)
       # for a gRPC client for version V2 of the API.
       # However, you can specify a different API version by passing it in the
       # `version` parameter. If the UserEventService service is

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-retail
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-09 00:00:00.000000000 Z
+date: 2023-05-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -30,7 +30,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.15'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -40,7 +40,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.15'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a