google-cloud-retail-v2 0.3.2 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87b9f4c67fc0eb686393793f16351c68da89eabde00f3327d8b1d38efbb6ee37
-  data.tar.gz: 19537a2c1d8ae67ff434f8f7066c7eb4cc5fd1664883eba0fba0eb5de10c9c95
+  metadata.gz: 4362ee1ee1297de1e4f20da8c2e02d5b20a38f5334da03e58db621276d2d767b
+  data.tar.gz: 7de1bf1b00e922ab9b07c4b7912161f3af7dce3cd46fb4bf4f139d4dd53fba1d
 SHA512:
-  metadata.gz: fdd2817462eddf5a7e74bba977b47475a04d10e80e6d071cd6ad2776cf4b67db03b19fa8ddfe462a9d1b13f6266f69756307ca841a8d3d87d14cbdad80c93a5b
-  data.tar.gz: c14247f18a0d53cd5a57f9b73b0bcf7b4c0d6b39dd06f226a70f0a346d9375a5b5b99c8972790a0578e69581fa136fa8ce62102431034df8544565a934714280
+  metadata.gz: 1dca8e4dc874b55df773716b5115820d4e4f528a88673cf55107acaae041fd3aa8ee236b5bfaa20244172ae23a9b92053dfb10c77c6ee252610c635f19cc35a9
+  data.tar.gz: 66bc9026d1216894564f36f5fe8ed093225e7213ed85e3571dce187a4b9ab672023b51706d727ca4acee795ced47cbcfdb9e1aab84146ca75866546ffc15a8e4

data/lib/google/cloud/retail/v2/catalog_pb.rb

@@ -6,6 +6,8 @@ require 'google/protobuf'
 require 'google/api/annotations_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/cloud/retail/v2/common_pb'
+require 'google/cloud/retail/v2/import_config_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/retail/v2/catalog.proto", :syntax => :proto3) do
     add_message "google.cloud.retail.v2.ProductLevelConfig" do

data/lib/google/cloud/retail/v2/catalog_service/client.rb

@@ -41,13 +41,12 @@ module Google
             # See {::Google::Cloud::Retail::V2::CatalogService::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
+            # @example
             #
-            # To modify the configuration for all CatalogService clients:
-            #
-            #     ::Google::Cloud::Retail::V2::CatalogService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all CatalogService clients
+            #   ::Google::Cloud::Retail::V2::CatalogService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -99,19 +98,15 @@ module Google
             ##
             # Create a new CatalogService client object.
             #
-            # ## Examples
-            #
-            # To create a new CatalogService client with the default
-            # configuration:
+            # @example
             #
-            #     client = ::Google::Cloud::Retail::V2::CatalogService::Client.new
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::Retail::V2::CatalogService::Client.new
             #
-            # To create a new CatalogService client with a custom
-            # configuration:
-            #
-            #     client = ::Google::Cloud::Retail::V2::CatalogService::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::Retail::V2::CatalogService::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the CatalogService client.
             # @yieldparam config [Client::Configuration]
@@ -131,10 +126,9 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
-                                       @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
@@ -233,7 +227,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_catalogs.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_catalogs.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @catalog_service_stub.call_rpc :list_catalogs, request, options: options do |response, operation|
@@ -274,10 +270,7 @@ module Google
             #     a NOT_FOUND error is returned.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Indicates which fields in the provided
-            #     {::Google::Cloud::Retail::V2::Catalog Catalog} to update. If not set, will only
-            #     update the
-            #     {::Google::Cloud::Retail::V2::Catalog#product_level_config Catalog.product_level_config}
-            #     field, which is also the only currently supported field to update.
+            #     {::Google::Cloud::Retail::V2::Catalog Catalog} to update.
             #
             #     If an unsupported or unknown field is provided, an INVALID_ARGUMENT error
             #     is returned.
@@ -316,7 +309,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.update_catalog.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_catalog.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @catalog_service_stub.call_rpc :update_catalog, request, options: options do |response, operation|
@@ -327,6 +322,198 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Set a specified branch id as default branch. API methods such as
+            # {::Google::Cloud::Retail::V2::SearchService::Client#search SearchService.Search},
+            # {::Google::Cloud::Retail::V2::ProductService::Client#get_product ProductService.GetProduct},
+            # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}
+            # will treat requests using "default_branch" to the actual branch id set as
+            # default.
+            #
+            # For example, if `projects/*/locations/*/catalogs/*/branches/1` is set as
+            # default, setting
+            # {::Google::Cloud::Retail::V2::SearchRequest#branch SearchRequest.branch} to
+            # `projects/*/locations/*/catalogs/*/branches/default_branch` is equivalent
+            # to setting
+            # {::Google::Cloud::Retail::V2::SearchRequest#branch SearchRequest.branch} to
+            # `projects/*/locations/*/catalogs/*/branches/1`.
+            #
+            # Using multiple branches can be useful when developers would like
+            # to have a staging branch to test and verify for future usage. When it
+            # becomes ready, developers switch on the staging branch using this API while
+            # keeping using `projects/*/locations/*/catalogs/*/branches/default_branch`
+            # as {::Google::Cloud::Retail::V2::SearchRequest#branch SearchRequest.branch} to
+            # route the traffic to this staging branch.
+            #
+            # CAUTION: If you have live predict/search traffic, switching the default
+            # branch could potentially cause outages if the ID space of the new branch is
+            # very different from the old one.
+            #
+            # More specifically:
+            #
+            # * PredictionService will only return product IDs from branch \\{newBranch}.
+            # * SearchService will only return product IDs from branch \\{newBranch}
+            #   (if branch is not explicitly set).
+            # * UserEventService will only join events with products from branch
+            #   \\{newBranch}.
+            #
+            # This feature is only available for users who have Retail Search enabled.
+            # Please submit a form [here](https://cloud.google.com/contact) to contact
+            # cloud sales if you are interested in using Retail Search.
+            #
+            # @overload set_default_branch(request, options = nil)
+            #   Pass arguments to `set_default_branch` via a request object, either of type
+            #   {::Google::Cloud::Retail::V2::SetDefaultBranchRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Retail::V2::SetDefaultBranchRequest, ::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 set_default_branch(catalog: nil, branch_id: nil, note: nil)
+            #   Pass arguments to `set_default_branch` 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 catalog [::String]
+            #     Full resource name of the catalog, such as
+            #     `projects/*/locations/global/catalogs/default_catalog`.
+            #   @param branch_id [::String]
+            #     The final component of the resource name of a branch.
+            #
+            #     This field must be one of "0", "1" or "2". Otherwise, an INVALID_ARGUMENT
+            #     error is returned.
+            #   @param note [::String]
+            #     Some note on this request, this can be retrieved by
+            #     {::Google::Cloud::Retail::V2::CatalogService::Client#get_default_branch CatalogService.GetDefaultBranch}
+            #     before next valid default branch set occurs.
+            #
+            #     This field must be a UTF-8 encoded string with a length limit of 1,000
+            #     characters. Otherwise, an INVALID_ARGUMENT error is returned.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Protobuf::Empty]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Protobuf::Empty]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def set_default_branch request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Retail::V2::SetDefaultBranchRequest
+
+              # 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.set_default_branch.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::Retail::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "catalog" => request.catalog
+              }
+              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.set_default_branch.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.set_default_branch.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @catalog_service_stub.call_rpc :set_default_branch, 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
+
+            ##
+            # Get which branch is currently default branch set by
+            # {::Google::Cloud::Retail::V2::CatalogService::Client#set_default_branch CatalogService.SetDefaultBranch}
+            # method under a specified parent catalog.
+            #
+            # This feature is only available for users who have Retail Search enabled.
+            # Please submit a form [here](https://cloud.google.com/contact) to contact
+            # cloud sales if you are interested in using Retail Search.
+            #
+            # @overload get_default_branch(request, options = nil)
+            #   Pass arguments to `get_default_branch` via a request object, either of type
+            #   {::Google::Cloud::Retail::V2::GetDefaultBranchRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Retail::V2::GetDefaultBranchRequest, ::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 get_default_branch(catalog: nil)
+            #   Pass arguments to `get_default_branch` 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 catalog [::String]
+            #     The parent catalog resource name, such as
+            #     `projects/*/locations/global/catalogs/default_catalog`.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::Retail::V2::GetDefaultBranchResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::Retail::V2::GetDefaultBranchResponse]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def get_default_branch request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Retail::V2::GetDefaultBranchRequest
+
+              # 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.get_default_branch.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::Retail::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "catalog" => request.catalog
+              }
+              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.get_default_branch.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.get_default_branch.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @catalog_service_stub.call_rpc :get_default_branch, 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 CatalogService API.
             #
@@ -340,22 +527,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for list_catalogs
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Cloud::Retail::V2::CatalogService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_catalogs.timeout = 20.0
-            #     end
+            # @example
             #
-            # To apply the above configuration only to a new client:
+            #   # Modify the global config, setting the timeout for
+            #   # list_catalogs to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::Retail::V2::CatalogService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_catalogs.timeout = 20.0
+            #   end
             #
-            #     client = ::Google::Cloud::Retail::V2::CatalogService::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_catalogs.timeout = 20.0
-            #     end
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::Retail::V2::CatalogService::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_catalogs.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.
@@ -473,6 +659,16 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :update_catalog
+                ##
+                # RPC-specific configuration for `set_default_branch`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :set_default_branch
+                ##
+                # RPC-specific configuration for `get_default_branch`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :get_default_branch
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -480,6 +676,10 @@ module Google
                   @list_catalogs = ::Gapic::Config::Method.new list_catalogs_config
                   update_catalog_config = parent_rpcs.update_catalog if parent_rpcs.respond_to? :update_catalog
                   @update_catalog = ::Gapic::Config::Method.new update_catalog_config
+                  set_default_branch_config = parent_rpcs.set_default_branch if parent_rpcs.respond_to? :set_default_branch
+                  @set_default_branch = ::Gapic::Config::Method.new set_default_branch_config
+                  get_default_branch_config = parent_rpcs.get_default_branch if parent_rpcs.respond_to? :get_default_branch
+                  @get_default_branch = ::Gapic::Config::Method.new get_default_branch_config
 
                   yield self if block_given?
                 end

data/lib/google/cloud/retail/v2/catalog_service/paths.rb

@@ -24,6 +24,27 @@ module Google
         module CatalogService
           # Path helper methods for the CatalogService API.
           module Paths
+            ##
+            # Create a fully-qualified Branch resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/catalogs/{catalog}/branches/{branch}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param catalog [String]
+            # @param branch [String]
+            #
+            # @return [::String]
+            def branch_path project:, location:, catalog:, branch:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "catalog cannot contain /" if catalog.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/catalogs/#{catalog}/branches/#{branch}"
+            end
+
             ##
             # Create a fully-qualified Catalog resource string.
             #

data/lib/google/cloud/retail/v2/catalog_service_pb.rb

@@ -26,6 +26,19 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :catalog, :message, 1, "google.cloud.retail.v2.Catalog"
       optional :update_mask, :message, 2, "google.protobuf.FieldMask"
     end
+    add_message "google.cloud.retail.v2.SetDefaultBranchRequest" do
+      optional :catalog, :string, 1
+      optional :branch_id, :string, 2
+      optional :note, :string, 3
+    end
+    add_message "google.cloud.retail.v2.GetDefaultBranchRequest" do
+      optional :catalog, :string, 1
+    end
+    add_message "google.cloud.retail.v2.GetDefaultBranchResponse" do
+      optional :branch, :string, 1
+      optional :set_time, :message, 2, "google.protobuf.Timestamp"
+      optional :note, :string, 3
+    end
   end
 end
 
@@ -36,6 +49,9 @@ module Google
         ListCatalogsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ListCatalogsRequest").msgclass
         ListCatalogsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ListCatalogsResponse").msgclass
         UpdateCatalogRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.UpdateCatalogRequest").msgclass
+        SetDefaultBranchRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.SetDefaultBranchRequest").msgclass
+        GetDefaultBranchRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.GetDefaultBranchRequest").msgclass
+        GetDefaultBranchResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.GetDefaultBranchResponse").msgclass
       end
     end
   end

data/lib/google/cloud/retail/v2/catalog_service_services_pb.rb

@@ -38,6 +38,52 @@ module Google
             rpc :ListCatalogs, ::Google::Cloud::Retail::V2::ListCatalogsRequest, ::Google::Cloud::Retail::V2::ListCatalogsResponse
             # Updates the [Catalog][google.cloud.retail.v2.Catalog]s.
             rpc :UpdateCatalog, ::Google::Cloud::Retail::V2::UpdateCatalogRequest, ::Google::Cloud::Retail::V2::Catalog
+            # Set a specified branch id as default branch. API methods such as
+            # [SearchService.Search][google.cloud.retail.v2.SearchService.Search],
+            # [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct],
+            # [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]
+            # will treat requests using "default_branch" to the actual branch id set as
+            # default.
+            #
+            # For example, if `projects/*/locations/*/catalogs/*/branches/1` is set as
+            # default, setting
+            # [SearchRequest.branch][google.cloud.retail.v2.SearchRequest.branch] to
+            # `projects/*/locations/*/catalogs/*/branches/default_branch` is equivalent
+            # to setting
+            # [SearchRequest.branch][google.cloud.retail.v2.SearchRequest.branch] to
+            # `projects/*/locations/*/catalogs/*/branches/1`.
+            #
+            # Using multiple branches can be useful when developers would like
+            # to have a staging branch to test and verify for future usage. When it
+            # becomes ready, developers switch on the staging branch using this API while
+            # keeping using `projects/*/locations/*/catalogs/*/branches/default_branch`
+            # as [SearchRequest.branch][google.cloud.retail.v2.SearchRequest.branch] to
+            # route the traffic to this staging branch.
+            #
+            # CAUTION: If you have live predict/search traffic, switching the default
+            # branch could potentially cause outages if the ID space of the new branch is
+            # very different from the old one.
+            #
+            # More specifically:
+            #
+            # * PredictionService will only return product IDs from branch {newBranch}.
+            # * SearchService will only return product IDs from branch {newBranch}
+            #   (if branch is not explicitly set).
+            # * UserEventService will only join events with products from branch
+            #   {newBranch}.
+            #
+            # This feature is only available for users who have Retail Search enabled.
+            # Please submit a form [here](https://cloud.google.com/contact) to contact
+            # cloud sales if you are interested in using Retail Search.
+            rpc :SetDefaultBranch, ::Google::Cloud::Retail::V2::SetDefaultBranchRequest, ::Google::Protobuf::Empty
+            # Get which branch is currently default branch set by
+            # [CatalogService.SetDefaultBranch][google.cloud.retail.v2.CatalogService.SetDefaultBranch]
+            # method under a specified parent catalog.
+            #
+            # This feature is only available for users who have Retail Search enabled.
+            # Please submit a form [here](https://cloud.google.com/contact) to contact
+            # cloud sales if you are interested in using Retail Search.
+            rpc :GetDefaultBranch, ::Google::Cloud::Retail::V2::GetDefaultBranchRequest, ::Google::Cloud::Retail::V2::GetDefaultBranchResponse
           end
 
           Stub = Service.rpc_stub_class