google-ads-googleads 18.0.0 → 18.1.0

data/lib/google/ads/google_ads/v11/services/keyword_plan_idea_service/client.rb

@@ -206,13 +206,13 @@ module Google
               #     The options for historical metrics data.
               #   @param keyword_and_url_seed [::Google::Ads::GoogleAds::V11::Services::KeywordAndUrlSeed, ::Hash]
               #     A Keyword and a specific Url to generate ideas from
-              #     e.g. cars, www.example.com/cars.
+              #     for example, cars, www.example.com/cars.
               #   @param keyword_seed [::Google::Ads::GoogleAds::V11::Services::KeywordSeed, ::Hash]
-              #     A Keyword or phrase to generate ideas from, e.g. cars.
+              #     A Keyword or phrase to generate ideas from, for example, cars.
               #   @param url_seed [::Google::Ads::GoogleAds::V11::Services::UrlSeed, ::Hash]
-              #     A specific url to generate ideas from, e.g. www.example.com/cars.
+              #     A specific url to generate ideas from, for example, www.example.com/cars.
               #   @param site_seed [::Google::Ads::GoogleAds::V11::Services::SiteSeed, ::Hash]
-              #     The site to generate ideas from, e.g. www.example.com.
+              #     The site to generate ideas from, for example, www.example.com.
               #
               # @yield [response, operation] Access the result along with the RPC operation
               # @yieldparam response [::Gapic::PagedEnumerable<::Google::Ads::GoogleAds::V11::Services::GenerateKeywordIdeaResult>]

data/lib/google/ads/google_ads/v11/services/keyword_theme_constant_service/client.rb

@@ -171,7 +171,7 @@ module Google
               #
               #   @param query_text [::String]
               #     The query text of a keyword theme that will be used to map to similar
-              #     keyword themes. E.g. "plumber" or "roofer".
+              #     keyword themes. For example, "plumber" or "roofer".
               #   @param country_code [::String]
               #     Upper-case, two-letter country code as defined by ISO-3166. This for
               #     refining the scope of the query, default to 'US' if not set.

data/lib/google/ads/google_ads/v11/services/offline_user_data_job_service/operations.rb

@@ -96,6 +96,9 @@ module Google
                   channel_args: @config.channel_args,
                   interceptors: @config.interceptors
                 )
+
+                # Used by an LRO wrapper for some methods of this service
+                @operations_client = self
               end
 
               # Service calls

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

@@ -448,7 +448,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, effective_frequency_limit: nil, targeting: nil, planned_products: nil, forecast_metric_options: 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, forecast_metric_options: nil, customer_reach_group: 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).
@@ -461,16 +461,16 @@ module Google
               #   @param campaign_duration [::Google::Ads::GoogleAds::V11::Services::CampaignDuration, ::Hash]
               #     Required. Campaign duration.
               #   @param cookie_frequency_cap [::Integer]
-              #     Desired cookie frequency cap to be applied to each planned product.
+              #     Chosen cookie frequency cap to be applied to each planned product.
               #     This is equivalent to the frequency cap exposed in Google Ads when creating
               #     a campaign, it represents the maximum number of times an ad can be shown to
               #     the same user.
               #     If not specified, no cap is applied.
               #
               #     This field is deprecated in v4 and will eventually be removed.
-              #     Please use cookie_frequency_cap_setting instead.
+              #     Use cookie_frequency_cap_setting instead.
               #   @param cookie_frequency_cap_setting [::Google::Ads::GoogleAds::V11::Services::FrequencyCap, ::Hash]
-              #     Desired cookie frequency cap to be applied to each planned product.
+              #     Chosen cookie frequency cap to be applied to each planned product.
               #     This is equivalent to the frequency cap exposed in Google Ads when creating
               #     a campaign, it represents the maximum number of times an ad can be shown to
               #     the same user during a specified time interval.
@@ -478,7 +478,7 @@ module Google
               #
               #     This field replaces the deprecated cookie_frequency_cap field.
               #   @param min_effective_frequency [::Integer]
-              #     Desired minimum effective frequency (the number of times a person was
+              #     Chosen minimum effective frequency (the number of times a person was
               #     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.
@@ -499,7 +499,7 @@ module Google
               #     The targeting to be applied to all products selected in the product mix.
               #
               #     This is planned targeting: execution details might vary based on the
-              #     advertising product, please consult an implementation specialist.
+              #     advertising product, consult an implementation specialist.
               #
               #     See specific metrics for details on how targeting affects them.
               #   @param planned_products [::Array<::Google::Ads::GoogleAds::V11::Services::PlannedProduct, ::Hash>]
@@ -507,6 +507,9 @@ module Google
               #     The max number of allowed planned products is 15.
               #   @param forecast_metric_options [::Google::Ads::GoogleAds::V11::Services::ForecastMetricOptions, ::Hash]
               #     Controls the forecast metrics returned in the response.
+              #   @param customer_reach_group [::String]
+              #     The name of the customer being planned for. This is a user-defined value.
+              #     Required if targeting.audience_targeting is set.
               #
               # @yield [response, operation] Access the result along with the RPC operation
               # @yieldparam response [::Google::Ads::GoogleAds::V11::Services::GenerateReachForecastResponse]

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

@@ -43,6 +43,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :genders, :message, 2, "google.ads.googleads.v11.common.GenderInfo"
       repeated :devices, :message, 3, "google.ads.googleads.v11.common.DeviceInfo"
       repeated :networks, :enum, 4, "google.ads.googleads.v11.enums.ReachPlanNetworkEnum.ReachPlanNetwork"
+      repeated :youtube_select_lineups, :message, 5, "google.ads.googleads.v11.services.YouTubeSelectLineUp"
     end
     add_message "google.ads.googleads.v11.services.GenerateProductMixIdeasRequest" do
       optional :customer_id, :string, 1
@@ -76,6 +77,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :targeting, :message, 6, "google.ads.googleads.v11.services.Targeting"
       repeated :planned_products, :message, 7, "google.ads.googleads.v11.services.PlannedProduct"
       optional :forecast_metric_options, :message, 13, "google.ads.googleads.v11.services.ForecastMetricOptions"
+      proto3_optional :customer_reach_group, :string, 14
     end
     add_message "google.ads.googleads.v11.services.EffectiveFrequencyLimit" do
       optional :effective_frequency_breakdown_limit, :int32, 1
@@ -90,6 +92,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :genders, :message, 3, "google.ads.googleads.v11.common.GenderInfo"
       repeated :devices, :message, 4, "google.ads.googleads.v11.common.DeviceInfo"
       optional :network, :enum, 5, "google.ads.googleads.v11.enums.ReachPlanNetworkEnum.ReachPlanNetwork"
+      optional :audience_targeting, :message, 7, "google.ads.googleads.v11.services.AudienceTargeting"
     end
     add_message "google.ads.googleads.v11.services.CampaignDuration" do
       proto3_optional :duration_in_days, :int32, 2
@@ -98,6 +101,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.ads.googleads.v11.services.PlannedProduct" do
       proto3_optional :plannable_product_code, :string, 3
       proto3_optional :budget_micros, :int64, 4
+      optional :advanced_product_targeting, :message, 5, "google.ads.googleads.v11.services.AdvancedProductTargeting"
     end
     add_message "google.ads.googleads.v11.services.GenerateReachForecastResponse" do
       optional :on_target_audience_metrics, :message, 1, "google.ads.googleads.v11.services.OnTargetAudienceMetrics"
@@ -153,6 +157,21 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.ads.googleads.v11.services.ForecastMetricOptions" do
       optional :include_coview, :bool, 1
     end
+    add_message "google.ads.googleads.v11.services.AudienceTargeting" do
+      repeated :user_interest, :message, 1, "google.ads.googleads.v11.common.UserInterestInfo"
+    end
+    add_message "google.ads.googleads.v11.services.AdvancedProductTargeting" do
+      oneof :advanced_targeting do
+        optional :youtube_select_settings, :message, 1, "google.ads.googleads.v11.services.YouTubeSelectSettings"
+      end
+    end
+    add_message "google.ads.googleads.v11.services.YouTubeSelectSettings" do
+      optional :lineup_id, :int64, 1
+    end
+    add_message "google.ads.googleads.v11.services.YouTubeSelectLineUp" do
+      optional :lineup_id, :int64, 1
+      optional :lineup_name, :string, 2
+    end
   end
 end
 
@@ -187,6 +206,10 @@ module Google
           OnTargetAudienceMetrics = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v11.services.OnTargetAudienceMetrics").msgclass
           EffectiveFrequencyBreakdown = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v11.services.EffectiveFrequencyBreakdown").msgclass
           ForecastMetricOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v11.services.ForecastMetricOptions").msgclass
+          AudienceTargeting = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v11.services.AudienceTargeting").msgclass
+          AdvancedProductTargeting = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v11.services.AdvancedProductTargeting").msgclass
+          YouTubeSelectSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v11.services.YouTubeSelectSettings").msgclass
+          YouTubeSelectLineUp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v11.services.YouTubeSelectLineUp").msgclass
         end
       end
     end

data/lib/google/ads/google_ads/v11/services/user_data_service/client.rb

@@ -29,11 +29,11 @@ module Google
             # Client for the UserDataService service.
             #
             # Service to manage user data uploads.
-            # Any uploads made to a Customer Match list via this service will be eligible
-            # for matching as per the customer matching process. Please see
+            # Any uploads made to a Customer Match list through this service will be
+            # eligible for matching as per the customer matching process. See
             # https://support.google.com/google-ads/answer/7474263. However, the uploads
-            # made via this service will not be visible under the 'Segment members' section
-            # for the Customer Match List in the Google Ads UI.
+            # made through this service will not be visible under the 'Segment members'
+            # section for the Customer Match List in the Google Ads UI.
             #
             class Client
               # @private

data/lib/google/ads/google_ads/v11/services/user_data_service.rb

@@ -32,11 +32,11 @@ module Google
         module Services
           ##
           # Service to manage user data uploads.
-          # Any uploads made to a Customer Match list via this service will be eligible
-          # for matching as per the customer matching process. Please see
+          # Any uploads made to a Customer Match list through this service will be
+          # eligible for matching as per the customer matching process. See
           # https://support.google.com/google-ads/answer/7474263. However, the uploads
-          # made via this service will not be visible under the 'Segment members' section
-          # for the Customer Match List in the Google Ads UI.
+          # made through this service will not be visible under the 'Segment members'
+          # section for the Customer Match List in the Google Ads UI.
           #
           # To load this service and instantiate a client:
           #

data/lib/google/ads/google_ads/v11/services/user_data_service_services_pb.rb

@@ -28,11 +28,11 @@ module Google
             # Proto file describing the UserDataService.
             #
             # Service to manage user data uploads.
-            # Any uploads made to a Customer Match list via this service will be eligible
-            # for matching as per the customer matching process. Please see
+            # Any uploads made to a Customer Match list through this service will be
+            # eligible for matching as per the customer matching process. See
             # https://support.google.com/google-ads/answer/7474263. However, the uploads
-            # made via this service will not be visible under the 'Segment members' section
-            # for the Customer Match List in the Google Ads UI.
+            # made through this service will not be visible under the 'Segment members'
+            # section for the Customer Match List in the Google Ads UI.
             class Service
 
               include ::GRPC::GenericService

data/lib/google/ads/google_ads/version.rb

@@ -20,7 +20,7 @@ module Google
   module Ads
     module GoogleAds
       CLIENT_LIB_NAME = 'gccl'.freeze
-      CLIENT_LIB_VERSION = '18.0.0'.freeze
+      CLIENT_LIB_VERSION = '18.1.0'.freeze
       VERSION = CLIENT_LIB_VERSION
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-ads-googleads
 version: !ruby/object:Gem::Version
-  version: 18.0.0
+  version: 18.1.0
 platform: ruby
 authors:
 - Google Inc
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-06-17 00:00:00.000000000 Z
+date: 2022-08-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -102,6 +102,7 @@ files:
 - ChangeLog
 - README.md
 - Rakefile
+- THIRD-PARTY-LICENCES.txt
 - google_ads_config.rb
 - lib/google/ads/google_ads.rb
 - lib/google/ads/google_ads/api_versions.rb
@@ -1458,6 +1459,7 @@ files:
 - lib/google/ads/google_ads/v11/enums/bid_modifier_source_pb.rb
 - lib/google/ads/google_ads/v11/enums/bidding_source_pb.rb
 - lib/google/ads/google_ads/v11/enums/bidding_strategy_status_pb.rb
+- lib/google/ads/google_ads/v11/enums/bidding_strategy_system_status_pb.rb
 - lib/google/ads/google_ads/v11/enums/bidding_strategy_type_pb.rb
 - lib/google/ads/google_ads/v11/enums/billing_setup_status_pb.rb
 - lib/google/ads/google_ads/v11/enums/brand_safety_suitability_pb.rb
@@ -1689,6 +1691,7 @@ files:
 - lib/google/ads/google_ads/v11/enums/user_list_combined_rule_operator_pb.rb
 - lib/google/ads/google_ads/v11/enums/user_list_crm_data_source_type_pb.rb
 - lib/google/ads/google_ads/v11/enums/user_list_date_rule_item_operator_pb.rb
+- lib/google/ads/google_ads/v11/enums/user_list_flexible_rule_operator_pb.rb
 - lib/google/ads/google_ads/v11/enums/user_list_logical_rule_operator_pb.rb
 - lib/google/ads/google_ads/v11/enums/user_list_membership_status_pb.rb
 - lib/google/ads/google_ads/v11/enums/user_list_number_rule_item_operator_pb.rb
@@ -1731,6 +1734,7 @@ files:
 - lib/google/ads/google_ads/v11/errors/asset_set_error_pb.rb
 - lib/google/ads/google_ads/v11/errors/asset_set_link_error_pb.rb
 - lib/google/ads/google_ads/v11/errors/audience_error_pb.rb
+- lib/google/ads/google_ads/v11/errors/audience_insights_error_pb.rb
 - lib/google/ads/google_ads/v11/errors/authentication_error_pb.rb
 - lib/google/ads/google_ads/v11/errors/authorization_error_pb.rb
 - lib/google/ads/google_ads/v11/errors/batch_job_error_pb.rb
@@ -4139,7 +4143,7 @@ homepage: https://github.com/googleads/google-ads-ruby
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -4155,7 +4159,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.2.3
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Google client library for the Google Ads API
 test_files: []