google-ads-googleads 1.1.1 → 2.0.0

data/lib/google/ads/google_ads/v1/services/google_ads_service_pb.rb

@@ -14,9 +14,12 @@ require 'google/ads/google_ads/v1/resources/ad_group_audience_view_pb'
 require 'google/ads/google_ads/v1/resources/ad_group_bid_modifier_pb'
 require 'google/ads/google_ads/v1/resources/ad_group_criterion_pb'
 require 'google/ads/google_ads/v1/resources/ad_group_criterion_label_pb'
+require 'google/ads/google_ads/v1/resources/ad_group_criterion_simulation_pb'
 require 'google/ads/google_ads/v1/resources/ad_group_extension_setting_pb'
 require 'google/ads/google_ads/v1/resources/ad_group_feed_pb'
 require 'google/ads/google_ads/v1/resources/ad_group_label_pb'
+require 'google/ads/google_ads/v1/resources/ad_group_simulation_pb'
+require 'google/ads/google_ads/v1/resources/ad_parameter_pb'
 require 'google/ads/google_ads/v1/resources/ad_schedule_view_pb'
 require 'google/ads/google_ads/v1/resources/age_range_view_pb'
 require 'google/ads/google_ads/v1/resources/asset_pb'
@@ -27,6 +30,7 @@ require 'google/ads/google_ads/v1/resources/campaign_audience_view_pb'
 require 'google/ads/google_ads/v1/resources/campaign_bid_modifier_pb'
 require 'google/ads/google_ads/v1/resources/campaign_budget_pb'
 require 'google/ads/google_ads/v1/resources/campaign_criterion_pb'
+require 'google/ads/google_ads/v1/resources/campaign_criterion_simulation_pb'
 require 'google/ads/google_ads/v1/resources/campaign_extension_setting_pb'
 require 'google/ads/google_ads/v1/resources/campaign_feed_pb'
 require 'google/ads/google_ads/v1/resources/campaign_label_pb'
@@ -48,6 +52,7 @@ require 'google/ads/google_ads/v1/resources/detail_placement_view_pb'
 require 'google/ads/google_ads/v1/resources/display_keyword_view_pb'
 require 'google/ads/google_ads/v1/resources/domain_category_pb'
 require 'google/ads/google_ads/v1/resources/dynamic_search_ads_search_term_view_pb'
+require 'google/ads/google_ads/v1/resources/expanded_landing_page_view_pb'
 require 'google/ads/google_ads/v1/resources/extension_feed_item_pb'
 require 'google/ads/google_ads/v1/resources/feed_pb'
 require 'google/ads/google_ads/v1/resources/feed_item_pb'
@@ -67,13 +72,16 @@ require 'google/ads/google_ads/v1/resources/keyword_plan_keyword_pb'
 require 'google/ads/google_ads/v1/resources/keyword_plan_negative_keyword_pb'
 require 'google/ads/google_ads/v1/resources/keyword_view_pb'
 require 'google/ads/google_ads/v1/resources/label_pb'
+require 'google/ads/google_ads/v1/resources/landing_page_view_pb'
 require 'google/ads/google_ads/v1/resources/language_constant_pb'
 require 'google/ads/google_ads/v1/resources/location_view_pb'
 require 'google/ads/google_ads/v1/resources/managed_placement_view_pb'
 require 'google/ads/google_ads/v1/resources/media_file_pb'
 require 'google/ads/google_ads/v1/resources/mobile_app_category_constant_pb'
 require 'google/ads/google_ads/v1/resources/mobile_device_constant_pb'
+require 'google/ads/google_ads/v1/resources/mutate_job_pb'
 require 'google/ads/google_ads/v1/resources/operating_system_version_constant_pb'
+require 'google/ads/google_ads/v1/resources/paid_organic_search_term_view_pb'
 require 'google/ads/google_ads/v1/resources/parental_status_view_pb'
 require 'google/ads/google_ads/v1/resources/product_bidding_category_constant_pb'
 require 'google/ads/google_ads/v1/resources/product_group_view_pb'
@@ -152,9 +160,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :ad_group_bid_modifier, :message, 24, "google.ads.googleads.v1.resources.AdGroupBidModifier"
     optional :ad_group_criterion, :message, 17, "google.ads.googleads.v1.resources.AdGroupCriterion"
     optional :ad_group_criterion_label, :message, 121, "google.ads.googleads.v1.resources.AdGroupCriterionLabel"
+    optional :ad_group_criterion_simulation, :message, 110, "google.ads.googleads.v1.resources.AdGroupCriterionSimulation"
     optional :ad_group_extension_setting, :message, 112, "google.ads.googleads.v1.resources.AdGroupExtensionSetting"
     optional :ad_group_feed, :message, 67, "google.ads.googleads.v1.resources.AdGroupFeed"
     optional :ad_group_label, :message, 115, "google.ads.googleads.v1.resources.AdGroupLabel"
+    optional :ad_group_simulation, :message, 107, "google.ads.googleads.v1.resources.AdGroupSimulation"
+    optional :ad_parameter, :message, 130, "google.ads.googleads.v1.resources.AdParameter"
     optional :age_range_view, :message, 48, "google.ads.googleads.v1.resources.AgeRangeView"
     optional :ad_schedule_view, :message, 89, "google.ads.googleads.v1.resources.AdScheduleView"
     optional :domain_category, :message, 91, "google.ads.googleads.v1.resources.DomainCategory"
@@ -166,6 +177,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :campaign_audience_view, :message, 69, "google.ads.googleads.v1.resources.CampaignAudienceView"
     optional :campaign_bid_modifier, :message, 26, "google.ads.googleads.v1.resources.CampaignBidModifier"
     optional :campaign_criterion, :message, 20, "google.ads.googleads.v1.resources.CampaignCriterion"
+    optional :campaign_criterion_simulation, :message, 111, "google.ads.googleads.v1.resources.CampaignCriterionSimulation"
     optional :campaign_extension_setting, :message, 113, "google.ads.googleads.v1.resources.CampaignExtensionSetting"
     optional :campaign_feed, :message, 63, "google.ads.googleads.v1.resources.CampaignFeed"
     optional :campaign_label, :message, 108, "google.ads.googleads.v1.resources.CampaignLabel"
@@ -186,6 +198,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :detail_placement_view, :message, 118, "google.ads.googleads.v1.resources.DetailPlacementView"
     optional :display_keyword_view, :message, 47, "google.ads.googleads.v1.resources.DisplayKeywordView"
     optional :dynamic_search_ads_search_term_view, :message, 106, "google.ads.googleads.v1.resources.DynamicSearchAdsSearchTermView"
+    optional :expanded_landing_page_view, :message, 128, "google.ads.googleads.v1.resources.ExpandedLandingPageView"
     optional :extension_feed_item, :message, 85, "google.ads.googleads.v1.resources.ExtensionFeedItem"
     optional :feed, :message, 46, "google.ads.googleads.v1.resources.Feed"
     optional :feed_item, :message, 50, "google.ads.googleads.v1.resources.FeedItem"
@@ -205,13 +218,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :keyword_plan_ad_group, :message, 35, "google.ads.googleads.v1.resources.KeywordPlanAdGroup"
     optional :keyword_plan_keyword, :message, 36, "google.ads.googleads.v1.resources.KeywordPlanKeyword"
     optional :label, :message, 52, "google.ads.googleads.v1.resources.Label"
+    optional :landing_page_view, :message, 126, "google.ads.googleads.v1.resources.LandingPageView"
     optional :language_constant, :message, 55, "google.ads.googleads.v1.resources.LanguageConstant"
     optional :location_view, :message, 123, "google.ads.googleads.v1.resources.LocationView"
     optional :managed_placement_view, :message, 53, "google.ads.googleads.v1.resources.ManagedPlacementView"
     optional :media_file, :message, 90, "google.ads.googleads.v1.resources.MediaFile"
     optional :mobile_app_category_constant, :message, 87, "google.ads.googleads.v1.resources.MobileAppCategoryConstant"
     optional :mobile_device_constant, :message, 98, "google.ads.googleads.v1.resources.MobileDeviceConstant"
+    optional :mutate_job, :message, 127, "google.ads.googleads.v1.resources.MutateJob"
     optional :operating_system_version_constant, :message, 86, "google.ads.googleads.v1.resources.OperatingSystemVersionConstant"
+    optional :paid_organic_search_term_view, :message, 129, "google.ads.googleads.v1.resources.PaidOrganicSearchTermView"
     optional :parental_status_view, :message, 45, "google.ads.googleads.v1.resources.ParentalStatusView"
     optional :product_bidding_category_constant, :message, 109, "google.ads.googleads.v1.resources.ProductBiddingCategoryConstant"
     optional :product_group_view, :message, 54, "google.ads.googleads.v1.resources.ProductGroupView"

data/lib/google/ads/google_ads/v1/services/google_ads_service_services_pb.rb

@@ -22,6 +22,8 @@ require 'google/ads/google_ads/v1/services/google_ads_service_pb'
 
 module Google::Ads::GoogleAds::V1::Services
   module GoogleAdsService
+    # Proto file describing the GoogleAdsService.
+    #
     # Service to fetch data and metrics across resources.
     class Service
 
@@ -33,7 +35,55 @@ module Google::Ads::GoogleAds::V1::Services
 
       # Returns all rows that match the search query.
       rpc :Search, SearchGoogleAdsRequest, SearchGoogleAdsResponse
-      # Creates, updates, or removes resources. Operation statuses are returned.
+      # Creates, updates, or removes resources. This method supports atomic
+      # transactions with multiple types of resources. For example, you can
+      # atomically create a campaign and a campaign budget, or perform up to
+      # thousands of mutates atomically.
+      #
+      # This method is essentially a wrapper around a series of mutate methods. The
+      # only features it offers over calling those methods directly are:
+      # - Atomic transactions
+      # - Temp resource names (described below)
+      # - Somewhat reduced latency over making a series of mutate calls.
+      #
+      # Note: Only resources that support atomic transactions are included, so this
+      # method can't replace all calls to individual services.
+      #
+      # ## Atomic Transaction Benefits
+      #
+      # Atomicity makes error handling much easier. If you're making a series of
+      # changes and one fails, it can leave your account in an inconsistent state.
+      # With atomicity, you either reach the desired state directly, or the request
+      # fails and you can retry.
+      #
+      # ## Temp Resource Names
+      #
+      # Temp resource names are a special type of resource name used to create a
+      # resource and reference that resource in the same request. For example, if a
+      # campaign budget is created with 'resource_name' equal to
+      # 'customers/123/campaignBudgets/-1', that resource name can be reused in
+      # the 'Campaign.budget' field in the same request. That way, the two
+      # resources are created and linked atomically.
+      #
+      # To create a temp resource name, put a negative number in the part of the
+      # name that the server would normally allocate.
+      #
+      # Note:
+      # - Resources must be created with a temp name before the name can be reused.
+      #   For example, the previous CampaignBudget+Campaign example would fail if
+      #   the mutate order was reversed.
+      # - Temp names are not remembered across requests.
+      # - There's no limit to the number of temp names in a request.
+      # - Each temp name must use a unique negative number, even if the resource
+      #   types differ.
+      #
+      # ## Latency
+      #
+      # It's important to group mutates by resource type or the request may time
+      # out and fail. Latency is roughly equal to a series of calls to individual
+      # mutate methods, where each change in resource type is a new call. For
+      # example, mutating 10 campaigns then 10 ad groups is like 2 calls, while
+      # mutating 1 campaign, 1 ad group, 1 campaign, 1 ad group is like 4 calls.
       rpc :Mutate, MutateGoogleAdsRequest, MutateGoogleAdsResponse
     end
 

data/lib/google/ads/google_ads/v1/services/group_placement_view_service_client.rb

@@ -199,9 +199,9 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   group_placement_view_service_client = Google::Ads::GoogleAds::GroupPlacementView.new(version: :v1)
+            #   group_placement_view_client = Google::Ads::GoogleAds::GroupPlacementView.new(version: :v1)
             #   formatted_resource_name = Google::Ads::GoogleAds::V1::Services::GroupPlacementViewServiceClient.group_placement_view_path("[CUSTOMER]", "[GROUP_PLACEMENT_VIEW]")
-            #   response = group_placement_view_service_client.get_group_placement_view(formatted_resource_name)
+            #   response = group_placement_view_client.get_group_placement_view(formatted_resource_name)
 
             def get_group_placement_view \
                 resource_name,

data/lib/google/ads/google_ads/v1/services/group_placement_view_service_services_pb.rb

@@ -22,6 +22,8 @@ require 'google/ads/google_ads/v1/services/group_placement_view_service_pb'
 
 module Google::Ads::GoogleAds::V1::Services
   module GroupPlacementViewService
+    # Proto file describing the Group Placement View service.
+    #
     # Service to fetch Group Placement views.
     class Service
 

data/lib/google/ads/google_ads/v1/services/hotel_group_view_service_client.rb

@@ -199,9 +199,9 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   hotel_group_view_service_client = Google::Ads::GoogleAds::HotelGroupView.new(version: :v1)
+            #   hotel_group_view_client = Google::Ads::GoogleAds::HotelGroupView.new(version: :v1)
             #   formatted_resource_name = Google::Ads::GoogleAds::V1::Services::HotelGroupViewServiceClient.hotel_group_view_path("[CUSTOMER]", "[HOTEL_GROUP_VIEW]")
-            #   response = hotel_group_view_service_client.get_hotel_group_view(formatted_resource_name)
+            #   response = hotel_group_view_client.get_hotel_group_view(formatted_resource_name)
 
             def get_hotel_group_view \
                 resource_name,

data/lib/google/ads/google_ads/v1/services/hotel_group_view_service_services_pb.rb

@@ -22,6 +22,8 @@ require 'google/ads/google_ads/v1/services/hotel_group_view_service_pb'
 
 module Google::Ads::GoogleAds::V1::Services
   module HotelGroupViewService
+    # Proto file describing the Hotel Group View Service.
+    #
     # Service to manage Hotel Group Views.
     class Service
 

data/lib/google/ads/google_ads/v1/services/hotel_performance_view_service_client.rb

@@ -62,12 +62,6 @@ module Google
 
             private_constant :HOTEL_PERFORMANCE_VIEW_PATH_TEMPLATE
 
-            CUSTOMER_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-              "customers/{customer}"
-            )
-
-            private_constant :CUSTOMER_PATH_TEMPLATE
-
             # Returns a fully-qualified hotel_performance_view resource name string.
             # @param customer [String]
             # @return [String]
@@ -77,15 +71,6 @@ module Google
               )
             end
 
-            # Returns a fully-qualified customer resource name string.
-            # @param customer [String]
-            # @return [String]
-            def self.customer_path customer
-              CUSTOMER_PATH_TEMPLATE.render(
-                :"customer" => customer
-              )
-            end
-
             # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
             #   Provides the means for authenticating requests made by the client. This parameter can
             #   be many types.
@@ -212,9 +197,9 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   hotel_performance_view_service_client = Google::Ads::GoogleAds::HotelPerformanceView.new(version: :v1)
-            #   formatted_resource_name = Google::Ads::GoogleAds::V1::Services::HotelPerformanceViewServiceClient.customer_path("[CUSTOMER]")
-            #   response = hotel_performance_view_service_client.get_hotel_performance_view(formatted_resource_name)
+            #   hotel_performance_view_client = Google::Ads::GoogleAds::HotelPerformanceView.new(version: :v1)
+            #   formatted_resource_name = Google::Ads::GoogleAds::V1::Services::HotelPerformanceViewServiceClient.hotel_performance_view_path("[CUSTOMER]")
+            #   response = hotel_performance_view_client.get_hotel_performance_view(formatted_resource_name)
 
             def get_hotel_performance_view \
                 resource_name,

data/lib/google/ads/google_ads/v1/services/hotel_performance_view_service_services_pb.rb

@@ -22,6 +22,8 @@ require 'google/ads/google_ads/v1/services/hotel_performance_view_service_pb'
 
 module Google::Ads::GoogleAds::V1::Services
   module HotelPerformanceViewService
+    # Proto file describing the Hotel Performance View Service.
+    #
     # Service to manage Hotel Performance Views.
     class Service
 

data/lib/google/ads/google_ads/v1/services/keyword_plan_ad_group_service_client.rb

@@ -204,9 +204,9 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_ad_group_service_client = Google::Ads::GoogleAds::KeywordPlanAdGroup.new(version: :v1)
+            #   keyword_plan_ad_group_client = Google::Ads::GoogleAds::KeywordPlanAdGroup.new(version: :v1)
             #   formatted_resource_name = Google::Ads::GoogleAds::V1::Services::KeywordPlanAdGroupServiceClient.keyword_plan_ad_group_path("[CUSTOMER]", "[KEYWORD_PLAN_AD_GROUP]")
-            #   response = keyword_plan_ad_group_service_client.get_keyword_plan_ad_group(formatted_resource_name)
+            #   response = keyword_plan_ad_group_client.get_keyword_plan_ad_group(formatted_resource_name)
 
             def get_keyword_plan_ad_group \
                 resource_name,
@@ -247,14 +247,14 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_ad_group_service_client = Google::Ads::GoogleAds::KeywordPlanAdGroup.new(version: :v1)
+            #   keyword_plan_ad_group_client = Google::Ads::GoogleAds::KeywordPlanAdGroup.new(version: :v1)
             #
             #   # TODO: Initialize `customer_id`:
             #   customer_id = ''
             #
             #   # TODO: Initialize `operations`:
             #   operations = []
-            #   response = keyword_plan_ad_group_service_client.mutate_keyword_plan_ad_groups(customer_id, operations)
+            #   response = keyword_plan_ad_group_client.mutate_keyword_plan_ad_groups(customer_id, operations)
 
             def mutate_keyword_plan_ad_groups \
                 customer_id,

data/lib/google/ads/google_ads/v1/services/keyword_plan_ad_group_service_services_pb.rb

@@ -22,6 +22,8 @@ require 'google/ads/google_ads/v1/services/keyword_plan_ad_group_service_pb'
 
 module Google::Ads::GoogleAds::V1::Services
   module KeywordPlanAdGroupService
+    # Proto file describing the keyword plan ad group service.
+    #
     # Service to manage Keyword Plan ad groups.
     class Service
 

data/lib/google/ads/google_ads/v1/services/keyword_plan_campaign_service_client.rb

@@ -204,9 +204,9 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_campaign_service_client = Google::Ads::GoogleAds::KeywordPlanCampaign.new(version: :v1)
+            #   keyword_plan_campaign_client = Google::Ads::GoogleAds::KeywordPlanCampaign.new(version: :v1)
             #   formatted_resource_name = Google::Ads::GoogleAds::V1::Services::KeywordPlanCampaignServiceClient.keyword_plan_campaign_path("[CUSTOMER]", "[KEYWORD_PLAN_CAMPAIGN]")
-            #   response = keyword_plan_campaign_service_client.get_keyword_plan_campaign(formatted_resource_name)
+            #   response = keyword_plan_campaign_client.get_keyword_plan_campaign(formatted_resource_name)
 
             def get_keyword_plan_campaign \
                 resource_name,
@@ -247,14 +247,14 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_campaign_service_client = Google::Ads::GoogleAds::KeywordPlanCampaign.new(version: :v1)
+            #   keyword_plan_campaign_client = Google::Ads::GoogleAds::KeywordPlanCampaign.new(version: :v1)
             #
             #   # TODO: Initialize `customer_id`:
             #   customer_id = ''
             #
             #   # TODO: Initialize `operations`:
             #   operations = []
-            #   response = keyword_plan_campaign_service_client.mutate_keyword_plan_campaigns(customer_id, operations)
+            #   response = keyword_plan_campaign_client.mutate_keyword_plan_campaigns(customer_id, operations)
 
             def mutate_keyword_plan_campaigns \
                 customer_id,

data/lib/google/ads/google_ads/v1/services/keyword_plan_campaign_service_services_pb.rb

@@ -22,6 +22,8 @@ require 'google/ads/google_ads/v1/services/keyword_plan_campaign_service_pb'
 
 module Google::Ads::GoogleAds::V1::Services
   module KeywordPlanCampaignService
+    # Proto file describing the keyword plan campaign service.
+    #
     # Service to manage Keyword Plan campaigns.
     class Service
 

data/lib/google/ads/google_ads/v1/services/keyword_plan_idea_service_client.rb

@@ -207,7 +207,7 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_idea_service_client = Google::Ads::GoogleAds::KeywordPlanIdea.new(version: :v1)
+            #   keyword_plan_idea_client = Google::Ads::GoogleAds::KeywordPlanIdea.new(version: :v1)
             #
             #   # TODO: Initialize `customer_id`:
             #   customer_id = ''
@@ -220,7 +220,7 @@ module Google
             #
             #   # TODO: Initialize `keyword_plan_network`:
             #   keyword_plan_network = :UNSPECIFIED
-            #   response = keyword_plan_idea_service_client.generate_keyword_ideas(customer_id, language, geo_target_constants, keyword_plan_network)
+            #   response = keyword_plan_idea_client.generate_keyword_ideas(customer_id, language, geo_target_constants, keyword_plan_network)
 
             def generate_keyword_ideas \
                 customer_id,

data/lib/google/ads/google_ads/v1/services/keyword_plan_idea_service_services_pb.rb

@@ -22,6 +22,8 @@ require 'google/ads/google_ads/v1/services/keyword_plan_idea_service_pb'
 
 module Google::Ads::GoogleAds::V1::Services
   module KeywordPlanIdeaService
+    # Proto file describing the keyword plan idea service.
+    #
     # Service to generate keyword ideas.
     class Service
 

data/lib/google/ads/google_ads/v1/services/keyword_plan_keyword_service_client.rb

@@ -204,9 +204,9 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_keyword_service_client = Google::Ads::GoogleAds::KeywordPlanKeyword.new(version: :v1)
+            #   keyword_plan_keyword_client = Google::Ads::GoogleAds::KeywordPlanKeyword.new(version: :v1)
             #   formatted_resource_name = Google::Ads::GoogleAds::V1::Services::KeywordPlanKeywordServiceClient.keyword_plan_keyword_path("[CUSTOMER]", "[KEYWORD_PLAN_KEYWORD]")
-            #   response = keyword_plan_keyword_service_client.get_keyword_plan_keyword(formatted_resource_name)
+            #   response = keyword_plan_keyword_client.get_keyword_plan_keyword(formatted_resource_name)
 
             def get_keyword_plan_keyword \
                 resource_name,
@@ -247,14 +247,14 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_keyword_service_client = Google::Ads::GoogleAds::KeywordPlanKeyword.new(version: :v1)
+            #   keyword_plan_keyword_client = Google::Ads::GoogleAds::KeywordPlanKeyword.new(version: :v1)
             #
             #   # TODO: Initialize `customer_id`:
             #   customer_id = ''
             #
             #   # TODO: Initialize `operations`:
             #   operations = []
-            #   response = keyword_plan_keyword_service_client.mutate_keyword_plan_keywords(customer_id, operations)
+            #   response = keyword_plan_keyword_client.mutate_keyword_plan_keywords(customer_id, operations)
 
             def mutate_keyword_plan_keywords \
                 customer_id,

data/lib/google/ads/google_ads/v1/services/keyword_plan_keyword_service_services_pb.rb

@@ -22,6 +22,8 @@ require 'google/ads/google_ads/v1/services/keyword_plan_keyword_service_pb'
 
 module Google::Ads::GoogleAds::V1::Services
   module KeywordPlanKeywordService
+    # Proto file describing the keyword plan keyword service.
+    #
     # Service to manage Keyword Plan ad group keywords.
     class Service
 

data/lib/google/ads/google_ads/v1/services/keyword_plan_negative_keyword_service_client.rb

@@ -204,9 +204,9 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_negative_keyword_service_client = Google::Ads::GoogleAds::KeywordPlanNegativeKeyword.new(version: :v1)
+            #   keyword_plan_negative_keyword_client = Google::Ads::GoogleAds::KeywordPlanNegativeKeyword.new(version: :v1)
             #   formatted_resource_name = Google::Ads::GoogleAds::V1::Services::KeywordPlanNegativeKeywordServiceClient.keyword_plan_negative_keyword_path("[CUSTOMER]", "[KEYWORD_PLAN_NEGATIVE_KEYWORD]")
-            #   response = keyword_plan_negative_keyword_service_client.get_keyword_plan_negative_keyword(formatted_resource_name)
+            #   response = keyword_plan_negative_keyword_client.get_keyword_plan_negative_keyword(formatted_resource_name)
 
             def get_keyword_plan_negative_keyword \
                 resource_name,
@@ -248,14 +248,14 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_negative_keyword_service_client = Google::Ads::GoogleAds::KeywordPlanNegativeKeyword.new(version: :v1)
+            #   keyword_plan_negative_keyword_client = Google::Ads::GoogleAds::KeywordPlanNegativeKeyword.new(version: :v1)
             #
             #   # TODO: Initialize `customer_id`:
             #   customer_id = ''
             #
             #   # TODO: Initialize `operations`:
             #   operations = []
-            #   response = keyword_plan_negative_keyword_service_client.mutate_keyword_plan_negative_keywords(customer_id, operations)
+            #   response = keyword_plan_negative_keyword_client.mutate_keyword_plan_negative_keywords(customer_id, operations)
 
             def mutate_keyword_plan_negative_keywords \
                 customer_id,

data/lib/google/ads/google_ads/v1/services/keyword_plan_negative_keyword_service_services_pb.rb

@@ -22,6 +22,8 @@ require 'google/ads/google_ads/v1/services/keyword_plan_negative_keyword_service
 
 module Google::Ads::GoogleAds::V1::Services
   module KeywordPlanNegativeKeywordService
+    # Proto file describing the keyword plan negative keyword service.
+    #
     # Service to manage Keyword Plan negative keywords.
     class Service
 

data/lib/google/ads/google_ads/v1/services/keyword_plan_service_client.rb

@@ -214,9 +214,9 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_service_client = Google::Ads::GoogleAds::KeywordPlan.new(version: :v1)
+            #   keyword_plan_client = Google::Ads::GoogleAds::KeywordPlan.new(version: :v1)
             #   formatted_resource_name = Google::Ads::GoogleAds::V1::Services::KeywordPlanServiceClient.keyword_plan_path("[CUSTOMER]", "[KEYWORD_PLAN]")
-            #   response = keyword_plan_service_client.get_keyword_plan(formatted_resource_name)
+            #   response = keyword_plan_client.get_keyword_plan(formatted_resource_name)
 
             def get_keyword_plan \
                 resource_name,
@@ -257,14 +257,14 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_service_client = Google::Ads::GoogleAds::KeywordPlan.new(version: :v1)
+            #   keyword_plan_client = Google::Ads::GoogleAds::KeywordPlan.new(version: :v1)
             #
             #   # TODO: Initialize `customer_id`:
             #   customer_id = ''
             #
             #   # TODO: Initialize `operations`:
             #   operations = []
-            #   response = keyword_plan_service_client.mutate_keyword_plans(customer_id, operations)
+            #   response = keyword_plan_client.mutate_keyword_plans(customer_id, operations)
 
             def mutate_keyword_plans \
                 customer_id,
@@ -298,9 +298,9 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_service_client = Google::Ads::GoogleAds::KeywordPlan.new(version: :v1)
+            #   keyword_plan_client = Google::Ads::GoogleAds::KeywordPlan.new(version: :v1)
             #   formatted_keyword_plan = Google::Ads::GoogleAds::V1::Services::KeywordPlanServiceClient.keyword_plan_path("[CUSTOMER]", "[KEYWORD_PLAN]")
-            #   response = keyword_plan_service_client.generate_forecast_metrics(formatted_keyword_plan)
+            #   response = keyword_plan_client.generate_forecast_metrics(formatted_keyword_plan)
 
             def generate_forecast_metrics \
                 keyword_plan,
@@ -329,9 +329,9 @@ module Google
             # @example
             #   require "google/ads/google_ads"
             #
-            #   keyword_plan_service_client = Google::Ads::GoogleAds::KeywordPlan.new(version: :v1)
+            #   keyword_plan_client = Google::Ads::GoogleAds::KeywordPlan.new(version: :v1)
             #   formatted_keyword_plan = Google::Ads::GoogleAds::V1::Services::KeywordPlanServiceClient.keyword_plan_path("[CUSTOMER]", "[KEYWORD_PLAN]")
-            #   response = keyword_plan_service_client.generate_historical_metrics(formatted_keyword_plan)
+            #   response = keyword_plan_client.generate_historical_metrics(formatted_keyword_plan)
 
             def generate_historical_metrics \
                 keyword_plan,