google-ads-googleads 13.0.0 → 14.0.0

data/lib/google/ads/google_ads/v8/services/product_bidding_category_constant_service/credentials.rb

@@ -29,12 +29,6 @@ module Google
               self.scope = [
                 "https://www.googleapis.com/auth/adwords"
               ]
-              self.env_vars = [
-                "GOOGLEADS_CREDENTIALS",
-                "GOOGLEADS_KEYFILE",
-                "GOOGLEADS_CREDENTIALS_JSON",
-                "GOOGLEADS_KEYFILE_JSON"
-              ]
             end
           end
         end

data/lib/google/ads/google_ads/v8/services/product_group_view_service/client.rb

@@ -42,13 +42,12 @@ module Google
               # See {::Google::Ads::GoogleAds::V8::Services::ProductGroupViewService::Client::Configuration}
               # for a description of the configuration fields.
               #
-              # ## Example
+              # @example
               #
-              # To modify the configuration for all ProductGroupViewService clients:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::ProductGroupViewService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Modify the configuration for all ProductGroupViewService clients
+              #   ::Google::Ads::GoogleAds::V8::Services::ProductGroupViewService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the Client client.
               # @yieldparam config [Client::Configuration]
@@ -61,10 +60,7 @@ module Google
 
                   default_config.timeout = 3600.0
                   default_config.retry_policy = {
-                    initial_delay: 5.0,
-                    max_delay: 60.0,
-                    multiplier: 1.3,
-                    retry_codes: [14, 4]
+                    initial_delay: 5.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
                   }
 
                   default_config
@@ -96,19 +92,15 @@ module Google
               ##
               # Create a new ProductGroupViewService client object.
               #
-              # ## Examples
-              #
-              # To create a new ProductGroupViewService client with the default
-              # configuration:
+              # @example
               #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::ProductGroupViewService::Client.new
+              #   # Create a client using the default configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::ProductGroupViewService::Client.new
               #
-              # To create a new ProductGroupViewService client with a custom
-              # configuration:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::ProductGroupViewService::Client.new do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Create a client using a custom configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::ProductGroupViewService::Client.new do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the ProductGroupViewService client.
               # @yieldparam config [Client::Configuration]
@@ -128,14 +120,13 @@ 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
-                if credentials.is_a?(String) || credentials.is_a?(Hash)
+                if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                   credentials = Credentials.new credentials, scope: @config.scope
                 end
                 @quota_project_id = @config.quota_project
@@ -216,7 +207,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.get_product_group_view.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_product_group_view.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @product_group_view_service_stub.call_rpc :get_product_group_view, request,
@@ -241,22 +234,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 get_product_group_view
-              # to 20 seconds, and all remaining timeouts to 10 seconds:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::ProductGroupViewService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.get_product_group_view.timeout = 20.0
-              #     end
-              #
-              # To apply the above configuration only to a new client:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::ProductGroupViewService::Client.new do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.get_product_group_view.timeout = 20.0
-              #     end
+              # @example
+              #
+              #   # Modify the global config, setting the timeout for
+              #   # get_product_group_view to 20 seconds,
+              #   # and all remaining timeouts to 10 seconds.
+              #   ::Google::Ads::GoogleAds::V8::Services::ProductGroupViewService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.get_product_group_view.timeout = 20.0
+              #   end
+              #
+              #   # Apply the above configuration only to a new client.
+              #   client = ::Google::Ads::GoogleAds::V8::Services::ProductGroupViewService::Client.new do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.get_product_group_view.timeout = 20.0
+              #   end
               #
               # @!attribute [rw] endpoint
               #   The hostname or hostname:port of the service endpoint.

data/lib/google/ads/google_ads/v8/services/product_group_view_service/credentials.rb

@@ -29,12 +29,6 @@ module Google
               self.scope = [
                 "https://www.googleapis.com/auth/adwords"
               ]
-              self.env_vars = [
-                "GOOGLEADS_CREDENTIALS",
-                "GOOGLEADS_KEYFILE",
-                "GOOGLEADS_CREDENTIALS_JSON",
-                "GOOGLEADS_KEYFILE_JSON"
-              ]
             end
           end
         end

data/lib/google/ads/google_ads/v8/services/reach_plan_service/client.rb

@@ -44,13 +44,12 @@ module Google
               # See {::Google::Ads::GoogleAds::V8::Services::ReachPlanService::Client::Configuration}
               # for a description of the configuration fields.
               #
-              # ## Example
+              # @example
               #
-              # To modify the configuration for all ReachPlanService clients:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::ReachPlanService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Modify the configuration for all ReachPlanService clients
+              #   ::Google::Ads::GoogleAds::V8::Services::ReachPlanService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the Client client.
               # @yieldparam config [Client::Configuration]
@@ -63,10 +62,7 @@ module Google
 
                   default_config.timeout = 3600.0
                   default_config.retry_policy = {
-                    initial_delay: 5.0,
-                    max_delay: 60.0,
-                    multiplier: 1.3,
-                    retry_codes: [14, 4]
+                    initial_delay: 5.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
                   }
 
                   default_config
@@ -98,19 +94,15 @@ module Google
               ##
               # Create a new ReachPlanService client object.
               #
-              # ## Examples
-              #
-              # To create a new ReachPlanService client with the default
-              # configuration:
+              # @example
               #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::ReachPlanService::Client.new
+              #   # Create a client using the default configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::ReachPlanService::Client.new
               #
-              # To create a new ReachPlanService client with a custom
-              # configuration:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::ReachPlanService::Client.new do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Create a client using a custom configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::ReachPlanService::Client.new do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the ReachPlanService client.
               # @yieldparam config [Client::Configuration]
@@ -130,14 +122,13 @@ 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
-                if credentials.is_a?(String) || credentials.is_a?(Hash)
+                if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                   credentials = Credentials.new credentials, scope: @config.scope
                 end
                 @quota_project_id = @config.quota_project
@@ -204,7 +195,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.list_plannable_locations.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.list_plannable_locations.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @reach_plan_service_stub.call_rpc :list_plannable_locations, request,
@@ -276,7 +269,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.list_plannable_products.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.list_plannable_products.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @reach_plan_service_stub.call_rpc :list_plannable_products, request,
@@ -368,7 +363,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.generate_product_mix_ideas.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.generate_product_mix_ideas.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @reach_plan_service_stub.call_rpc :generate_product_mix_ideas, request,
@@ -404,7 +401,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
               #
-              # @overload generate_reach_forecast(customer_id: nil, currency_code: nil, campaign_duration: nil, cookie_frequency_cap: nil, cookie_frequency_cap_setting: nil, min_effective_frequency: nil, targeting: nil, planned_products: nil)
+              # @overload generate_reach_forecast(customer_id: nil, currency_code: nil, campaign_duration: nil, cookie_frequency_cap: nil, cookie_frequency_cap_setting: nil, min_effective_frequency: nil, effective_frequency_limit: nil, targeting: nil, planned_products: nil)
               #   Pass arguments to `generate_reach_forecast` 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).
@@ -438,6 +435,19 @@ module Google
               #     exposed to the ad) for the reported reach metrics [1-10].
               #     This won't affect the targeting, but just the reporting.
               #     If not specified, a default of 1 is applied.
+              #
+              #     This field cannot be combined with the effective_frequency_limit field.
+              #   @param effective_frequency_limit [::Google::Ads::GoogleAds::V8::Services::EffectiveFrequencyLimit, ::Hash]
+              #     The highest minimum effective frequency (the number of times a person was
+              #     exposed to the ad) value [1-10] to include in
+              #     Forecast.effective_frequency_breakdowns.
+              #     If not specified, Forecast.effective_frequency_breakdowns will not be
+              #     provided.
+              #
+              #     The effective frequency value provided here will also be used as the
+              #     minimum effective frequency for the reported reach metrics.
+              #
+              #     This field cannot be combined with the min_effective_frequency field.
               #   @param targeting [::Google::Ads::GoogleAds::V8::Services::Targeting, ::Hash]
               #     The targeting to be applied to all products selected in the product mix.
               #
@@ -484,7 +494,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.generate_reach_forecast.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.generate_reach_forecast.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @reach_plan_service_stub.call_rpc :generate_reach_forecast, request,
@@ -509,22 +521,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_plannable_locations
-              # to 20 seconds, and all remaining timeouts to 10 seconds:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::ReachPlanService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.list_plannable_locations.timeout = 20.0
-              #     end
-              #
-              # To apply the above configuration only to a new client:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::ReachPlanService::Client.new do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.list_plannable_locations.timeout = 20.0
-              #     end
+              # @example
+              #
+              #   # Modify the global config, setting the timeout for
+              #   # list_plannable_locations to 20 seconds,
+              #   # and all remaining timeouts to 10 seconds.
+              #   ::Google::Ads::GoogleAds::V8::Services::ReachPlanService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.list_plannable_locations.timeout = 20.0
+              #   end
+              #
+              #   # Apply the above configuration only to a new client.
+              #   client = ::Google::Ads::GoogleAds::V8::Services::ReachPlanService::Client.new do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.list_plannable_locations.timeout = 20.0
+              #   end
               #
               # @!attribute [rw] endpoint
               #   The hostname or hostname:port of the service endpoint.

data/lib/google/ads/google_ads/v8/services/reach_plan_service/credentials.rb

@@ -29,12 +29,6 @@ module Google
               self.scope = [
                 "https://www.googleapis.com/auth/adwords"
               ]
-              self.env_vars = [
-                "GOOGLEADS_CREDENTIALS",
-                "GOOGLEADS_KEYFILE",
-                "GOOGLEADS_CREDENTIALS_JSON",
-                "GOOGLEADS_KEYFILE_JSON"
-              ]
             end
           end
         end

data/lib/google/ads/google_ads/v8/services/reach_plan_service_pb.rb

@@ -68,9 +68,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       proto3_optional :cookie_frequency_cap, :int32, 10
       optional :cookie_frequency_cap_setting, :message, 8, "google.ads.googleads.v8.services.FrequencyCap"
       proto3_optional :min_effective_frequency, :int32, 11
+      proto3_optional :effective_frequency_limit, :message, 12, "google.ads.googleads.v8.services.EffectiveFrequencyLimit"
       optional :targeting, :message, 6, "google.ads.googleads.v8.services.Targeting"
       repeated :planned_products, :message, 7, "google.ads.googleads.v8.services.PlannedProduct"
     end
+    add_message "google.ads.googleads.v8.services.EffectiveFrequencyLimit" do
+      optional :effective_frequency_breakdown_limit, :int32, 1
+    end
     add_message "google.ads.googleads.v8.services.FrequencyCap" do
       optional :impressions, :int32, 3
       optional :time_unit, :enum, 2, "google.ads.googleads.v8.enums.FrequencyCapTimeUnitEnum.FrequencyCapTimeUnit"
@@ -107,6 +111,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       proto3_optional :on_target_impressions, :int64, 7
       proto3_optional :total_impressions, :int64, 8
       proto3_optional :viewable_impressions, :int64, 9
+      repeated :effective_frequency_breakdowns, :message, 10, "google.ads.googleads.v8.services.EffectiveFrequencyBreakdown"
     end
     add_message "google.ads.googleads.v8.services.PlannedProductReachForecast" do
       optional :plannable_product_code, :string, 1
@@ -124,6 +129,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       proto3_optional :youtube_audience_size, :int64, 3
       proto3_optional :census_audience_size, :int64, 4
     end
+    add_message "google.ads.googleads.v8.services.EffectiveFrequencyBreakdown" do
+      optional :effective_frequency, :int32, 1
+      optional :on_target_reach, :int64, 2
+      optional :total_reach, :int64, 3
+    end
   end
 end
 
@@ -144,6 +154,7 @@ module Google
           GenerateProductMixIdeasResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v8.services.GenerateProductMixIdeasResponse").msgclass
           ProductAllocation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v8.services.ProductAllocation").msgclass
           GenerateReachForecastRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v8.services.GenerateReachForecastRequest").msgclass
+          EffectiveFrequencyLimit = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v8.services.EffectiveFrequencyLimit").msgclass
           FrequencyCap = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v8.services.FrequencyCap").msgclass
           Targeting = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v8.services.Targeting").msgclass
           CampaignDuration = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v8.services.CampaignDuration").msgclass
@@ -155,6 +166,7 @@ module Google
           PlannedProductReachForecast = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v8.services.PlannedProductReachForecast").msgclass
           PlannedProductForecast = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v8.services.PlannedProductForecast").msgclass
           OnTargetAudienceMetrics = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v8.services.OnTargetAudienceMetrics").msgclass
+          EffectiveFrequencyBreakdown = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v8.services.EffectiveFrequencyBreakdown").msgclass
         end
       end
     end

data/lib/google/ads/google_ads/v8/services/recommendation_service/client.rb

@@ -42,13 +42,12 @@ module Google
               # See {::Google::Ads::GoogleAds::V8::Services::RecommendationService::Client::Configuration}
               # for a description of the configuration fields.
               #
-              # ## Example
+              # @example
               #
-              # To modify the configuration for all RecommendationService clients:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::RecommendationService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Modify the configuration for all RecommendationService clients
+              #   ::Google::Ads::GoogleAds::V8::Services::RecommendationService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the Client client.
               # @yieldparam config [Client::Configuration]
@@ -61,10 +60,7 @@ module Google
 
                   default_config.timeout = 3600.0
                   default_config.retry_policy = {
-                    initial_delay: 5.0,
-                    max_delay: 60.0,
-                    multiplier: 1.3,
-                    retry_codes: [14, 4]
+                    initial_delay: 5.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
                   }
 
                   default_config
@@ -96,19 +92,15 @@ module Google
               ##
               # Create a new RecommendationService client object.
               #
-              # ## Examples
-              #
-              # To create a new RecommendationService client with the default
-              # configuration:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::RecommendationService::Client.new
+              # @example
               #
-              # To create a new RecommendationService client with a custom
-              # configuration:
+              #   # Create a client using the default configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::RecommendationService::Client.new
               #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::RecommendationService::Client.new do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Create a client using a custom configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::RecommendationService::Client.new do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the RecommendationService client.
               # @yieldparam config [Client::Configuration]
@@ -128,14 +120,13 @@ 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
-                if credentials.is_a?(String) || credentials.is_a?(Hash)
+                if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                   credentials = Credentials.new credentials, scope: @config.scope
                 end
                 @quota_project_id = @config.quota_project
@@ -216,7 +207,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.get_recommendation.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_recommendation.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @recommendation_service_stub.call_rpc :get_recommendation, request,
@@ -306,7 +299,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.apply_recommendation.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.apply_recommendation.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @recommendation_service_stub.call_rpc :apply_recommendation, request,
@@ -392,7 +387,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.dismiss_recommendation.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.dismiss_recommendation.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @recommendation_service_stub.call_rpc :dismiss_recommendation, request,
@@ -417,22 +414,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 get_recommendation
-              # to 20 seconds, and all remaining timeouts to 10 seconds:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::RecommendationService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.get_recommendation.timeout = 20.0
-              #     end
-              #
-              # To apply the above configuration only to a new client:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::RecommendationService::Client.new do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.get_recommendation.timeout = 20.0
-              #     end
+              # @example
+              #
+              #   # Modify the global config, setting the timeout for
+              #   # get_recommendation to 20 seconds,
+              #   # and all remaining timeouts to 10 seconds.
+              #   ::Google::Ads::GoogleAds::V8::Services::RecommendationService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.get_recommendation.timeout = 20.0
+              #   end
+              #
+              #   # Apply the above configuration only to a new client.
+              #   client = ::Google::Ads::GoogleAds::V8::Services::RecommendationService::Client.new do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.get_recommendation.timeout = 20.0
+              #   end
               #
               # @!attribute [rw] endpoint
               #   The hostname or hostname:port of the service endpoint.