google-cloud-recommender-v1 0.3.1 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b854a911691f57d45c304c4d4bf74de62eb83a70d1c252eda9250f244f558f88
-  data.tar.gz: fb0efe36c11e2aae0434710ae36b1d20aaaea6df823b243578147edbe0b0685d
+  metadata.gz: ad4774c50b90e40f5d74d59aea6f7b89ef88652bc6f87f5bfba825584560362a
+  data.tar.gz: 629db979d3784b9da36ddf9bd5e9705c378f1ec7cb718e958c9e5985d2dab88a
 SHA512:
-  metadata.gz: e15d154a646a9676d3335c7f1029469d51d3ebd27e654179dbd686dab57f9aca70d6559f71c3bd0a2225c9ac9a46286b8aed8a76179c4d3b744287fb1f2fb16e
-  data.tar.gz: 3191ab85ba008bbc482030e491535c3051859a7b10fb897d2caf701c7be648fa28ccda4930a92801b4e9a6c154f8f19aaa47a800b14baeccfa0cfd46407d00af
+  metadata.gz: 49bcc262f3b2c1217f4b8f079014a180108e4f37633bc5f38c29c915a2166ceafd740f821e6c68cd02659d7c490e1f70f915b582af349fa4f9008fe000bada55
+  data.tar.gz: eea13f795e632523ca9c773e13c9ce24a2cde6c65d5be549250a0cdbe01b20b9673a9ce819db1304aea3965b888728d6d11d4abb42323eabc05556e2ee443d54

data/AUTHENTICATION.md

@@ -27,7 +27,7 @@ export RECOMMENDER_CREDENTIALS=path/to/keyfile.json
 ```ruby
 require "google/cloud/recommender/v1"
 
-client = Google::Cloud::Recommender::V1::Recommender::Client.new
+client = ::Google::Cloud::Recommender::V1::Recommender::Client.new
 ```
 
 ## Credential Lookup
@@ -64,7 +64,7 @@ containers where writing files is difficult or not encouraged.
 
 The environment variables that google-cloud-recommender-v1
 checks for credentials are configured on the service Credentials class (such as
-{Google::Cloud::Recommender::V1::Recommender::Credentials}):
+{::Google::Cloud::Recommender::V1::Recommender::Credentials}):
 
 1. `RECOMMENDER_CREDENTIALS` - Path to JSON file, or JSON contents
 2. `RECOMMENDER_KEYFILE` - Path to JSON file, or JSON contents
@@ -77,7 +77,7 @@ require "google/cloud/recommender/v1"
 
 ENV["RECOMMENDER_CREDENTIALS"] = "path/to/keyfile.json"
 
-client = Google::Cloud::Recommender::V1::Recommender::Client.new
+client = ::Google::Cloud::Recommender::V1::Recommender::Client.new
 ```
 
 ### Configuration
@@ -88,7 +88,7 @@ environment variables. Either on an individual client initialization:
 ```ruby
 require "google/cloud/recommender/v1"
 
-client = Google::Cloud::Recommender::V1::Recommender::Client.new do |config|
+client = ::Google::Cloud::Recommender::V1::Recommender::Client.new do |config|
   config.credentials = "path/to/keyfile.json"
 end
 ```
@@ -98,11 +98,11 @@ Or configured globally for all clients:
 ```ruby
 require "google/cloud/recommender/v1"
 
-Google::Cloud::Recommender::V1::Recommender::Client.configure do |config|
+::Google::Cloud::Recommender::V1::Recommender::Client.configure do |config|
   config.credentials = "path/to/keyfile.json"
 end
 
-client = Google::Cloud::Recommender::V1::Recommender::Client.new
+client = ::Google::Cloud::Recommender::V1::Recommender::Client.new
 ```
 
 ### Cloud SDK

data/README.md

@@ -1,4 +1,4 @@
-# Recommender V1
+# Ruby Client for the Recommender V1 API
 
 API Client library for the Recommender V1 API
 
@@ -12,6 +12,53 @@ https://github.com/googleapis/google-cloud-ruby
 $ gem install google-cloud-recommender-v1
 ```
 
+## Before You Begin
+
+In order to use this library, you first need to go through the following steps:
+
+1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+1. {file:AUTHENTICATION.md Set up authentication.}
+
+## Quick Start
+
+```ruby
+require "google/cloud/recommender/v1"
+
+client = ::Google::Cloud::Recommender::V1::Recommender::Client.new
+request = my_create_request
+response = client.list_recommendations request
+```
+
+View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-recommender-v1/latest)
+for class and method documentation.
+
+## Enabling Logging
+
+To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
+or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+
+Configuring a Ruby stdlib logger:
+
+```ruby
+require "logger"
+
+module MyLogger
+  LOGGER = Logger.new $stderr, level: Logger::WARN
+  def logger
+    LOGGER
+  end
+end
+
+# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+module GRPC
+  extend MyLogger
+end
+```
+
 ## Supported Ruby Versions
 
 This library is supported on Ruby 2.4+.

data/lib/google-cloud-recommender-v1.rb

@@ -1 +1,21 @@
-require "google/cloud/recommender/v1/version"
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+# This gem does not autoload during Bundler.require. To load this gem,
+# issue explicit require statements for the packages desired, e.g.:
+# require "google/cloud/recommender/v1"

data/lib/google/cloud/recommender/v1.rb

@@ -17,3 +17,19 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
 require "google/cloud/recommender/v1/recommender"
+require "google/cloud/recommender/v1/version"
+
+module Google
+  module Cloud
+    module Recommender
+      ##
+      # To load this package, including all its services, and instantiate a client:
+      #
+      #     require "google/cloud/recommender/v1"
+      #     client = ::Google::Cloud::Recommender::V1::Recommender::Client.new
+      #
+      module V1
+      end
+    end
+  end
+end

data/lib/google/cloud/recommender/v1/recommender.rb

@@ -16,5 +16,37 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "google/cloud/recommender/v1/recommender/client"
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/recommender/v1/version"
+
 require "google/cloud/recommender/v1/recommender/credentials"
+require "google/cloud/recommender/v1/recommender/paths"
+require "google/cloud/recommender/v1/recommender/client"
+
+module Google
+  module Cloud
+    module Recommender
+      module V1
+        ##
+        # Provides recommendations for cloud customers for various categories like
+        # performance optimization, cost savings, reliability, feature discovery, etc.
+        # These recommendations are generated automatically based on analysis of user
+        # resources, configuration and monitoring metrics.
+        #
+        # To load this service and instantiate a client:
+        #
+        #     require "google/cloud/recommender/v1/recommender"
+        #     client = ::Google::Cloud::Recommender::V1::Recommender::Client.new
+        #
+        module Recommender
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "recommender", "helpers.rb"
+require "google/cloud/recommender/v1/recommender/helpers" if ::File.file? helper_path

data/lib/google/cloud/recommender/v1/recommender/client.rb

@@ -16,15 +16,8 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "gapic/common"
-require "gapic/config"
-require "gapic/config/method"
-
 require "google/cloud/errors"
-require "google/cloud/recommender/v1/version"
 require "google/cloud/recommender/v1/recommender_service_pb"
-require "google/cloud/recommender/v1/recommender/credentials"
-require "google/cloud/recommender/v1/recommender/paths"
 
 module Google
   module Cloud
@@ -48,15 +41,15 @@ module Google
             ##
             # Configure the Recommender Client class.
             #
-            # See {Google::Cloud::Recommender::V1::Recommender::Client::Configuration}
+            # See {::Google::Cloud::Recommender::V1::Recommender::Client::Configuration}
             # for a description of the configuration fields.
             #
             # ## Example
             #
             # To modify the configuration for all Recommender clients:
             #
-            #     Google::Cloud::Recommender::V1::Recommender::Client.configure do |config|
-            #       config.timeout = 10_000
+            #     ::Google::Cloud::Recommender::V1::Recommender::Client.configure do |config|
+            #       config.timeout = 10.0
             #     end
             #
             # @yield [config] Configure the Client client.
@@ -110,7 +103,7 @@ module Google
             # but structural changes (adding new fields, etc.) are not allowed. Structural changes
             # should be made on {Client.configure}.
             #
-            # See {Google::Cloud::Recommender::V1::Recommender::Client::Configuration}
+            # See {::Google::Cloud::Recommender::V1::Recommender::Client::Configuration}
             # for a description of the configuration fields.
             #
             # @yield [config] Configure the Client client.
@@ -131,13 +124,13 @@ module Google
             # To create a new Recommender client with the default
             # configuration:
             #
-            #     client = Google::Cloud::Recommender::V1::Recommender::Client.new
+            #     client = ::Google::Cloud::Recommender::V1::Recommender::Client.new
             #
             # To create a new Recommender client with a custom
             # configuration:
             #
-            #     client = Google::Cloud::Recommender::V1::Recommender::Client.new do |config|
-            #       config.timeout = 10_000
+            #     client = ::Google::Cloud::Recommender::V1::Recommender::Client.new do |config|
+            #       config.timeout = 10.0
             #     end
             #
             # @yield [config] Configure the Recommender client.
@@ -162,10 +155,11 @@ module Google
               if credentials.is_a?(String) || credentials.is_a?(Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
-              @quota_project_id = credentials.respond_to?(:quota_project_id) ? credentials.quota_project_id : nil
+              @quota_project_id = @config.quota_project
+              @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
 
-              @recommender_stub = Gapic::ServiceStub.new(
-                Google::Cloud::Recommender::V1::Recommender::Stub,
+              @recommender_stub = ::Gapic::ServiceStub.new(
+                ::Google::Cloud::Recommender::V1::Recommender::Stub,
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
@@ -180,14 +174,21 @@ module Google
             # IAM permission for the specified recommender.
             #
             # @overload list_recommendations(request, options = nil)
-            #   @param request [Google::Cloud::Recommender::V1::ListRecommendationsRequest | Hash]
-            #     Lists recommendations for a Cloud project. Requires the recommender.*.list
-            #     IAM permission for the specified recommender.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `list_recommendations` via a request object, either of type
+            #   {::Google::Cloud::Recommender::V1::ListRecommendationsRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Recommender::V1::ListRecommendationsRequest, ::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 list_recommendations(parent: nil, page_size: nil, page_token: nil, filter: nil)
-            #   @param parent [String]
+            #   Pass arguments to `list_recommendations` 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 parent [::String]
             #     Required. The container resource on which to execute the request.
             #     Acceptable formats:
             #
@@ -196,42 +197,41 @@ module Google
             #
             #     LOCATION here refers to GCP Locations:
             #     https://cloud.google.com/about/locations/
-            #   @param page_size [Integer]
+            #   @param page_size [::Integer]
             #     Optional. The maximum number of results to return from this request.  Non-positive
             #     values are ignored. If not specified, the server will determine the number
             #     of results to return.
-            #   @param page_token [String]
+            #   @param page_token [::String]
             #     Optional. If present, retrieves the next batch of results from the preceding call to
             #     this method. `page_token` must be the value of `next_page_token` from the
             #     previous response. The values of other method parameters must be identical
             #     to those in the previous call.
-            #   @param filter [String]
+            #   @param filter [::String]
             #     Filter expression to restrict the recommendations returned. Supported
             #     filter fields: state_info.state
             #     Eg: `state_info.state:"DISMISSED" or state_info.state:"FAILED"
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Recommender::V1::Recommendation>]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Recommender::V1::Recommendation>]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Gapic::PagedEnumerable<Google::Cloud::Recommender::V1::Recommendation>]
+            # @return [::Gapic::PagedEnumerable<::Google::Cloud::Recommender::V1::Recommendation>]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def list_recommendations request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Recommender::V1::ListRecommendationsRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Recommender::V1::ListRecommendationsRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.list_recommendations.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 \
+              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::Recommender::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -249,12 +249,12 @@ module Google
                                      retry_policy: @config.retry_policy
 
               @recommender_stub.call_rpc :list_recommendations, request, options: options do |response, operation|
-                response = Gapic::PagedEnumerable.new @recommender_stub, :list_recommendations, request, response, operation, options
+                response = ::Gapic::PagedEnumerable.new @recommender_stub, :list_recommendations, request, response, operation, options
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
@@ -262,38 +262,44 @@ module Google
             # IAM permission for the specified recommender.
             #
             # @overload get_recommendation(request, options = nil)
-            #   @param request [Google::Cloud::Recommender::V1::GetRecommendationRequest | Hash]
-            #     Gets the requested recommendation. Requires the recommender.*.get
-            #     IAM permission for the specified recommender.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `get_recommendation` via a request object, either of type
+            #   {::Google::Cloud::Recommender::V1::GetRecommendationRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Recommender::V1::GetRecommendationRequest, ::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_recommendation(name: nil)
-            #   @param name [String]
-            #     Required. Name of the recommendation.
+            #   Pass arguments to `get_recommendation` 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 name [::String]
+            #     Required. Name of the recommendation.
             #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Google::Cloud::Recommender::V1::Recommendation]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Google::Cloud::Recommender::V1::Recommendation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Google::Cloud::Recommender::V1::Recommendation]
+            # @return [::Google::Cloud::Recommender::V1::Recommendation]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def get_recommendation request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Recommender::V1::GetRecommendationRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Recommender::V1::GetRecommendationRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.get_recommendation.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 \
+              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::Recommender::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -314,8 +320,8 @@ module Google
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
@@ -331,53 +337,51 @@ module Google
             # recommender.
             #
             # @overload mark_recommendation_claimed(request, options = nil)
-            #   @param request [Google::Cloud::Recommender::V1::MarkRecommendationClaimedRequest | Hash]
-            #     Mark the Recommendation State as Claimed. Users can use this method to
-            #     indicate to the Recommender API that they are starting to apply the
-            #     recommendation themselves. This stops the recommendation content from being
-            #     updated.
-            #
-            #     MarkRecommendationClaimed can be applied to recommendations in CLAIMED,
-            #     SUCCEEDED, FAILED, or ACTIVE state.
-            #
-            #     Requires the recommender.*.update IAM permission for the specified
-            #     recommender.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `mark_recommendation_claimed` via a request object, either of type
+            #   {::Google::Cloud::Recommender::V1::MarkRecommendationClaimedRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Recommender::V1::MarkRecommendationClaimedRequest, ::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 mark_recommendation_claimed(name: nil, state_metadata: nil, etag: nil)
-            #   @param name [String]
+            #   Pass arguments to `mark_recommendation_claimed` 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 name [::String]
             #     Required. Name of the recommendation.
-            #   @param state_metadata [Hash{String => String}]
+            #   @param state_metadata [::Hash{::String => ::String}]
             #     State properties to include with this state. Overwrites any existing
             #     `state_metadata`.
             #     Keys must match the regex /^[a-z0-9][a-z0-9_.-]\\{0,62}$/.
             #     Values must match the regex /^[a-zA-Z0-9_./-]\\{0,255}$/.
-            #   @param etag [String]
+            #   @param etag [::String]
             #     Required. Fingerprint of the Recommendation. Provides optimistic locking.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Google::Cloud::Recommender::V1::Recommendation]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Google::Cloud::Recommender::V1::Recommendation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Google::Cloud::Recommender::V1::Recommendation]
+            # @return [::Google::Cloud::Recommender::V1::Recommendation]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def mark_recommendation_claimed request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Recommender::V1::MarkRecommendationClaimedRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Recommender::V1::MarkRecommendationClaimedRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.mark_recommendation_claimed.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 \
+              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::Recommender::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -398,8 +402,8 @@ module Google
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
@@ -415,53 +419,51 @@ module Google
             # recommender.
             #
             # @overload mark_recommendation_succeeded(request, options = nil)
-            #   @param request [Google::Cloud::Recommender::V1::MarkRecommendationSucceededRequest | Hash]
-            #     Mark the Recommendation State as Succeeded. Users can use this method to
-            #     indicate to the Recommender API that they have applied the recommendation
-            #     themselves, and the operation was successful. This stops the recommendation
-            #     content from being updated.
-            #
-            #     MarkRecommendationSucceeded can be applied to recommendations in ACTIVE,
-            #     CLAIMED, SUCCEEDED, or FAILED state.
-            #
-            #     Requires the recommender.*.update IAM permission for the specified
-            #     recommender.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `mark_recommendation_succeeded` via a request object, either of type
+            #   {::Google::Cloud::Recommender::V1::MarkRecommendationSucceededRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Recommender::V1::MarkRecommendationSucceededRequest, ::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 mark_recommendation_succeeded(name: nil, state_metadata: nil, etag: nil)
-            #   @param name [String]
+            #   Pass arguments to `mark_recommendation_succeeded` 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 name [::String]
             #     Required. Name of the recommendation.
-            #   @param state_metadata [Hash{String => String}]
+            #   @param state_metadata [::Hash{::String => ::String}]
             #     State properties to include with this state. Overwrites any existing
             #     `state_metadata`.
             #     Keys must match the regex /^[a-z0-9][a-z0-9_.-]\\{0,62}$/.
             #     Values must match the regex /^[a-zA-Z0-9_./-]\\{0,255}$/.
-            #   @param etag [String]
+            #   @param etag [::String]
             #     Required. Fingerprint of the Recommendation. Provides optimistic locking.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Google::Cloud::Recommender::V1::Recommendation]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Google::Cloud::Recommender::V1::Recommendation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Google::Cloud::Recommender::V1::Recommendation]
+            # @return [::Google::Cloud::Recommender::V1::Recommendation]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def mark_recommendation_succeeded request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Recommender::V1::MarkRecommendationSucceededRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Recommender::V1::MarkRecommendationSucceededRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.mark_recommendation_succeeded.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 \
+              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::Recommender::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -482,8 +484,8 @@ module Google
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
@@ -499,53 +501,51 @@ module Google
             # recommender.
             #
             # @overload mark_recommendation_failed(request, options = nil)
-            #   @param request [Google::Cloud::Recommender::V1::MarkRecommendationFailedRequest | Hash]
-            #     Mark the Recommendation State as Failed. Users can use this method to
-            #     indicate to the Recommender API that they have applied the recommendation
-            #     themselves, and the operation failed. This stops the recommendation content
-            #     from being updated.
-            #
-            #     MarkRecommendationFailed can be applied to recommendations in ACTIVE,
-            #     CLAIMED, SUCCEEDED, or FAILED state.
-            #
-            #     Requires the recommender.*.update IAM permission for the specified
-            #     recommender.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `mark_recommendation_failed` via a request object, either of type
+            #   {::Google::Cloud::Recommender::V1::MarkRecommendationFailedRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Recommender::V1::MarkRecommendationFailedRequest, ::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 mark_recommendation_failed(name: nil, state_metadata: nil, etag: nil)
-            #   @param name [String]
+            #   Pass arguments to `mark_recommendation_failed` 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 name [::String]
             #     Required. Name of the recommendation.
-            #   @param state_metadata [Hash{String => String}]
+            #   @param state_metadata [::Hash{::String => ::String}]
             #     State properties to include with this state. Overwrites any existing
             #     `state_metadata`.
             #     Keys must match the regex /^[a-z0-9][a-z0-9_.-]\\{0,62}$/.
             #     Values must match the regex /^[a-zA-Z0-9_./-]\\{0,255}$/.
-            #   @param etag [String]
+            #   @param etag [::String]
             #     Required. Fingerprint of the Recommendation. Provides optimistic locking.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Google::Cloud::Recommender::V1::Recommendation]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Google::Cloud::Recommender::V1::Recommendation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Google::Cloud::Recommender::V1::Recommendation]
+            # @return [::Google::Cloud::Recommender::V1::Recommendation]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def mark_recommendation_failed request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Recommender::V1::MarkRecommendationFailedRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Recommender::V1::MarkRecommendationFailedRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.mark_recommendation_failed.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 \
+              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::Recommender::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -566,8 +566,8 @@ module Google
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
@@ -577,7 +577,7 @@ module Google
             # providing control over timeouts, retry behavior, logging, transport
             # parameters, and other low-level controls. Certain parameters can also be
             # applied individually to specific RPCs. See
-            # {Google::Cloud::Recommender::V1::Recommender::Client::Configuration::Rpcs}
+            # {::Google::Cloud::Recommender::V1::Recommender::Client::Configuration::Rpcs}
             # for a list of RPCs that can be configured independently.
             #
             # Configuration can be applied globally to all clients, or to a single client
@@ -588,22 +588,22 @@ module Google
             # To modify the global config, setting the timeout for list_recommendations
             # to 20 seconds, and all remaining timeouts to 10 seconds:
             #
-            #     Google::Cloud::Recommender::V1::Recommender::Client.configure do |config|
-            #       config.timeout = 10_000
-            #       config.rpcs.list_recommendations.timeout = 20_000
+            #     ::Google::Cloud::Recommender::V1::Recommender::Client.configure do |config|
+            #       config.timeout = 10.0
+            #       config.rpcs.list_recommendations.timeout = 20.0
             #     end
             #
             # To apply the above configuration only to a new client:
             #
-            #     client = Google::Cloud::Recommender::V1::Recommender::Client.new do |config|
-            #       config.timeout = 10_000
-            #       config.rpcs.list_recommendations.timeout = 20_000
+            #     client = ::Google::Cloud::Recommender::V1::Recommender::Client.new do |config|
+            #       config.timeout = 10.0
+            #       config.rpcs.list_recommendations.timeout = 20.0
             #     end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.
             #   Defaults to `"recommender.googleapis.com"`.
-            #   @return [String]
+            #   @return [::String]
             # @!attribute [rw] credentials
             #   Credentials to send with calls. You may provide any of the following types:
             #    *  (`String`) The path to a service account key file in JSON format
@@ -615,29 +615,29 @@ module Google
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
-            #   @return [Object]
+            #   @return [::Object]
             # @!attribute [rw] scope
             #   The OAuth scopes
-            #   @return [Array<String>]
+            #   @return [::Array<::String>]
             # @!attribute [rw] lib_name
             #   The library name as recorded in instrumentation and logging
-            #   @return [String]
+            #   @return [::String]
             # @!attribute [rw] lib_version
             #   The library version as recorded in instrumentation and logging
-            #   @return [String]
+            #   @return [::String]
             # @!attribute [rw] channel_args
             #   Extra parameters passed to the gRPC channel. Note: this is ignored if a
             #   `GRPC::Core::Channel` object is provided as the credential.
-            #   @return [Hash]
+            #   @return [::Hash]
             # @!attribute [rw] interceptors
             #   An array of interceptors that are run before calls are executed.
-            #   @return [Array<GRPC::ClientInterceptor>]
+            #   @return [::Array<::GRPC::ClientInterceptor>]
             # @!attribute [rw] timeout
-            #   The call timeout in milliseconds.
-            #   @return [Numeric]
+            #   The call timeout in seconds.
+            #   @return [::Numeric]
             # @!attribute [rw] metadata
             #   Additional gRPC headers to be sent with the call.
-            #   @return [Hash{Symbol=>String}]
+            #   @return [::Hash{::Symbol=>::String}]
             # @!attribute [rw] retry_policy
             #   The retry policy. The value is a hash with the following keys:
             #    *  `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
@@ -645,25 +645,29 @@ module Google
             #    *  `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
             #    *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
             #       trigger a retry.
-            #   @return [Hash]
+            #   @return [::Hash]
+            # @!attribute [rw] quota_project
+            #   A separate project against which to charge quota.
+            #   @return [::String]
             #
             class Configuration
-              extend Gapic::Config
+              extend ::Gapic::Config
 
-              config_attr :endpoint,     "recommender.googleapis.com", String
-              config_attr :credentials,  nil do |value|
+              config_attr :endpoint,      "recommender.googleapis.com", ::String
+              config_attr :credentials,   nil do |value|
                 allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
-              config_attr :scope,        nil, String, Array, nil
-              config_attr :lib_name,     nil, String, nil
-              config_attr :lib_version,  nil, String, nil
-              config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, Hash, nil)
-              config_attr :interceptors, nil, Array, nil
-              config_attr :timeout,      nil, Numeric, nil
-              config_attr :metadata,     nil, Hash, nil
-              config_attr :retry_policy, nil, Hash, Proc, nil
+              config_attr :scope,         nil, ::String, ::Array, nil
+              config_attr :lib_name,      nil, ::String, nil
+              config_attr :lib_version,   nil, ::String, nil
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr :interceptors,  nil, ::Array, nil
+              config_attr :timeout,       nil, ::Numeric, nil
+              config_attr :metadata,      nil, ::Hash, nil
+              config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
+              config_attr :quota_project, nil, ::String, nil
 
               # @private
               def initialize parent_config = nil
@@ -679,7 +683,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if @parent_config&.respond_to? :rpcs
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -704,42 +708,42 @@ module Google
               class Rpcs
                 ##
                 # RPC-specific configuration for `list_recommendations`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :list_recommendations
                 ##
                 # RPC-specific configuration for `get_recommendation`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :get_recommendation
                 ##
                 # RPC-specific configuration for `mark_recommendation_claimed`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :mark_recommendation_claimed
                 ##
                 # RPC-specific configuration for `mark_recommendation_succeeded`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :mark_recommendation_succeeded
                 ##
                 # RPC-specific configuration for `mark_recommendation_failed`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :mark_recommendation_failed
 
                 # @private
                 def initialize parent_rpcs = nil
                   list_recommendations_config = parent_rpcs&.list_recommendations if parent_rpcs&.respond_to? :list_recommendations
-                  @list_recommendations = Gapic::Config::Method.new list_recommendations_config
+                  @list_recommendations = ::Gapic::Config::Method.new list_recommendations_config
                   get_recommendation_config = parent_rpcs&.get_recommendation if parent_rpcs&.respond_to? :get_recommendation
-                  @get_recommendation = Gapic::Config::Method.new get_recommendation_config
+                  @get_recommendation = ::Gapic::Config::Method.new get_recommendation_config
                   mark_recommendation_claimed_config = parent_rpcs&.mark_recommendation_claimed if parent_rpcs&.respond_to? :mark_recommendation_claimed
-                  @mark_recommendation_claimed = Gapic::Config::Method.new mark_recommendation_claimed_config
+                  @mark_recommendation_claimed = ::Gapic::Config::Method.new mark_recommendation_claimed_config
                   mark_recommendation_succeeded_config = parent_rpcs&.mark_recommendation_succeeded if parent_rpcs&.respond_to? :mark_recommendation_succeeded
-                  @mark_recommendation_succeeded = Gapic::Config::Method.new mark_recommendation_succeeded_config
+                  @mark_recommendation_succeeded = ::Gapic::Config::Method.new mark_recommendation_succeeded_config
                   mark_recommendation_failed_config = parent_rpcs&.mark_recommendation_failed if parent_rpcs&.respond_to? :mark_recommendation_failed
-                  @mark_recommendation_failed = Gapic::Config::Method.new mark_recommendation_failed_config
+                  @mark_recommendation_failed = ::Gapic::Config::Method.new mark_recommendation_failed_config
 
                   yield self if block_given?
                 end
@@ -751,13 +755,3 @@ module Google
     end
   end
 end
-
-# rubocop:disable Lint/HandleExceptions
-
-# Once client is loaded, load helpers.rb if it exists.
-begin
-  require "google/cloud/recommender/v1/recommender/helpers"
-rescue LoadError
-end
-
-# rubocop:enable Lint/HandleExceptions