google-ads-googleads 3.0.1 → 3.1.0

data/lib/google/ads/google_ads/v2/services/reach_plan_service_client_config.json

@@ -0,0 +1,46 @@
+{
+  "interfaces": {
+    "google.ads.googleads.v2.services.ReachPlanService": {
+      "retry_codes": {
+        "idempotent": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ],
+        "non_idempotent": []
+      },
+      "retry_params": {
+        "default": {
+          "initial_retry_delay_millis": 5000,
+          "retry_delay_multiplier": 1.3,
+          "max_retry_delay_millis": 60000,
+          "initial_rpc_timeout_millis": 3600000,
+          "rpc_timeout_multiplier": 1.0,
+          "max_rpc_timeout_millis": 3600000,
+          "total_timeout_millis": 3600000
+        }
+      },
+      "methods": {
+        "ListPlannableLocations": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "ListPlannableProducts": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "GenerateProductMixIdeas": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "GenerateReachForecast": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,126 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/ads/google_ads/v2/services/reach_plan_service.proto
+
+require 'google/protobuf'
+
+require 'google/ads/google_ads/v2/common/criteria_pb'
+require 'google/ads/google_ads/v2/enums/reach_plan_ad_length_pb'
+require 'google/ads/google_ads/v2/enums/reach_plan_age_range_pb'
+require 'google/api/annotations_pb'
+require 'google/protobuf/wrappers_pb'
+require 'google/api/client_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.ads.googleads.v2.services.ListPlannableLocationsRequest" do
+  end
+  add_message "google.ads.googleads.v2.services.ListPlannableLocationsResponse" do
+    repeated :plannable_locations, :message, 1, "google.ads.googleads.v2.services.PlannableLocation"
+  end
+  add_message "google.ads.googleads.v2.services.PlannableLocation" do
+    optional :id, :message, 1, "google.protobuf.StringValue"
+    optional :name, :message, 2, "google.protobuf.StringValue"
+    optional :parent_country_id, :message, 3, "google.protobuf.Int64Value"
+  end
+  add_message "google.ads.googleads.v2.services.ListPlannableProductsRequest" do
+    optional :plannable_location_id, :message, 1, "google.protobuf.StringValue"
+  end
+  add_message "google.ads.googleads.v2.services.ListPlannableProductsResponse" do
+    repeated :product_metadata, :message, 1, "google.ads.googleads.v2.services.ProductMetadata"
+  end
+  add_message "google.ads.googleads.v2.services.ProductMetadata" do
+    optional :plannable_product_code, :message, 1, "google.protobuf.StringValue"
+    optional :plannable_targeting, :message, 2, "google.ads.googleads.v2.services.PlannableTargeting"
+  end
+  add_message "google.ads.googleads.v2.services.PlannableTargeting" do
+    repeated :age_ranges, :enum, 1, "google.ads.googleads.v2.enums.ReachPlanAgeRangeEnum.ReachPlanAgeRange"
+    repeated :genders, :message, 2, "google.ads.googleads.v2.common.GenderInfo"
+    repeated :devices, :message, 3, "google.ads.googleads.v2.common.DeviceInfo"
+  end
+  add_message "google.ads.googleads.v2.services.GenerateProductMixIdeasRequest" do
+    optional :customer_id, :string, 1
+    optional :plannable_location_id, :message, 2, "google.protobuf.StringValue"
+    optional :currency_code, :message, 3, "google.protobuf.StringValue"
+    optional :budget_micros, :message, 4, "google.protobuf.Int64Value"
+    optional :preferences, :message, 5, "google.ads.googleads.v2.services.Preferences"
+  end
+  add_message "google.ads.googleads.v2.services.Preferences" do
+    optional :is_skippable, :message, 1, "google.protobuf.BoolValue"
+    optional :starts_with_sound, :message, 2, "google.protobuf.BoolValue"
+    optional :ad_length, :enum, 3, "google.ads.googleads.v2.enums.ReachPlanAdLengthEnum.ReachPlanAdLength"
+    optional :top_content_only, :message, 4, "google.protobuf.BoolValue"
+    optional :has_guaranteed_price, :message, 5, "google.protobuf.BoolValue"
+  end
+  add_message "google.ads.googleads.v2.services.GenerateProductMixIdeasResponse" do
+    repeated :product_allocation, :message, 1, "google.ads.googleads.v2.services.ProductAllocation"
+  end
+  add_message "google.ads.googleads.v2.services.ProductAllocation" do
+    optional :plannable_product_code, :message, 1, "google.protobuf.StringValue"
+    optional :budget_micros, :message, 2, "google.protobuf.Int64Value"
+  end
+  add_message "google.ads.googleads.v2.services.GenerateReachForecastRequest" do
+    optional :customer_id, :string, 1
+    optional :currency_code, :message, 2, "google.protobuf.StringValue"
+    optional :campaign_duration, :message, 3, "google.ads.googleads.v2.services.CampaignDuration"
+    optional :cookie_frequency_cap, :message, 4, "google.protobuf.Int32Value"
+    optional :min_effective_frequency, :message, 5, "google.protobuf.Int32Value"
+    optional :targeting, :message, 6, "google.ads.googleads.v2.services.Targeting"
+    repeated :planned_products, :message, 7, "google.ads.googleads.v2.services.PlannedProduct"
+  end
+  add_message "google.ads.googleads.v2.services.Targeting" do
+    optional :plannable_location_id, :message, 1, "google.protobuf.StringValue"
+    optional :age_range, :enum, 2, "google.ads.googleads.v2.enums.ReachPlanAgeRangeEnum.ReachPlanAgeRange"
+    repeated :genders, :message, 3, "google.ads.googleads.v2.common.GenderInfo"
+    repeated :devices, :message, 4, "google.ads.googleads.v2.common.DeviceInfo"
+  end
+  add_message "google.ads.googleads.v2.services.CampaignDuration" do
+    optional :duration_in_days, :message, 1, "google.protobuf.Int32Value"
+  end
+  add_message "google.ads.googleads.v2.services.PlannedProduct" do
+    optional :plannable_product_code, :message, 1, "google.protobuf.StringValue"
+    optional :budget_micros, :message, 2, "google.protobuf.Int64Value"
+  end
+  add_message "google.ads.googleads.v2.services.GenerateReachForecastResponse" do
+    optional :on_target_audience_metrics, :message, 1, "google.ads.googleads.v2.services.OnTargetAudienceMetrics"
+    optional :reach_curve, :message, 2, "google.ads.googleads.v2.services.ReachCurve"
+  end
+  add_message "google.ads.googleads.v2.services.ReachCurve" do
+    repeated :reach_forecasts, :message, 1, "google.ads.googleads.v2.services.ReachForecast"
+  end
+  add_message "google.ads.googleads.v2.services.ReachForecast" do
+    optional :cost_micros, :message, 1, "google.protobuf.Int64Value"
+    optional :forecast, :message, 2, "google.ads.googleads.v2.services.Forecast"
+    repeated :forecasted_product_allocations, :message, 3, "google.ads.googleads.v2.services.ProductAllocation"
+  end
+  add_message "google.ads.googleads.v2.services.Forecast" do
+    optional :on_target_reach, :message, 1, "google.protobuf.Int64Value"
+    optional :total_reach, :message, 2, "google.protobuf.Int64Value"
+    optional :on_target_impressions, :message, 3, "google.protobuf.Int64Value"
+    optional :total_impressions, :message, 4, "google.protobuf.Int64Value"
+  end
+  add_message "google.ads.googleads.v2.services.OnTargetAudienceMetrics" do
+    optional :youtube_audience_size, :message, 1, "google.protobuf.Int64Value"
+    optional :census_audience_size, :message, 2, "google.protobuf.Int64Value"
+  end
+end
+
+module Google::Ads::GoogleAds::V2::Services
+  ListPlannableLocationsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.ListPlannableLocationsRequest").msgclass
+  ListPlannableLocationsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.ListPlannableLocationsResponse").msgclass
+  PlannableLocation = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.PlannableLocation").msgclass
+  ListPlannableProductsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.ListPlannableProductsRequest").msgclass
+  ListPlannableProductsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.ListPlannableProductsResponse").msgclass
+  ProductMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.ProductMetadata").msgclass
+  PlannableTargeting = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.PlannableTargeting").msgclass
+  GenerateProductMixIdeasRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.GenerateProductMixIdeasRequest").msgclass
+  Preferences = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.Preferences").msgclass
+  GenerateProductMixIdeasResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.GenerateProductMixIdeasResponse").msgclass
+  ProductAllocation = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.ProductAllocation").msgclass
+  GenerateReachForecastRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.GenerateReachForecastRequest").msgclass
+  Targeting = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.Targeting").msgclass
+  CampaignDuration = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.CampaignDuration").msgclass
+  PlannedProduct = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.PlannedProduct").msgclass
+  GenerateReachForecastResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.GenerateReachForecastResponse").msgclass
+  ReachCurve = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.ReachCurve").msgclass
+  ReachForecast = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.ReachForecast").msgclass
+  Forecast = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.Forecast").msgclass
+  OnTargetAudienceMetrics = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v2.services.OnTargetAudienceMetrics").msgclass
+end

data/lib/google/ads/google_ads/v2/services/reach_plan_service_services_pb.rb

@@ -0,0 +1,55 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/ads/google_ads/v2/services/reach_plan_service.proto for package 'Google::Ads::GoogleAds::V2::Services'
+# Original file comments:
+# Copyright 2019 Google LLC.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+#
+
+require 'grpc'
+require 'google/ads/google_ads/v2/services/reach_plan_service_pb'
+
+module Google::Ads::GoogleAds::V2::Services
+  module ReachPlanService
+    # Proto file describing the reach plan service.
+    #
+    # Reach Plan Service gives users information about audience size that can
+    # be reached through advertisement on YouTube. In particular,
+    # GenerateReachForecast provides estimated number of people of specified
+    # demographics that can be reached by an ad in a given market by a campaign of
+    # certain duration with a defined budget.
+    class Service
+
+      include GRPC::GenericService
+
+      self.marshal_class_method = :encode
+      self.unmarshal_class_method = :decode
+      self.service_name = 'google.ads.googleads.v2.services.ReachPlanService'
+
+      # Returns the list of plannable locations (e.g. countries, DMAs).
+      rpc :ListPlannableLocations, ListPlannableLocationsRequest, ListPlannableLocationsResponse
+      # Returns the list of per-location plannable YouTube ad formats with allowed
+      # targeting.
+      rpc :ListPlannableProducts, ListPlannableProductsRequest, ListPlannableProductsResponse
+      # Generates a product mix ideas given a set of preferences. This method
+      # helps the advertiser to obtain a good mix of ad formats and budget
+      # allocations based on its preferences.
+      rpc :GenerateProductMixIdeas, GenerateProductMixIdeasRequest, GenerateProductMixIdeasResponse
+      # Generates a reach forecast for a given targeting / product mix.
+      rpc :GenerateReachForecast, GenerateReachForecastRequest, GenerateReachForecastResponse
+    end
+
+    Stub = Service.rpc_stub_class
+  end
+end

data/lib/google/ads/google_ads/v2/services/remarketing_action_service_pb.rb

@@ -6,7 +6,6 @@ require 'google/protobuf'
 require 'google/ads/google_ads/v2/resources/remarketing_action_pb'
 require 'google/api/annotations_pb'
 require 'google/protobuf/field_mask_pb'
-require 'google/protobuf/wrappers_pb'
 require 'google/rpc/status_pb'
 require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do

data/lib/google/ads/google_ads/v2/services/shared_criterion_service_pb.rb

@@ -5,7 +5,6 @@ require 'google/protobuf'
 
 require 'google/ads/google_ads/v2/resources/shared_criterion_pb'
 require 'google/api/annotations_pb'
-require 'google/protobuf/wrappers_pb'
 require 'google/rpc/status_pb'
 require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do

data/lib/google/ads/google_ads/v2/services/shared_set_service_pb.rb

@@ -6,7 +6,6 @@ require 'google/protobuf'
 require 'google/ads/google_ads/v2/resources/shared_set_pb'
 require 'google/api/annotations_pb'
 require 'google/protobuf/field_mask_pb'
-require 'google/protobuf/wrappers_pb'
 require 'google/rpc/status_pb'
 require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do

data/lib/google/ads/google_ads/v2/services/user_list_service_pb.rb

@@ -6,7 +6,6 @@ require 'google/protobuf'
 require 'google/ads/google_ads/v2/resources/user_list_pb'
 require 'google/api/annotations_pb'
 require 'google/protobuf/field_mask_pb'
-require 'google/protobuf/wrappers_pb'
 require 'google/rpc/status_pb'
 require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do

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

@@ -19,7 +19,7 @@
 module Google
   module Ads
     module GoogleAds
-      CLIENT_LIB_VERSION = '3.0.1'.freeze
+      CLIENT_LIB_VERSION = '3.1.0'.freeze
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-ads-googleads
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.1.0
 platform: ruby
 authors:
 - Google Inc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-08-01 00:00:00.000000000 Z
+date: 2019-08-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-gax
@@ -1132,6 +1132,8 @@ files:
 - lib/google/ads/google_ads/v2/enums/promotion_placeholder_field_pb.rb
 - lib/google/ads/google_ads/v2/enums/proximity_radius_units_pb.rb
 - lib/google/ads/google_ads/v2/enums/quality_score_bucket_pb.rb
+- lib/google/ads/google_ads/v2/enums/reach_plan_ad_length_pb.rb
+- lib/google/ads/google_ads/v2/enums/reach_plan_age_range_pb.rb
 - lib/google/ads/google_ads/v2/enums/real_estate_placeholder_field_pb.rb
 - lib/google/ads/google_ads/v2/enums/recommendation_type_pb.rb
 - lib/google/ads/google_ads/v2/enums/search_engine_results_page_type_pb.rb
@@ -1263,6 +1265,7 @@ files:
 - lib/google/ads/google_ads/v2/errors/query_error_pb.rb
 - lib/google/ads/google_ads/v2/errors/quota_error_pb.rb
 - lib/google/ads/google_ads/v2/errors/range_error_pb.rb
+- lib/google/ads/google_ads/v2/errors/reach_plan_error_pb.rb
 - lib/google/ads/google_ads/v2/errors/recommendation_error_pb.rb
 - lib/google/ads/google_ads/v2/errors/region_code_error_pb.rb
 - lib/google/ads/google_ads/v2/errors/request_error_pb.rb
@@ -1746,6 +1749,10 @@ files:
 - lib/google/ads/google_ads/v2/services/product_group_view_service_client_config.json
 - lib/google/ads/google_ads/v2/services/product_group_view_service_pb.rb
 - lib/google/ads/google_ads/v2/services/product_group_view_service_services_pb.rb
+- lib/google/ads/google_ads/v2/services/reach_plan_service_client.rb
+- lib/google/ads/google_ads/v2/services/reach_plan_service_client_config.json
+- lib/google/ads/google_ads/v2/services/reach_plan_service_pb.rb
+- lib/google/ads/google_ads/v2/services/reach_plan_service_services_pb.rb
 - lib/google/ads/google_ads/v2/services/recommendation_service_client.rb
 - lib/google/ads/google_ads/v2/services/recommendation_service_client_config.json
 - lib/google/ads/google_ads/v2/services/recommendation_service_pb.rb
@@ -1817,7 +1824,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 2.7.6.2
 signing_key: 
 specification_version: 4
 summary: Google client library for the Google Ads API