google-ads-googleads 13.0.0 → 14.0.0

data/lib/google/ads/google_ads/v8/services/shared_set_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/shopping_performance_view_service/client.rb

@@ -42,13 +42,12 @@ module Google
               # See {::Google::Ads::GoogleAds::V8::Services::ShoppingPerformanceViewService::Client::Configuration}
               # for a description of the configuration fields.
               #
-              # ## Example
+              # @example
               #
-              # To modify the configuration for all ShoppingPerformanceViewService clients:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::ShoppingPerformanceViewService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Modify the configuration for all ShoppingPerformanceViewService clients
+              #   ::Google::Ads::GoogleAds::V8::Services::ShoppingPerformanceViewService::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 ShoppingPerformanceViewService client object.
               #
-              # ## Examples
-              #
-              # To create a new ShoppingPerformanceViewService client with the default
-              # configuration:
+              # @example
               #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::ShoppingPerformanceViewService::Client.new
+              #   # Create a client using the default configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::ShoppingPerformanceViewService::Client.new
               #
-              # To create a new ShoppingPerformanceViewService client with a custom
-              # configuration:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::ShoppingPerformanceViewService::Client.new do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Create a client using a custom configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::ShoppingPerformanceViewService::Client.new do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the ShoppingPerformanceViewService 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_shopping_performance_view.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_shopping_performance_view.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @shopping_performance_view_service_stub.call_rpc :get_shopping_performance_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_shopping_performance_view
-              # to 20 seconds, and all remaining timeouts to 10 seconds:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::ShoppingPerformanceViewService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.get_shopping_performance_view.timeout = 20.0
-              #     end
-              #
-              # To apply the above configuration only to a new client:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::ShoppingPerformanceViewService::Client.new do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.get_shopping_performance_view.timeout = 20.0
-              #     end
+              # @example
+              #
+              #   # Modify the global config, setting the timeout for
+              #   # get_shopping_performance_view to 20 seconds,
+              #   # and all remaining timeouts to 10 seconds.
+              #   ::Google::Ads::GoogleAds::V8::Services::ShoppingPerformanceViewService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.get_shopping_performance_view.timeout = 20.0
+              #   end
+              #
+              #   # Apply the above configuration only to a new client.
+              #   client = ::Google::Ads::GoogleAds::V8::Services::ShoppingPerformanceViewService::Client.new do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.get_shopping_performance_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/shopping_performance_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/smart_campaign_search_term_view_service/client.rb

@@ -42,13 +42,12 @@ module Google
               # See {::Google::Ads::GoogleAds::V8::Services::SmartCampaignSearchTermViewService::Client::Configuration}
               # for a description of the configuration fields.
               #
-              # ## Example
+              # @example
               #
-              # To modify the configuration for all SmartCampaignSearchTermViewService clients:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSearchTermViewService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Modify the configuration for all SmartCampaignSearchTermViewService clients
+              #   ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSearchTermViewService::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 SmartCampaignSearchTermViewService client object.
               #
-              # ## Examples
-              #
-              # To create a new SmartCampaignSearchTermViewService client with the default
-              # configuration:
+              # @example
               #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSearchTermViewService::Client.new
+              #   # Create a client using the default configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSearchTermViewService::Client.new
               #
-              # To create a new SmartCampaignSearchTermViewService client with a custom
-              # configuration:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSearchTermViewService::Client.new do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Create a client using a custom configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSearchTermViewService::Client.new do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the SmartCampaignSearchTermViewService 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_smart_campaign_search_term_view.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_smart_campaign_search_term_view.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @smart_campaign_search_term_view_service_stub.call_rpc :get_smart_campaign_search_term_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_smart_campaign_search_term_view
-              # to 20 seconds, and all remaining timeouts to 10 seconds:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSearchTermViewService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.get_smart_campaign_search_term_view.timeout = 20.0
-              #     end
-              #
-              # To apply the above configuration only to a new client:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSearchTermViewService::Client.new do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.get_smart_campaign_search_term_view.timeout = 20.0
-              #     end
+              # @example
+              #
+              #   # Modify the global config, setting the timeout for
+              #   # get_smart_campaign_search_term_view to 20 seconds,
+              #   # and all remaining timeouts to 10 seconds.
+              #   ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSearchTermViewService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.get_smart_campaign_search_term_view.timeout = 20.0
+              #   end
+              #
+              #   # Apply the above configuration only to a new client.
+              #   client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSearchTermViewService::Client.new do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.get_smart_campaign_search_term_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/smart_campaign_search_term_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/smart_campaign_setting_service/client.rb

@@ -42,13 +42,12 @@ module Google
               # See {::Google::Ads::GoogleAds::V8::Services::SmartCampaignSettingService::Client::Configuration}
               # for a description of the configuration fields.
               #
-              # ## Example
+              # @example
               #
-              # To modify the configuration for all SmartCampaignSettingService clients:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSettingService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Modify the configuration for all SmartCampaignSettingService clients
+              #   ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSettingService::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 SmartCampaignSettingService client object.
               #
-              # ## Examples
-              #
-              # To create a new SmartCampaignSettingService client with the default
-              # configuration:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSettingService::Client.new
+              # @example
               #
-              # To create a new SmartCampaignSettingService client with a custom
-              # configuration:
+              #   # Create a client using the default configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSettingService::Client.new
               #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSettingService::Client.new do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Create a client using a custom configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSettingService::Client.new do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the SmartCampaignSettingService 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
@@ -208,7 +199,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.get_smart_campaign_setting.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_smart_campaign_setting.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @smart_campaign_setting_service_stub.call_rpc :get_smart_campaign_setting, request,
@@ -289,7 +282,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.mutate_smart_campaign_settings.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.mutate_smart_campaign_settings.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @smart_campaign_setting_service_stub.call_rpc :mutate_smart_campaign_settings, request,
@@ -314,22 +309,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_smart_campaign_setting
-              # to 20 seconds, and all remaining timeouts to 10 seconds:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSettingService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.get_smart_campaign_setting.timeout = 20.0
-              #     end
-              #
-              # To apply the above configuration only to a new client:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSettingService::Client.new do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.get_smart_campaign_setting.timeout = 20.0
-              #     end
+              # @example
+              #
+              #   # Modify the global config, setting the timeout for
+              #   # get_smart_campaign_setting to 20 seconds,
+              #   # and all remaining timeouts to 10 seconds.
+              #   ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSettingService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.get_smart_campaign_setting.timeout = 20.0
+              #   end
+              #
+              #   # Apply the above configuration only to a new client.
+              #   client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSettingService::Client.new do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.get_smart_campaign_setting.timeout = 20.0
+              #   end
               #
               # @!attribute [rw] endpoint
               #   The hostname or hostname:port of the service endpoint.

data/lib/google/ads/google_ads/v8/services/smart_campaign_setting_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/smart_campaign_suggest_service/client.rb

@@ -42,13 +42,12 @@ module Google
               # See {::Google::Ads::GoogleAds::V8::Services::SmartCampaignSuggestService::Client::Configuration}
               # for a description of the configuration fields.
               #
-              # ## Example
+              # @example
               #
-              # To modify the configuration for all SmartCampaignSuggestService clients:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSuggestService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Modify the configuration for all SmartCampaignSuggestService clients
+              #   ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSuggestService::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 SmartCampaignSuggestService client object.
               #
-              # ## Examples
-              #
-              # To create a new SmartCampaignSuggestService client with the default
-              # configuration:
+              # @example
               #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSuggestService::Client.new
+              #   # Create a client using the default configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSuggestService::Client.new
               #
-              # To create a new SmartCampaignSuggestService client with a custom
-              # configuration:
-              #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSuggestService::Client.new do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Create a client using a custom configuration
+              #   client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSuggestService::Client.new do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the SmartCampaignSuggestService 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
@@ -212,7 +203,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.suggest_smart_campaign_budget_options.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.suggest_smart_campaign_budget_options.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @smart_campaign_suggest_service_stub.call_rpc :suggest_smart_campaign_budget_options, request,
@@ -224,6 +217,82 @@ module Google
                 #  raise Google::Ads::GoogleAds::Error.new grpc_error.message
               end
 
+              ##
+              # Suggests a Smart campaign ad compatible with the Ad family of resources,
+              # based on data points such as targeting and the business to advertise.
+              #
+              # @overload suggest_smart_campaign_ad(request, options = nil)
+              #   Pass arguments to `suggest_smart_campaign_ad` via a request object, either of type
+              #   {::Google::Ads::GoogleAds::V8::Services::SuggestSmartCampaignAdRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Ads::GoogleAds::V8::Services::SuggestSmartCampaignAdRequest, ::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 suggest_smart_campaign_ad(customer_id: nil, suggestion_info: nil)
+              #   Pass arguments to `suggest_smart_campaign_ad` 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 customer_id [::String]
+              #     Required. The ID of the customer.
+              #   @param suggestion_info [::Google::Ads::GoogleAds::V8::Services::SmartCampaignSuggestionInfo, ::Hash]
+              #     Required. Inputs used to suggest a Smart campaign ad.
+              #     Required fields: final_url, language_code, keyword_themes.
+              #     Optional but recommended fields to improve the quality of the suggestion:
+              #     business_setting and geo_target.
+              #
+              # @yield [response, operation] Access the result along with the RPC operation
+              # @yieldparam response [::Google::Ads::GoogleAds::V8::Services::SuggestSmartCampaignAdResponse]
+              # @yieldparam operation [::GRPC::ActiveCall::Operation]
+              #
+              # @return [::Google::Ads::GoogleAds::V8::Services::SuggestSmartCampaignAdResponse]
+              #
+              # @raise [Google::Ads::GoogleAds::Error] if the RPC is aborted.
+              #
+              def suggest_smart_campaign_ad request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request,
+                                                   to: ::Google::Ads::GoogleAds::V8::Services::SuggestSmartCampaignAdRequest
+
+                # 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.suggest_smart_campaign_ad.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::Ads::GoogleAds::VERSION
+                metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                header_params = {
+                  "customer_id" => request.customer_id
+                }
+                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.suggest_smart_campaign_ad.timeout,
+                                       metadata:     metadata,
+                                       retry_policy: @config.rpcs.suggest_smart_campaign_ad.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @smart_campaign_suggest_service_stub.call_rpc :suggest_smart_campaign_ad, request,
+                                                              options: options do |response, operation|
+                  yield response, operation if block_given?
+                  return response
+                end
+                # rescue GRPC::BadStatus => grpc_error
+                #  raise Google::Ads::GoogleAds::Error.new grpc_error.message
+              end
+
               ##
               # Configuration class for the SmartCampaignSuggestService API.
               #
@@ -237,22 +306,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 suggest_smart_campaign_budget_options
-              # to 20 seconds, and all remaining timeouts to 10 seconds:
-              #
-              #     ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSuggestService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.suggest_smart_campaign_budget_options.timeout = 20.0
-              #     end
+              # @example
               #
-              # To apply the above configuration only to a new client:
+              #   # Modify the global config, setting the timeout for
+              #   # suggest_smart_campaign_budget_options to 20 seconds,
+              #   # and all remaining timeouts to 10 seconds.
+              #   ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSuggestService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.suggest_smart_campaign_budget_options.timeout = 20.0
+              #   end
               #
-              #     client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSuggestService::Client.new do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.suggest_smart_campaign_budget_options.timeout = 20.0
-              #     end
+              #   # Apply the above configuration only to a new client.
+              #   client = ::Google::Ads::GoogleAds::V8::Services::SmartCampaignSuggestService::Client.new do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.suggest_smart_campaign_budget_options.timeout = 20.0
+              #   end
               #
               # @!attribute [rw] endpoint
               #   The hostname or hostname:port of the service endpoint.
@@ -366,11 +434,18 @@ module Google
                   # @return [::Gapic::Config::Method]
                   #
                   attr_reader :suggest_smart_campaign_budget_options
+                  ##
+                  # RPC-specific configuration for `suggest_smart_campaign_ad`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :suggest_smart_campaign_ad
 
                   # @private
                   def initialize parent_rpcs = nil
                     suggest_smart_campaign_budget_options_config = parent_rpcs.suggest_smart_campaign_budget_options if parent_rpcs.respond_to? :suggest_smart_campaign_budget_options
                     @suggest_smart_campaign_budget_options = ::Gapic::Config::Method.new suggest_smart_campaign_budget_options_config
+                    suggest_smart_campaign_ad_config = parent_rpcs.suggest_smart_campaign_ad if parent_rpcs.respond_to? :suggest_smart_campaign_ad
+                    @suggest_smart_campaign_ad = ::Gapic::Config::Method.new suggest_smart_campaign_ad_config
 
                     yield self if block_given?
                   end