Merge pull request #133 from bilibili/kratos/third_party

add third_party proto

doc/wiki-cn/kratos-protoc.md

@@ -21,7 +21,7 @@ export $KRATOS_HOME = kratos路径
 export $KRATOS_DEMO = 项目路径
 
 // 生成：api.pb.go
-protoc -I$GOPATH/src:$KRATOS_HOME/tool/protobuf/pkg/extensions:$KRATOS_DEMO/api --gogofast_out=plugins=grpc:$KRATOS_DEMO/api $KRATOS_DEMO/api/api.proto
+protoc -I$GOPATH/src:$KRATOS_HOME/tool/protobuf/pkg/extensions:$KRATOS_DEMO/api --gofast_out=plugins=grpc:$KRATOS_DEMO/api $KRATOS_DEMO/api/api.proto
 
 // 生成：api.bm.go
 protoc -I$GOPATH/src:$KRATOS_HOME/tool/protobuf/pkg/extensions:$KRATOS_DEMO/api --bm_out=$KRATOS_DEMO/api $KRATOS_DEMO/api/api.proto

third_party/CHANGELOG.md

@@ -0,0 +1,7 @@
+#### Version 1.0.1
+
+> 1.gogo.protobuf迁移到third_party/github目录下
+
+#### Version 1.0.0
+
+> 1.添加 gogo proto  

third_party/github.com/gogo/protobuf/AUTHORS

@@ -0,0 +1,15 @@
+# This is the official list of GoGo authors for copyright purposes.
+# This file is distinct from the CONTRIBUTORS file, which
+# lists people.  For example, employees are listed in CONTRIBUTORS,
+# but not in AUTHORS, because the employer holds the copyright.
+
+# Names should be added to this file as one of
+#     Organization's name
+#     Individual's name <submission email address>
+#     Individual's name <submission email address> <email2> <emailN>
+
+# Please keep the list sorted.
+
+Sendgrid, Inc
+Vastech SA (PTY) LTD
+Walter Schulze <awalterschulze@gmail.com>

third_party/github.com/gogo/protobuf/CONTRIBUTORS

@@ -0,0 +1,23 @@
+Anton Povarov <anton.povarov@gmail.com>
+Brian Goff <cpuguy83@gmail.com>
+Clayton Coleman <ccoleman@redhat.com>
+Denis Smirnov <denis.smirnov.91@gmail.com>
+DongYun Kang <ceram1000@gmail.com>
+Dwayne Schultz <dschultz@pivotal.io>
+Georg Apitz <gapitz@pivotal.io>
+Gustav Paul <gustav.paul@gmail.com>
+Johan Brandhorst <johan.brandhorst@gmail.com>
+John Shahid <jvshahid@gmail.com>
+John Tuley <john@tuley.org>
+Laurent <laurent@adyoulike.com>
+Patrick Lee <patrick@dropbox.com>
+Peter Edge <peter.edge@gmail.com>
+Roger Johansson <rogeralsing@gmail.com>
+Sam Nguyen <sam.nguyen@sendgrid.com>
+Sergio Arbeo <serabe@gmail.com>
+Stephen J Day <stephen.day@docker.com>
+Tamir Duberstein <tamird@gmail.com>
+Todd Eisenberger <teisenberger@dropbox.com>
+Tormod Erevik Lea <tormodlea@gmail.com>
+Vyacheslav Kim <kane@sendgrid.com>
+Walter Schulze <awalterschulze@gmail.com>

third_party/github.com/gogo/protobuf/LICENSE

@@ -0,0 +1,35 @@
+Copyright (c) 2013, The GoGo Authors. All rights reserved.
+
+Protocol Buffers for Go with Gadgets
+
+Go support for Protocol Buffers - Google's data interchange format
+
+Copyright 2010 The Go Authors.  All rights reserved.
+https://github.com/golang/protobuf
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following disclaimer
+in the documentation and/or other materials provided with the
+distribution.
+    * Neither the name of Google Inc. nor the names of its
+contributors may be used to endorse or promote products derived from
+this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

third_party/github.com/gogo/protobuf/gogoproto/gogo.proto

@@ -0,0 +1,144 @@
+// Protocol Buffers for Go with Gadgets
+//
+// Copyright (c) 2013, The GoGo Authors. All rights reserved.
+// http://github.com/gogo/protobuf
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//     * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//     * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+syntax = "proto2";
+package gogoproto;
+
+import "google/protobuf/descriptor.proto";
+
+option java_package = "com.google.protobuf";
+option java_outer_classname = "GoGoProtos";
+option go_package = "github.com/gogo/protobuf/gogoproto";
+
+extend google.protobuf.EnumOptions {
+	optional bool goproto_enum_prefix = 62001;
+	optional bool goproto_enum_stringer = 62021;
+	optional bool enum_stringer = 62022;
+	optional string enum_customname = 62023;
+	optional bool enumdecl = 62024;
+}
+
+extend google.protobuf.EnumValueOptions {
+	optional string enumvalue_customname = 66001;
+}
+
+extend google.protobuf.FileOptions {
+	optional bool goproto_getters_all = 63001;
+	optional bool goproto_enum_prefix_all = 63002;
+	optional bool goproto_stringer_all = 63003;
+	optional bool verbose_equal_all = 63004;
+	optional bool face_all = 63005;
+	optional bool gostring_all = 63006;
+	optional bool populate_all = 63007;
+	optional bool stringer_all = 63008;
+	optional bool onlyone_all = 63009;
+
+	optional bool equal_all = 63013;
+	optional bool description_all = 63014;
+	optional bool testgen_all = 63015;
+	optional bool benchgen_all = 63016;
+	optional bool marshaler_all = 63017;
+	optional bool unmarshaler_all = 63018;
+	optional bool stable_marshaler_all = 63019;
+
+	optional bool sizer_all = 63020;
+
+	optional bool goproto_enum_stringer_all = 63021;
+	optional bool enum_stringer_all = 63022;
+
+	optional bool unsafe_marshaler_all = 63023;
+	optional bool unsafe_unmarshaler_all = 63024;
+
+	optional bool goproto_extensions_map_all = 63025;
+	optional bool goproto_unrecognized_all = 63026;
+	optional bool gogoproto_import = 63027;
+	optional bool protosizer_all = 63028;
+	optional bool compare_all = 63029;
+    optional bool typedecl_all = 63030;
+    optional bool enumdecl_all = 63031;
+
+	optional bool goproto_registration = 63032;
+	optional bool messagename_all = 63033;
+
+	optional bool goproto_sizecache_all = 63034;
+	optional bool goproto_unkeyed_all = 63035;
+}
+
+extend google.protobuf.MessageOptions {
+	optional bool goproto_getters = 64001;
+	optional bool goproto_stringer = 64003;
+	optional bool verbose_equal = 64004;
+	optional bool face = 64005;
+	optional bool gostring = 64006;
+	optional bool populate = 64007;
+	optional bool stringer = 67008;
+	optional bool onlyone = 64009;
+
+	optional bool equal = 64013;
+	optional bool description = 64014;
+	optional bool testgen = 64015;
+	optional bool benchgen = 64016;
+	optional bool marshaler = 64017;
+	optional bool unmarshaler = 64018;
+	optional bool stable_marshaler = 64019;
+
+	optional bool sizer = 64020;
+
+	optional bool unsafe_marshaler = 64023;
+	optional bool unsafe_unmarshaler = 64024;
+
+	optional bool goproto_extensions_map = 64025;
+	optional bool goproto_unrecognized = 64026;
+
+	optional bool protosizer = 64028;
+	optional bool compare = 64029;
+
+	optional bool typedecl = 64030;
+
+	optional bool messagename = 64033;
+
+	optional bool goproto_sizecache = 64034;
+	optional bool goproto_unkeyed = 64035;
+}
+
+extend google.protobuf.FieldOptions {
+	optional bool nullable = 65001;
+	optional bool embed = 65002;
+	optional string customtype = 65003;
+	optional string customname = 65004;
+	optional string jsontag = 65005;
+	optional string moretags = 65006;
+	optional string casttype = 65007;
+	optional string castkey = 65008;
+	optional string castvalue = 65009;
+
+	optional bool stdtime = 65010;
+	optional bool stdduration = 65011;
+	optional bool wktpointer = 65012;
+
+}

third_party/google/ads/googleads/README.md

@@ -0,0 +1,21 @@
+# Google Ads API - proto definitions
+
+This folder contains the [protocol
+buffer](https://developers.google.com/protocol-buffers/) definitions for the
+[Google Ads API](https://developers.google.com/google-ads/api/). To use this
+API, we encourage you to take a look at our [official client
+libraries](https://developers.google.com/google-ads/api/docs/client-libs) for
+Java, Ruby, PHP, Python or .NET. Refer to the
+[Quickstart](https://developers.google.com/google-ads/api/docs/first-call/overview)
+to learn how to make your first API call.
+
+To develop in a programming language without an official client library, refer
+to the [API Concepts
+Guide](https://developers.google.com/google-ads/api/docs/concepts/overview) and
+consult these protocol buffer definitions as a reference when constructing API
+requests.
+
+Use [the official Google Ads API
+forum](https://groups.google.com/d/forum/adwords-api) to request an official
+client library in another programming language, report bugs, request new
+features in the Google Ads API, or provide feedback.

third_party/google/ads/googleads/base.yaml

@@ -0,0 +1,276 @@
+type: google.api.Service
+config_version: 3
+name: googleads.googleapis.com
+title: Google Ads API
+
+apis:
+- name: google.ads.googleads.v0.services.AccountBudgetProposalService
+- name: google.ads.googleads.v0.services.AccountBudgetService
+- name: google.ads.googleads.v0.services.AdGroupAdService
+- name: google.ads.googleads.v0.services.AdGroupAudienceViewService
+- name: google.ads.googleads.v0.services.AdGroupBidModifierService
+- name: google.ads.googleads.v0.services.AdGroupCriterionService
+- name: google.ads.googleads.v0.services.AdGroupFeedService
+- name: google.ads.googleads.v0.services.AdGroupService
+- name: google.ads.googleads.v0.services.AgeRangeViewService
+- name: google.ads.googleads.v0.services.BiddingStrategyService
+- name: google.ads.googleads.v0.services.BillingSetupService
+- name: google.ads.googleads.v0.services.CampaignAudienceViewService
+- name: google.ads.googleads.v0.services.CampaignBidModifierService
+- name: google.ads.googleads.v0.services.CampaignBudgetService
+- name: google.ads.googleads.v0.services.CampaignCriterionService
+- name: google.ads.googleads.v0.services.CampaignFeedService
+- name: google.ads.googleads.v0.services.CampaignGroupService
+- name: google.ads.googleads.v0.services.CampaignService
+- name: google.ads.googleads.v0.services.CampaignSharedSetService
+- name: google.ads.googleads.v0.services.CarrierConstantService
+- name: google.ads.googleads.v0.services.ChangeStatusService
+- name: google.ads.googleads.v0.services.ConversionActionService
+- name: google.ads.googleads.v0.services.CustomerClientLinkService
+- name: google.ads.googleads.v0.services.CustomerClientService
+- name: google.ads.googleads.v0.services.CustomerFeedService
+- name: google.ads.googleads.v0.services.CustomerManagerLinkService
+- name: google.ads.googleads.v0.services.CustomerService
+- name: google.ads.googleads.v0.services.DisplayKeywordViewService
+- name: google.ads.googleads.v0.services.FeedItemService
+- name: google.ads.googleads.v0.services.FeedMappingService
+- name: google.ads.googleads.v0.services.FeedService
+- name: google.ads.googleads.v0.services.GenderViewService
+- name: google.ads.googleads.v0.services.GeoTargetConstantService
+- name: google.ads.googleads.v0.services.GoogleAdsFieldService
+- name: google.ads.googleads.v0.services.SharedCriterionService
+- name: google.ads.googleads.v0.services.SharedSetService
+- name: google.ads.googleads.v0.services.UserListService
+- name: google.ads.googleads.v0.services.GoogleAdsService
+- name: google.ads.googleads.v0.services.HotelGroupViewService
+- name: google.ads.googleads.v0.services.HotelPerformanceViewService
+- name: google.ads.googleads.v0.services.KeywordPlanAdGroupService
+- name: google.ads.googleads.v0.services.KeywordPlanCampaignService
+- name: google.ads.googleads.v0.services.KeywordPlanIdeaService
+- name: google.ads.googleads.v0.services.KeywordPlanKeywordService
+- name: google.ads.googleads.v0.services.KeywordPlanNegativeKeywordService
+- name: google.ads.googleads.v0.services.KeywordPlanService
+- name: google.ads.googleads.v0.services.KeywordViewService
+- name: google.ads.googleads.v0.services.LanguageConstantService
+- name: google.ads.googleads.v0.services.ManagedPlacementViewService
+- name: google.ads.googleads.v0.services.MediaFileService
+- name: google.ads.googleads.v0.services.ParentalStatusViewService
+- name: google.ads.googleads.v0.services.PaymentsAccountService
+- name: google.ads.googleads.v0.services.ProductGroupViewService
+- name: google.ads.googleads.v0.services.RecommendationService
+- name: google.ads.googleads.v0.services.SearchTermViewService
+- name: google.ads.googleads.v0.services.TopicConstantService
+- name: google.ads.googleads.v0.services.TopicViewService
+- name: google.ads.googleads.v0.services.UserInterestService
+- name: google.ads.googleads.v0.services.VideoService
+
+types:
+- name: google.ads.googleads.v0.errors.GoogleAdsFailure
+
+documentation:
+  summary: |-
+    Manage your AdWords accounts, campaigns, and reports with this REST-based
+    API.
+  overview: |-
+    # This warning always fires when the last path segment of packages is not
+
+    # the version
+
+backend:
+  rules:
+  - selector: google.ads.googleads.v0.services.AccountBudgetProposalService.GetAccountBudgetProposal
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AccountBudgetProposalService.MutateAccountBudgetProposal
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AccountBudgetService.GetAccountBudget
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AdGroupAdService.GetAdGroupAd
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AdGroupAdService.MutateAdGroupAds
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AdGroupAudienceViewService.GetAdGroupAudienceView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AdGroupBidModifierService.GetAdGroupBidModifier
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AdGroupBidModifierService.MutateAdGroupBidModifiers
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AdGroupCriterionService.GetAdGroupCriterion
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AdGroupCriterionService.MutateAdGroupCriteria
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AdGroupFeedService.GetAdGroupFeed
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AdGroupFeedService.MutateAdGroupFeeds
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AdGroupService.GetAdGroup
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AdGroupService.MutateAdGroups
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.AgeRangeViewService.GetAgeRangeView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.BiddingStrategyService.GetBiddingStrategy
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.BiddingStrategyService.MutateBiddingStrategies
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.BillingSetupService.GetBillingSetup
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.BillingSetupService.MutateBillingSetup
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignAudienceViewService.GetCampaignAudienceView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignBidModifierService.GetCampaignBidModifier
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignBidModifierService.MutateCampaignBidModifiers
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignBudgetService.GetCampaignBudget
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignBudgetService.MutateCampaignBudgets
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignCriterionService.GetCampaignCriterion
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignCriterionService.MutateCampaignCriteria
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignFeedService.GetCampaignFeed
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignFeedService.MutateCampaignFeeds
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignGroupService.GetCampaignGroup
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignGroupService.MutateCampaignGroups
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignService.GetCampaign
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignService.MutateCampaigns
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignSharedSetService.GetCampaignSharedSet
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CampaignSharedSetService.MutateCampaignSharedSets
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CarrierConstantService.GetCarrierConstant
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.ChangeStatusService.GetChangeStatus
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.ConversionActionService.GetConversionAction
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.ConversionActionService.MutateConversionActions
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CustomerClientLinkService.GetCustomerClientLink
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CustomerClientService.GetCustomerClient
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CustomerFeedService.GetCustomerFeed
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CustomerFeedService.MutateCustomerFeeds
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CustomerManagerLinkService.GetCustomerManagerLink
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CustomerService.GetCustomer
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CustomerService.MutateCustomer
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CustomerService.ListAccessibleCustomers
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.CustomerService.CreateCustomerClient
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.DisplayKeywordViewService.GetDisplayKeywordView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.FeedItemService.GetFeedItem
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.FeedItemService.MutateFeedItems
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.FeedMappingService.GetFeedMapping
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.FeedMappingService.MutateFeedMappings
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.FeedService.GetFeed
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.FeedService.MutateFeeds
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.GenderViewService.GetGenderView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.GeoTargetConstantService.GetGeoTargetConstant
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.GeoTargetConstantService.SuggestGeoTargetConstants
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.GoogleAdsFieldService.GetGoogleAdsField
+    deadline: 600.0
+  - selector: google.ads.googleads.v0.services.GoogleAdsFieldService.SearchGoogleAdsFields
+    deadline: 600.0
+  - selector: google.ads.googleads.v0.services.SharedCriterionService.GetSharedCriterion
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.SharedCriterionService.MutateSharedCriteria
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.SharedSetService.GetSharedSet
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.SharedSetService.MutateSharedSets
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.UserListService.GetUserList
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.UserListService.MutateUserLists
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.GoogleAdsService.Search
+    deadline: 600.0
+  - selector: google.ads.googleads.v0.services.GoogleAdsService.Mutate
+    deadline: 600.0
+  - selector: google.ads.googleads.v0.services.HotelGroupViewService.GetHotelGroupView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.HotelPerformanceViewService.GetHotelPerformanceView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanAdGroupService.GetKeywordPlanAdGroup
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanAdGroupService.MutateKeywordPlanAdGroups
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanCampaignService.GetKeywordPlanCampaign
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanCampaignService.MutateKeywordPlanCampaigns
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanIdeaService.GenerateKeywordIdeas
+    deadline: 600.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanKeywordService.GetKeywordPlanKeyword
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanKeywordService.MutateKeywordPlanKeywords
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanNegativeKeywordService.GetKeywordPlanNegativeKeyword
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanNegativeKeywordService.MutateKeywordPlanNegativeKeywords
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanService.GetKeywordPlan
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanService.MutateKeywordPlans
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanService.GenerateForecastMetrics
+    deadline: 600.0
+  - selector: google.ads.googleads.v0.services.KeywordPlanService.GenerateHistoricalMetrics
+    deadline: 600.0
+  - selector: google.ads.googleads.v0.services.KeywordViewService.GetKeywordView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.LanguageConstantService.GetLanguageConstant
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.ManagedPlacementViewService.GetManagedPlacementView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.MediaFileService.GetMediaFile
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.MediaFileService.MutateMediaFiles
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.ParentalStatusViewService.GetParentalStatusView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.PaymentsAccountService.ListPaymentsAccounts
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.ProductGroupViewService.GetProductGroupView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.RecommendationService.GetRecommendation
+    deadline: 600.0
+  - selector: google.ads.googleads.v0.services.RecommendationService.ApplyRecommendation
+    deadline: 600.0
+  - selector: google.ads.googleads.v0.services.RecommendationService.DismissRecommendation
+    deadline: 600.0
+  - selector: google.ads.googleads.v0.services.SearchTermViewService.GetSearchTermView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.TopicConstantService.GetTopicConstant
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.TopicViewService.GetTopicView
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.UserInterestService.GetUserInterest
+    deadline: 60.0
+  - selector: google.ads.googleads.v0.services.VideoService.GetVideo
+    deadline: 60.0

third_party/google/ads/googleads/v1/common/ad_asset.proto

@@ -0,0 +1,63 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/served_asset_field_type.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "AdAssetProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing assets used inside an ad.
+
+// A text asset used inside an ad.
+message AdTextAsset {
+  // Asset text.
+  google.protobuf.StringValue text = 1;
+
+  // The pinned field of the asset. This restricts the asset to only serve
+  // within this field. Multiple assets can be pinned to the same field. An
+  // asset that is unpinned or pinned to a different field will not serve in a
+  // field where some other asset has been pinned.
+  google.ads.googleads.v1.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType pinned_field = 2;
+}
+
+// An image asset used inside an ad.
+message AdImageAsset {
+  // The Asset resource name of this image.
+  google.protobuf.StringValue asset = 1;
+}
+
+// A video asset used inside an ad.
+message AdVideoAsset {
+  // The Asset resource name of this video.
+  google.protobuf.StringValue asset = 1;
+}
+
+// A media bundle asset used inside an ad.
+message AdMediaBundleAsset {
+  // The Asset resource name of this media bundle.
+  google.protobuf.StringValue asset = 1;
+}

third_party/google/ads/googleads/v1/common/ad_type_infos.proto

@@ -0,0 +1,571 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/common/ad_asset.proto";
+import "google/ads/googleads/v1/enums/call_conversion_reporting_state.proto";
+import "google/ads/googleads/v1/enums/display_ad_format_setting.proto";
+import "google/ads/googleads/v1/enums/display_upload_product_type.proto";
+import "google/ads/googleads/v1/enums/legacy_app_install_ad_app_store.proto";
+import "google/ads/googleads/v1/enums/mime_type.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "AdTypeInfosProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file containing info messages for specific ad types.
+
+// A text ad.
+message TextAdInfo {
+  // The headline of the ad.
+  google.protobuf.StringValue headline = 1;
+
+  // The first line of the ad's description.
+  google.protobuf.StringValue description1 = 2;
+
+  // The second line of the ad's description.
+  google.protobuf.StringValue description2 = 3;
+}
+
+// An expanded text ad.
+message ExpandedTextAdInfo {
+  // The first part of the ad's headline.
+  google.protobuf.StringValue headline_part1 = 1;
+
+  // The second part of the ad's headline.
+  google.protobuf.StringValue headline_part2 = 2;
+
+  // The third part of the ad's headline.
+  google.protobuf.StringValue headline_part3 = 6;
+
+  // The description of the ad.
+  google.protobuf.StringValue description = 3;
+
+  // The second description of the ad.
+  google.protobuf.StringValue description2 = 7;
+
+  // The text that can appear alongside the ad's displayed URL.
+  google.protobuf.StringValue path1 = 4;
+
+  // Additional text that can appear alongside the ad's displayed URL.
+  google.protobuf.StringValue path2 = 5;
+}
+
+// A call-only ad.
+message CallOnlyAdInfo {
+  // The country code in the ad.
+  google.protobuf.StringValue country_code = 1;
+
+  // The phone number in the ad.
+  google.protobuf.StringValue phone_number = 2;
+
+  // The business name in the ad.
+  google.protobuf.StringValue business_name = 3;
+
+  // First headline in the ad.
+  google.protobuf.StringValue headline1 = 11;
+
+  // Second headline in the ad.
+  google.protobuf.StringValue headline2 = 12;
+
+  // The first line of the ad's description.
+  google.protobuf.StringValue description1 = 4;
+
+  // The second line of the ad's description.
+  google.protobuf.StringValue description2 = 5;
+
+  // Whether to enable call tracking for the creative. Enabling call
+  // tracking also enables call conversions.
+  google.protobuf.BoolValue call_tracked = 6;
+
+  // Whether to disable call conversion for the creative.
+  // If set to `true`, disables call conversions even when `call_tracked` is
+  // `true`.
+  // If `call_tracked` is `false`, this field is ignored.
+  google.protobuf.BoolValue disable_call_conversion = 7;
+
+  // The URL to be used for phone number verification.
+  google.protobuf.StringValue phone_number_verification_url = 8;
+
+  // The conversion action to attribute a call conversion to. If not set a
+  // default conversion action is used. This field only has effect if
+  // call_tracked is set to true. Otherwise this field is ignored.
+  google.protobuf.StringValue conversion_action = 9;
+
+  // The call conversion behavior of this call only ad. It can use its own call
+  // conversion setting, inherit the account level setting, or be disabled.
+  google.ads.googleads.v1.enums.CallConversionReportingStateEnum.CallConversionReportingState conversion_reporting_state = 10;
+}
+
+// An expanded dynamic search ad.
+message ExpandedDynamicSearchAdInfo {
+  // The description of the ad.
+  google.protobuf.StringValue description = 1;
+}
+
+// A hotel ad.
+message HotelAdInfo {
+
+}
+
+// A Smart Shopping ad.
+message ShoppingSmartAdInfo {
+
+}
+
+// A standard Shopping ad.
+message ShoppingProductAdInfo {
+
+}
+
+// A Gmail ad.
+message GmailAdInfo {
+  // The Gmail teaser.
+  GmailTeaser teaser = 1;
+
+  // The MediaFile resource name of the header image. Valid image types are GIF,
+  // JPEG and PNG. The minimum size is 300x100 pixels and the aspect ratio must
+  // be between 3:1 and 5:1 (+-1%).
+  google.protobuf.StringValue header_image = 2;
+
+  // The MediaFile resource name of the marketing image. Valid image types are
+  // GIF, JPEG and PNG. The image must either be landscape with a minimum size
+  // of 600x314 pixels and aspect ratio of 600:314 (+-1%) or square with a
+  // minimum size of 300x300 pixels and aspect ratio of 1:1 (+-1%)
+  google.protobuf.StringValue marketing_image = 3;
+
+  // Headline of the marketing image.
+  google.protobuf.StringValue marketing_image_headline = 4;
+
+  // Description of the marketing image.
+  google.protobuf.StringValue marketing_image_description = 5;
+
+  // Display-call-to-action of the marketing image.
+  DisplayCallToAction marketing_image_display_call_to_action = 6;
+
+  // Product images. Up to 15 images are supported.
+  repeated ProductImage product_images = 7;
+
+  // Product videos. Up to 7 videos are supported. At least one product video
+  // or a marketing image must be specified.
+  repeated ProductVideo product_videos = 8;
+}
+
+// Gmail teaser data. The teaser is a small header that acts as an invitation
+// to view the rest of the ad (the body).
+message GmailTeaser {
+  // Headline of the teaser.
+  google.protobuf.StringValue headline = 1;
+
+  // Description of the teaser.
+  google.protobuf.StringValue description = 2;
+
+  // Business name of the advertiser.
+  google.protobuf.StringValue business_name = 3;
+
+  // The MediaFile resource name of the logo image. Valid image types are GIF,
+  // JPEG and PNG. The minimum size is 144x144 pixels and the aspect ratio must
+  // be 1:1 (+-1%).
+  google.protobuf.StringValue logo_image = 4;
+}
+
+// Data for display call to action. The call to action is a piece of the ad
+// that prompts the user to do something. Like clicking a link or making a phone
+// call.
+message DisplayCallToAction {
+  // Text for the display-call-to-action.
+  google.protobuf.StringValue text = 1;
+
+  // Text color for the display-call-to-action in hexadecimal, e.g. #ffffff for
+  // white.
+  google.protobuf.StringValue text_color = 2;
+
+  // Identifies the url collection in the ad.url_collections field. If not set
+  // the url defaults to final_url.
+  google.protobuf.StringValue url_collection_id = 3;
+}
+
+// Product image specific data.
+message ProductImage {
+  // The MediaFile resource name of the product image. Valid image types are
+  // GIF, JPEG and PNG. The minimum size is 300x300 pixels and the aspect ratio
+  // must be 1:1 (+-1%).
+  google.protobuf.StringValue product_image = 1;
+
+  // Description of the product.
+  google.protobuf.StringValue description = 2;
+
+  // Display-call-to-action of the product image.
+  DisplayCallToAction display_call_to_action = 3;
+}
+
+// Product video specific data.
+message ProductVideo {
+  // The MediaFile resource name of a video which must be hosted on YouTube.
+  google.protobuf.StringValue product_video = 1;
+}
+
+// An image ad.
+message ImageAdInfo {
+  // Width in pixels of the full size image.
+  google.protobuf.Int64Value pixel_width = 4;
+
+  // Height in pixels of the full size image.
+  google.protobuf.Int64Value pixel_height = 5;
+
+  // URL of the full size image.
+  google.protobuf.StringValue image_url = 6;
+
+  // Width in pixels of the preview size image.
+  google.protobuf.Int64Value preview_pixel_width = 7;
+
+  // Height in pixels of the preview size image.
+  google.protobuf.Int64Value preview_pixel_height = 8;
+
+  // URL of the preview size image.
+  google.protobuf.StringValue preview_image_url = 9;
+
+  // The mime type of the image.
+  google.ads.googleads.v1.enums.MimeTypeEnum.MimeType mime_type = 10;
+
+  // The name of the image. If the image was created from a MediaFile, this is
+  // the MediaFile's name. If the image was created from bytes, this is empty.
+  google.protobuf.StringValue name = 11;
+
+  // The image to create the ImageAd from. This can be specified in one of
+  // two ways.
+  // 1. An existing MediaFile resource.
+  // 2. The raw image data as bytes.
+  oneof image {
+    // The MediaFile resource to use for the image.
+    google.protobuf.StringValue media_file = 1;
+
+    // Raw image data as bytes.
+    google.protobuf.BytesValue data = 2;
+
+    // An ad ID to copy the image from.
+    google.protobuf.Int64Value ad_id_to_copy_image_from = 3;
+  }
+}
+
+// Representation of video bumper in-stream ad format (very short in-stream
+// non-skippable video ad).
+message VideoBumperInStreamAdInfo {
+
+}
+
+// Representation of video non-skippable in-stream ad format (15 second
+// in-stream non-skippable video ad).
+message VideoNonSkippableInStreamAdInfo {
+
+}
+
+// Representation of video TrueView in-stream ad format (ad shown during video
+// playback, often at beginning, which displays a skip button a few seconds into
+// the video).
+message VideoTrueViewInStreamAdInfo {
+  // Label on the CTA (call-to-action) button taking the user to the video ad's
+  // final URL.
+  // Required for TrueView for action campaigns, optional otherwise.
+  google.protobuf.StringValue action_button_label = 1;
+
+  // Additional text displayed with the CTA (call-to-action) button to give
+  // context and encourage clicking on the button.
+  google.protobuf.StringValue action_headline = 2;
+
+  // The MediaFile resource name of the companion banner used with the ad.
+  google.protobuf.StringValue companion_banner = 3;
+}
+
+// Representation of video out-stream ad format (ad shown alongside a feed
+// with automatic playback, without sound).
+message VideoOutstreamAdInfo {
+  // The headline of the ad.
+  google.protobuf.StringValue headline = 1;
+
+  // The description line.
+  google.protobuf.StringValue description = 2;
+}
+
+// A video ad.
+message VideoAdInfo {
+  // The MediaFile resource to use for the video.
+  google.protobuf.StringValue media_file = 1;
+
+  // Format-specific schema for the different video formats.
+  oneof format {
+    // Video TrueView in-stream ad format.
+    VideoTrueViewInStreamAdInfo in_stream = 2;
+
+    // Video bumper in-stream ad format.
+    VideoBumperInStreamAdInfo bumper = 3;
+
+    // Video out-stream ad format.
+    VideoOutstreamAdInfo out_stream = 4;
+
+    // Video non-skippable in-stream ad format.
+    VideoNonSkippableInStreamAdInfo non_skippable = 5;
+  }
+}
+
+// A responsive search ad.
+//
+// Responsive search ads let you create an ad that adapts to show more text, and
+// more relevant messages, to your customers. Enter multiple headlines and
+// descriptions when creating a responsive search ad, and over time, Google Ads
+// will automatically test different combinations and learn which combinations
+// perform best. By adapting your ad's content to more closely match potential
+// customers' search terms, responsive search ads may improve your campaign's
+// performance.
+//
+// More information at https://support.google.com/google-ads/answer/7684791
+message ResponsiveSearchAdInfo {
+  // List of text assets for headlines. When the ad serves the headlines will
+  // be selected from this list.
+  repeated AdTextAsset headlines = 1;
+
+  // List of text assets for descriptions. When the ad serves the descriptions
+  // will be selected from this list.
+  repeated AdTextAsset descriptions = 2;
+
+  // First part of text that may appear appended to the url displayed in the ad.
+  google.protobuf.StringValue path1 = 3;
+
+  // Second part of text that may appear appended to the url displayed in the
+  // ad. This field can only be set when path1 is also set.
+  google.protobuf.StringValue path2 = 4;
+}
+
+// A legacy responsive display ad. Ads of this type are labeled 'Responsive ads'
+// in the Google Ads UI.
+message LegacyResponsiveDisplayAdInfo {
+  // The short version of the ad's headline.
+  google.protobuf.StringValue short_headline = 1;
+
+  // The long version of the ad's headline.
+  google.protobuf.StringValue long_headline = 2;
+
+  // The description of the ad.
+  google.protobuf.StringValue description = 3;
+
+  // The business name in the ad.
+  google.protobuf.StringValue business_name = 4;
+
+  // Advertiser's consent to allow flexible color. When true, the ad may be
+  // served with different color if necessary. When false, the ad will be served
+  // with the specified colors or a neutral color.
+  // The default value is true.
+  // Must be true if main_color and accent_color are not set.
+  google.protobuf.BoolValue allow_flexible_color = 5;
+
+  // The accent color of the ad in hexadecimal, e.g. #ffffff for white.
+  // If one of main_color and accent_color is set, the other is required as
+  // well.
+  google.protobuf.StringValue accent_color = 6;
+
+  // The main color of the ad in hexadecimal, e.g. #ffffff for white.
+  // If one of main_color and accent_color is set, the other is required as
+  // well.
+  google.protobuf.StringValue main_color = 7;
+
+  // The call-to-action text for the ad.
+  google.protobuf.StringValue call_to_action_text = 8;
+
+  // The MediaFile resource name of the logo image used in the ad.
+  google.protobuf.StringValue logo_image = 9;
+
+  // The MediaFile resource name of the square logo image used in the ad.
+  google.protobuf.StringValue square_logo_image = 10;
+
+  // The MediaFile resource name of the marketing image used in the ad.
+  google.protobuf.StringValue marketing_image = 11;
+
+  // The MediaFile resource name of the square marketing image used in the ad.
+  google.protobuf.StringValue square_marketing_image = 12;
+
+  // Specifies which format the ad will be served in. Default is ALL_FORMATS.
+  google.ads.googleads.v1.enums.DisplayAdFormatSettingEnum.DisplayAdFormatSetting format_setting = 13;
+
+  // Prefix before price. E.g. 'as low as'.
+  google.protobuf.StringValue price_prefix = 14;
+
+  // Promotion text used for dyanmic formats of responsive ads. For example
+  // 'Free two-day shipping'.
+  google.protobuf.StringValue promo_text = 15;
+}
+
+// An app ad.
+message AppAdInfo {
+  // An optional text asset that, if specified, must always be displayed when
+  // the ad is served.
+  AdTextAsset mandatory_ad_text = 1;
+
+  // List of text assets for headlines. When the ad serves the headlines will
+  // be selected from this list.
+  repeated AdTextAsset headlines = 2;
+
+  // List of text assets for descriptions. When the ad serves the descriptions
+  // will be selected from this list.
+  repeated AdTextAsset descriptions = 3;
+
+  // List of image assets that may be displayed with the ad.
+  repeated AdImageAsset images = 4;
+
+  // List of YouTube video assets that may be displayed with the ad.
+  repeated AdVideoAsset youtube_videos = 5;
+
+  // List of media bundle assets that may be used with the ad.
+  repeated AdMediaBundleAsset html5_media_bundles = 6;
+}
+
+// App engagement ads allow you to write text encouraging a specific action in
+// the app, like checking in, making a purchase, or booking a flight.
+// They allow you to send users to a specific part of your app where they can
+// find what they're looking for easier and faster.
+message AppEngagementAdInfo {
+  // List of text assets for headlines. When the ad serves the headlines will
+  // be selected from this list.
+  repeated AdTextAsset headlines = 1;
+
+  // List of text assets for descriptions. When the ad serves the descriptions
+  // will be selected from this list.
+  repeated AdTextAsset descriptions = 2;
+
+  // List of image assets that may be displayed with the ad.
+  repeated AdImageAsset images = 3;
+
+  // List of video assets that may be displayed with the ad.
+  repeated AdVideoAsset videos = 4;
+}
+
+// A legacy app install ad that only can be used by a few select customers.
+message LegacyAppInstallAdInfo {
+  // The id of the mobile app.
+  google.protobuf.StringValue app_id = 1;
+
+  // The app store the mobile app is available in.
+  google.ads.googleads.v1.enums.LegacyAppInstallAdAppStoreEnum.LegacyAppInstallAdAppStore app_store = 2;
+
+  // The headline of the ad.
+  google.protobuf.StringValue headline = 3;
+
+  // The first description line of the ad.
+  google.protobuf.StringValue description1 = 4;
+
+  // The second description line of the ad.
+  google.protobuf.StringValue description2 = 5;
+}
+
+// A responsive display ad.
+message ResponsiveDisplayAdInfo {
+  // Marketing images to be used in the ad. Valid image types are GIF,
+  // JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must
+  // be 1.91:1 (+-1%). At least one marketing_image is required. Combined with
+  // square_marketing_images the maximum is 15.
+  repeated AdImageAsset marketing_images = 1;
+
+  // Square marketing images to be used in the ad. Valid image types are GIF,
+  // JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must
+  // be 1:1 (+-1%). At least one square marketing_image is required. Combined
+  // with marketing_images the maximum is 15.
+  repeated AdImageAsset square_marketing_images = 2;
+
+  // Logo images to be used in the ad. Valid image types are GIF,
+  // JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must
+  // be 4:1 (+-1%). Combined with square_logo_images the maximum is 5.
+  repeated AdImageAsset logo_images = 3;
+
+  // Square logo images to be used in the ad. Valid image types are GIF,
+  // JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must
+  // be 1:1 (+-1%). Combined with square_logo_images the maximum is 5.
+  repeated AdImageAsset square_logo_images = 4;
+
+  // Short format headlines for the ad. The maximum length is 30 characters.
+  // At least 1 and max 5 headlines can be specified.
+  repeated AdTextAsset headlines = 5;
+
+  // A required long format headline. The maximum length is 90 characters.
+  AdTextAsset long_headline = 6;
+
+  // Descriptive texts for the ad. The maximum length is 90 characters. At
+  // least 1 and max 5 headlines can be specified.
+  repeated AdTextAsset descriptions = 7;
+
+  // Optional YouTube vidoes for the ad. A maximum of 5 videos can be specified.
+  repeated AdVideoAsset youtube_videos = 8;
+
+  // The advertiser/brand name. Maximum display width is 25.
+  google.protobuf.StringValue business_name = 9;
+
+  // The main color of the ad in hexadecimal, e.g. #ffffff for white.
+  // If one of main_color and accent_color is set, the other is required as
+  // well.
+  google.protobuf.StringValue main_color = 10;
+
+  // The accent color of the ad in hexadecimal, e.g. #ffffff for white.
+  // If one of main_color and accent_color is set, the other is required as
+  // well.
+  google.protobuf.StringValue accent_color = 11;
+
+  // Advertiser's consent to allow flexible color. When true, the ad may be
+  // served with different color if necessary. When false, the ad will be served
+  // with the specified colors or a neutral color.
+  // The default value is true.
+  // Must be true if main_color and accent_color are not set.
+  google.protobuf.BoolValue allow_flexible_color = 12;
+
+  // The call-to-action text for the ad. Maximum display width is 30.
+  google.protobuf.StringValue call_to_action_text = 13;
+
+  // Prefix before price. E.g. 'as low as'.
+  google.protobuf.StringValue price_prefix = 14;
+
+  // Promotion text used for dyanmic formats of responsive ads. For example
+  // 'Free two-day shipping'.
+  google.protobuf.StringValue promo_text = 15;
+
+  // Specifies which format the ad will be served in. Default is ALL_FORMATS.
+  google.ads.googleads.v1.enums.DisplayAdFormatSettingEnum.DisplayAdFormatSetting format_setting = 16;
+}
+
+// A generic type of display ad. The exact ad format is controlled by the
+// display_upload_product_type field, which determines what kinds of data
+// need to be included with the ad.
+message DisplayUploadAdInfo {
+  // The product type of this ad. See comments on the enum for details.
+  google.ads.googleads.v1.enums.DisplayUploadProductTypeEnum.DisplayUploadProductType display_upload_product_type = 1;
+
+  // The asset data that makes up the ad.
+  oneof media_asset {
+    // A media bundle asset to be used in the ad. For information about the
+    // media bundle for HTML5_UPLOAD_AD see
+    // https://support.google.com/google-ads/answer/1722096
+    // Media bundles that are part of dynamic product types use a special format
+    // that needs to be created through the Google Web Designer. See
+    // https://support.google.com/webdesigner/answer/7543898 for more
+    // information.
+    AdMediaBundleAsset media_bundle = 2;
+  }
+}

third_party/google/ads/googleads/v1/common/asset_types.proto

@@ -0,0 +1,82 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/mime_type.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "AssetTypesProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file containing info messages for specific asset types.
+
+// A YouTube asset.
+message YoutubeVideoAsset {
+  // YouTube video id. This is the 11 character string value used in the
+  // YouTube video URL.
+  google.protobuf.StringValue youtube_video_id = 1;
+}
+
+// A MediaBundle asset.
+message MediaBundleAsset {
+  // Media bundle (ZIP file) asset data. The format of the uploaded ZIP file
+  // depends on the ad field where it will be used. For more information on the
+  // format, see the documentation of the ad field where you plan on using the
+  // MediaBundleAsset. This field is mutate only.
+  google.protobuf.BytesValue data = 1;
+}
+
+// An Image asset.
+message ImageAsset {
+  // The raw bytes data of an image. This field is mutate only.
+  google.protobuf.BytesValue data = 1;
+
+  // File size of the image asset in bytes.
+  google.protobuf.Int64Value file_size = 2;
+
+  // MIME type of the image asset.
+  google.ads.googleads.v1.enums.MimeTypeEnum.MimeType mime_type = 3;
+
+  // Metadata for this image at its original size.
+  ImageDimension full_size = 4;
+}
+
+// Metadata for an image at a certain size, either original or resized.
+message ImageDimension {
+  // Height of the image.
+  google.protobuf.Int64Value height_pixels = 1;
+
+  // Width of the image.
+  google.protobuf.Int64Value width_pixels = 2;
+
+  // A URL that returns the image with this height and width.
+  google.protobuf.StringValue url = 3;
+}
+
+// A Text asset.
+message TextAsset {
+  // Text content of the text asset.
+  google.protobuf.StringValue text = 1;
+}

third_party/google/ads/googleads/v1/common/bidding.proto

@@ -0,0 +1,232 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/page_one_promoted_strategy_goal.proto";
+import "google/ads/googleads/v1/enums/target_impression_share_location.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "BiddingProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing bidding schemes.
+
+// Commission is an automatic bidding strategy in which the advertiser pays a
+// certain portion of the conversion value.
+message Commission {
+  // Commission rate defines the portion of the conversion value that the
+  // advertiser will be billed. A commission rate of x should be passed into
+  // this field as (x * 1,000,000). For example, 106,000 represents a commission
+  // rate of 0.106 (10.6%).
+  google.protobuf.Int64Value commission_rate_micros = 1;
+}
+
+// An automated bidding strategy that raises bids for clicks
+// that seem more likely to lead to a conversion and lowers
+// them for clicks where they seem less likely.
+message EnhancedCpc {
+
+}
+
+// Manual click-based bidding where user pays per click.
+message ManualCpc {
+  // Whether bids are to be enhanced based on conversion optimizer data.
+  google.protobuf.BoolValue enhanced_cpc_enabled = 1;
+}
+
+// Manual impression-based bidding where user pays per thousand impressions.
+message ManualCpm {
+
+}
+
+// View based bidding where user pays per video view.
+message ManualCpv {
+
+}
+
+// An automated bidding strategy that sets bids to help get the most conversions
+// for your campaign while spending your budget.
+message MaximizeConversions {
+
+}
+
+// An automated bidding strategy which tries to maximize conversion value
+// given a daily budget.
+message MaximizeConversionValue {
+  // The target return on ad spend (ROAS) option. If set, the bid strategy will
+  // maximize revenue while averaging the target return on ad spend. If the
+  // target ROAS is high, the bid strategy may not be able to spend the full
+  // budget. If the target ROAS is not set, the bid strategy will aim to
+  // achieve the highest possible ROAS for the budget.
+  google.protobuf.DoubleValue target_roas = 1;
+}
+
+// An automated bidding strategy which sets CPC bids to target impressions on
+// page one, or page one promoted slots on google.com.
+message PageOnePromoted {
+  // The strategy goal of where impressions are desired to be shown on
+  // search result pages.
+  google.ads.googleads.v1.enums.PageOnePromotedStrategyGoalEnum.PageOnePromotedStrategyGoal strategy_goal = 1;
+
+  // Maximum bid limit that can be set by the bid strategy.
+  // The limit applies to all keywords managed by the strategy.
+  google.protobuf.Int64Value cpc_bid_ceiling_micros = 2;
+
+  // Bid multiplier to be applied to the relevant bid estimate (depending on
+  // the `strategy_goal`) in determining a keyword's new CPC bid.
+  google.protobuf.DoubleValue bid_modifier = 3;
+
+  // Whether the strategy should always follow bid estimate changes, or only
+  // increase.
+  // If false, always sets a keyword's new bid to the current bid estimate.
+  // If true, only updates a keyword's bid if the current bid estimate is
+  // greater than the current bid.
+  google.protobuf.BoolValue only_raise_cpc_bids = 4;
+
+  // Whether the strategy is allowed to raise bids when the throttling
+  // rate of the budget it is serving out of rises above a threshold.
+  google.protobuf.BoolValue raise_cpc_bid_when_budget_constrained = 5;
+
+  // Whether the strategy is allowed to raise bids on keywords with
+  // lower-range quality scores.
+  google.protobuf.BoolValue raise_cpc_bid_when_quality_score_is_low = 6;
+}
+
+// An automated bid strategy that sets bids to help get as many conversions as
+// possible at the target cost-per-acquisition (CPA) you set.
+message TargetCpa {
+  // Average CPA target.
+  // This target should be greater than or equal to minimum billable unit based
+  // on the currency for the account.
+  google.protobuf.Int64Value target_cpa_micros = 1;
+
+  // Maximum bid limit that can be set by the bid strategy.
+  // The limit applies to all keywords managed by the strategy.
+  google.protobuf.Int64Value cpc_bid_ceiling_micros = 2;
+
+  // Minimum bid limit that can be set by the bid strategy.
+  // The limit applies to all keywords managed by the strategy.
+  google.protobuf.Int64Value cpc_bid_floor_micros = 3;
+}
+
+// Target CPM (cost per thousand impressions) is an automated bidding strategy
+// that sets bids to optimize performance given the target CPM you set.
+message TargetCpm {
+
+}
+
+// An automated bidding strategy that sets bids so that a certain percentage of
+// search ads are shown at the top of the first page (or other targeted
+// location).
+// Next Id = 4
+message TargetImpressionShare {
+  // The targeted location on the search results page.
+  google.ads.googleads.v1.enums.TargetImpressionShareLocationEnum.TargetImpressionShareLocation location = 1;
+
+  // The desired fraction of ads to be shown in the targeted location in micros.
+  // E.g. 1% equals 10,000.
+  google.protobuf.Int64Value location_fraction_micros = 2;
+
+  // The highest CPC bid the automated bidding system is permitted to specify.
+  // This is a required field entered by the advertiser that sets the ceiling
+  // and specified in local micros.
+  google.protobuf.Int64Value cpc_bid_ceiling_micros = 3;
+}
+
+// An automated bidding strategy that sets bids based on the target fraction of
+// auctions where the advertiser should outrank a specific competitor.
+message TargetOutrankShare {
+  // The target fraction of auctions where the advertiser should outrank the
+  // competitor.
+  // The advertiser outranks the competitor in an auction if either the
+  // advertiser appears above the competitor in the search results, or appears
+  // in the search results when the competitor does not.
+  // Value must be between 1 and 1000000, inclusive.
+  google.protobuf.Int32Value target_outrank_share_micros = 1;
+
+  // Competitor's visible domain URL.
+  google.protobuf.StringValue competitor_domain = 2;
+
+  // Maximum bid limit that can be set by the bid strategy.
+  // The limit applies to all keywords managed by the strategy.
+  google.protobuf.Int64Value cpc_bid_ceiling_micros = 3;
+
+  // Whether the strategy should always follow bid estimate changes,
+  // or only increase.
+  // If false, always set a keyword's new bid to the current bid estimate.
+  // If true, only updates a keyword's bid if the current bid estimate is
+  // greater than the current bid.
+  google.protobuf.BoolValue only_raise_cpc_bids = 4;
+
+  // Whether the strategy is allowed to raise bids on keywords with
+  // lower-range quality scores.
+  google.protobuf.BoolValue raise_cpc_bid_when_quality_score_is_low = 5;
+}
+
+// An automated bidding strategy that helps you maximize revenue while
+// averaging a specific target return on ad spend (ROAS).
+message TargetRoas {
+  // Required. The desired revenue (based on conversion data) per unit of spend.
+  // Value must be between 0.01 and 1000.0, inclusive.
+  google.protobuf.DoubleValue target_roas = 1;
+
+  // Maximum bid limit that can be set by the bid strategy.
+  // The limit applies to all keywords managed by the strategy.
+  google.protobuf.Int64Value cpc_bid_ceiling_micros = 2;
+
+  // Minimum bid limit that can be set by the bid strategy.
+  // The limit applies to all keywords managed by the strategy.
+  google.protobuf.Int64Value cpc_bid_floor_micros = 3;
+}
+
+// An automated bid strategy that sets your bids to help get as many clicks
+// as possible within your budget.
+message TargetSpend {
+  // The spend target under which to maximize clicks.
+  // A TargetSpend bidder will attempt to spend the smaller of this value
+  // or the natural throttling spend amount.
+  // If not specified, the budget is used as the spend target.
+  google.protobuf.Int64Value target_spend_micros = 1;
+
+  // Maximum bid limit that can be set by the bid strategy.
+  // The limit applies to all keywords managed by the strategy.
+  google.protobuf.Int64Value cpc_bid_ceiling_micros = 2;
+}
+
+// A bidding strategy where bids are a fraction of the advertised price for
+// some good or service.
+message PercentCpc {
+  // Maximum bid limit that can be set by the bid strategy. This is
+  // an optional field entered by the advertiser and specified in local micros.
+  // Note: A zero value is interpreted in the same way as having bid_ceiling
+  // undefined.
+  google.protobuf.Int64Value cpc_bid_ceiling_micros = 1;
+
+  // Adjusts the bid for each auction upward or downward, depending on the
+  // likelihood of a conversion. Individual bids may exceed
+  // cpc_bid_ceiling_micros, but the average bid amount for a campaign should
+  // not.
+  google.protobuf.BoolValue enhanced_cpc_enabled = 2;
+}

third_party/google/ads/googleads/v1/common/click_location.proto

@@ -0,0 +1,50 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "ClickLocationProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing a ClickLocation.
+
+// Location criteria associated with a click.
+message ClickLocation {
+  // The city location criterion associated with the impression.
+  google.protobuf.StringValue city = 1;
+
+  // The country location criterion associated with the impression.
+  google.protobuf.StringValue country = 2;
+
+  // The metro location criterion associated with the impression.
+  google.protobuf.StringValue metro = 3;
+
+  // The most specific location criterion associated with the impression.
+  google.protobuf.StringValue most_specific = 4;
+
+  // The region location criterion associated with the impression.
+  google.protobuf.StringValue region = 5;
+}

third_party/google/ads/googleads/v1/common/criteria.proto

@@ -0,0 +1,594 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/age_range_type.proto";
+import "google/ads/googleads/v1/enums/app_payment_model_type.proto";
+import "google/ads/googleads/v1/enums/content_label_type.proto";
+import "google/ads/googleads/v1/enums/day_of_week.proto";
+import "google/ads/googleads/v1/enums/device.proto";
+import "google/ads/googleads/v1/enums/gender_type.proto";
+import "google/ads/googleads/v1/enums/hotel_date_selection_type.proto";
+import "google/ads/googleads/v1/enums/income_range_type.proto";
+import "google/ads/googleads/v1/enums/interaction_type.proto";
+import "google/ads/googleads/v1/enums/keyword_match_type.proto";
+import "google/ads/googleads/v1/enums/listing_custom_attribute_index.proto";
+import "google/ads/googleads/v1/enums/listing_group_type.proto";
+import "google/ads/googleads/v1/enums/location_group_radius_units.proto";
+import "google/ads/googleads/v1/enums/minute_of_hour.proto";
+import "google/ads/googleads/v1/enums/parental_status_type.proto";
+import "google/ads/googleads/v1/enums/preferred_content_type.proto";
+import "google/ads/googleads/v1/enums/product_bidding_category_level.proto";
+import "google/ads/googleads/v1/enums/product_channel.proto";
+import "google/ads/googleads/v1/enums/product_channel_exclusivity.proto";
+import "google/ads/googleads/v1/enums/product_condition.proto";
+import "google/ads/googleads/v1/enums/product_type_level.proto";
+import "google/ads/googleads/v1/enums/proximity_radius_units.proto";
+import "google/ads/googleads/v1/enums/webpage_condition_operand.proto";
+import "google/ads/googleads/v1/enums/webpage_condition_operator.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "CriteriaProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing criteria types.
+
+// A keyword criterion.
+message KeywordInfo {
+  // The text of the keyword (at most 80 characters and 10 words).
+  google.protobuf.StringValue text = 1;
+
+  // The match type of the keyword.
+  google.ads.googleads.v1.enums.KeywordMatchTypeEnum.KeywordMatchType match_type = 2;
+}
+
+// A placement criterion. This can be used to modify bids for sites when
+// targeting the content network.
+message PlacementInfo {
+  // URL of the placement.
+  //
+  // For example, "http://www.domain.com".
+  google.protobuf.StringValue url = 1;
+}
+
+// A mobile app category criterion.
+message MobileAppCategoryInfo {
+  // The mobile app category constant resource name.
+  google.protobuf.StringValue mobile_app_category_constant = 1;
+}
+
+// A mobile application criterion.
+message MobileApplicationInfo {
+  // A string that uniquely identifies a mobile application to Google Ads API.
+  // The format of this string is "{platform}-{platform_native_id}", where
+  // platform is "1" for iOS apps and "2" for Android apps, and where
+  // platform_native_id is the mobile application identifier native to the
+  // corresponding platform.
+  // For iOS, this native identifier is the 9 digit string that appears at the
+  // end of an App Store URL (e.g., "476943146" for "Flood-It! 2" whose App
+  // Store link is http://itunes.apple.com/us/app/flood-it!-2/id476943146).
+  // For Android, this native identifier is the application's package name
+  // (e.g., "com.labpixies.colordrips" for "Color Drips" given Google Play link
+  // https://play.google.com/store/apps/details?id=com.labpixies.colordrips).
+  // A well formed app id for Google Ads API would thus be "1-476943146" for iOS
+  // and "2-com.labpixies.colordrips" for Android.
+  // This field is required and must be set in CREATE operations.
+  google.protobuf.StringValue app_id = 2;
+
+  // Name of this mobile application.
+  google.protobuf.StringValue name = 3;
+}
+
+// A location criterion.
+message LocationInfo {
+  // The geo target constant resource name.
+  google.protobuf.StringValue geo_target_constant = 1;
+}
+
+// A device criterion.
+message DeviceInfo {
+  // Type of the device.
+  google.ads.googleads.v1.enums.DeviceEnum.Device type = 1;
+}
+
+// A preferred content criterion.
+message PreferredContentInfo {
+  // Type of the preferred content.
+  google.ads.googleads.v1.enums.PreferredContentTypeEnum.PreferredContentType type = 2;
+}
+
+// A listing group criterion.
+message ListingGroupInfo {
+  // Type of the listing group.
+  google.ads.googleads.v1.enums.ListingGroupTypeEnum.ListingGroupType type = 1;
+
+  // Dimension value with which this listing group is refining its parent.
+  // Undefined for the root group.
+  ListingDimensionInfo case_value = 2;
+
+  // Resource name of ad group criterion which is the parent listing group
+  // subdivision. Null for the root group.
+  google.protobuf.StringValue parent_ad_group_criterion = 3;
+}
+
+// A listing scope criterion.
+message ListingScopeInfo {
+  // Scope of the campaign criterion.
+  repeated ListingDimensionInfo dimensions = 2;
+}
+
+// Listing dimensions for listing group criterion.
+message ListingDimensionInfo {
+  // Dimension of one of the types below is always present.
+  oneof dimension {
+    // Brand of the listing.
+    ListingBrandInfo listing_brand = 1;
+
+    // Advertiser-specific hotel ID.
+    HotelIdInfo hotel_id = 2;
+
+    // Class of the hotel as a number of stars 1 to 5.
+    HotelClassInfo hotel_class = 3;
+
+    // Country or Region the hotel is located in.
+    HotelCountryRegionInfo hotel_country_region = 4;
+
+    // State the hotel is located in.
+    HotelStateInfo hotel_state = 5;
+
+    // City the hotel is located in.
+    HotelCityInfo hotel_city = 6;
+
+    // Listing custom attribute.
+    ListingCustomAttributeInfo listing_custom_attribute = 7;
+
+    // Bidding category of a product offer.
+    ProductBiddingCategoryInfo product_bidding_category = 13;
+
+    // Locality of a product offer.
+    ProductChannelInfo product_channel = 8;
+
+    // Availability of a product offer.
+    ProductChannelExclusivityInfo product_channel_exclusivity = 9;
+
+    // Condition of a product offer.
+    ProductConditionInfo product_condition = 10;
+
+    // Item id of a product offer.
+    ProductItemIdInfo product_item_id = 11;
+
+    // Type of a product offer.
+    ProductTypeInfo product_type = 12;
+
+    // Unknown dimension. Set when no other listing dimension is set.
+    UnknownListingDimensionInfo unknown_listing_dimension = 14;
+  }
+}
+
+// Brand of the listing.
+message ListingBrandInfo {
+  // String value of the listing brand.
+  google.protobuf.StringValue value = 1;
+}
+
+// Advertiser-specific hotel ID.
+message HotelIdInfo {
+  // String value of the hotel ID.
+  google.protobuf.StringValue value = 1;
+}
+
+// Class of the hotel as a number of stars 1 to 5.
+message HotelClassInfo {
+  // Long value of the hotel class.
+  google.protobuf.Int64Value value = 1;
+}
+
+// Country or Region the hotel is located in.
+message HotelCountryRegionInfo {
+  // The Geo Target Constant resource name.
+  google.protobuf.StringValue country_region_criterion = 1;
+}
+
+// State the hotel is located in.
+message HotelStateInfo {
+  // The Geo Target Constant resource name.
+  google.protobuf.StringValue state_criterion = 1;
+}
+
+// City the hotel is located in.
+message HotelCityInfo {
+  // The Geo Target Constant resource name.
+  google.protobuf.StringValue city_criterion = 1;
+}
+
+// Listing custom attribute.
+message ListingCustomAttributeInfo {
+  // String value of the listing custom attribute.
+  google.protobuf.StringValue value = 1;
+
+  // Indicates the index of the custom attribute.
+  google.ads.googleads.v1.enums.ListingCustomAttributeIndexEnum.ListingCustomAttributeIndex index = 2;
+}
+
+// Bidding category of a product offer.
+message ProductBiddingCategoryInfo {
+  // ID of the product bidding category.
+  //
+  // This ID is equivalent to the google_product_category ID as described in
+  // this article: https://support.google.com/merchants/answer/6324436.
+  google.protobuf.Int64Value id = 1;
+
+  // Two-letter upper-case country code of the product bidding category. It must
+  // match the campaign.shopping_setting.sales_country field.
+  google.protobuf.StringValue country_code = 2;
+
+  // Level of the product bidding category.
+  google.ads.googleads.v1.enums.ProductBiddingCategoryLevelEnum.ProductBiddingCategoryLevel level = 3;
+}
+
+// Locality of a product offer.
+message ProductChannelInfo {
+  // Value of the locality.
+  google.ads.googleads.v1.enums.ProductChannelEnum.ProductChannel channel = 1;
+}
+
+// Availability of a product offer.
+message ProductChannelExclusivityInfo {
+  // Value of the availability.
+  google.ads.googleads.v1.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity channel_exclusivity = 1;
+}
+
+// Condition of a product offer.
+message ProductConditionInfo {
+  // Value of the condition.
+  google.ads.googleads.v1.enums.ProductConditionEnum.ProductCondition condition = 1;
+}
+
+// Item id of a product offer.
+message ProductItemIdInfo {
+  // Value of the id.
+  google.protobuf.StringValue value = 1;
+}
+
+// Type of a product offer.
+message ProductTypeInfo {
+  // Value of the type.
+  google.protobuf.StringValue value = 1;
+
+  // Level of the type.
+  google.ads.googleads.v1.enums.ProductTypeLevelEnum.ProductTypeLevel level = 2;
+}
+
+// Unknown listing dimension.
+message UnknownListingDimensionInfo {
+
+}
+
+// Criterion for hotel date selection (default dates vs. user selected).
+message HotelDateSelectionTypeInfo {
+  // Type of the hotel date selection
+  google.ads.googleads.v1.enums.HotelDateSelectionTypeEnum.HotelDateSelectionType type = 1;
+}
+
+// Criterion for number of days prior to the stay the booking is being made.
+message HotelAdvanceBookingWindowInfo {
+  // Low end of the number of days prior to the stay.
+  google.protobuf.Int64Value min_days = 1;
+
+  // High end of the number of days prior to the stay.
+  google.protobuf.Int64Value max_days = 2;
+}
+
+// Criterion for length of hotel stay in nights.
+message HotelLengthOfStayInfo {
+  // Low end of the number of nights in the stay.
+  google.protobuf.Int64Value min_nights = 1;
+
+  // High end of the number of nights in the stay.
+  google.protobuf.Int64Value max_nights = 2;
+}
+
+// Criterion for day of the week the booking is for.
+message HotelCheckInDayInfo {
+  // The day of the week.
+  google.ads.googleads.v1.enums.DayOfWeekEnum.DayOfWeek day_of_week = 1;
+}
+
+// Criterion for Interaction Type.
+message InteractionTypeInfo {
+  // The interaction type.
+  google.ads.googleads.v1.enums.InteractionTypeEnum.InteractionType type = 1;
+}
+
+// Represents an AdSchedule criterion.
+//
+// AdSchedule is specified as the day of the week and a time interval
+// within which ads will be shown.
+//
+// No more than six AdSchedules can be added for the same day.
+message AdScheduleInfo {
+  // Minutes after the start hour at which this schedule starts.
+  //
+  // This field is required for CREATE operations and is prohibited on UPDATE
+  // operations.
+  google.ads.googleads.v1.enums.MinuteOfHourEnum.MinuteOfHour start_minute = 1;
+
+  // Minutes after the end hour at which this schedule ends. The schedule is
+  // exclusive of the end minute.
+  //
+  // This field is required for CREATE operations and is prohibited on UPDATE
+  // operations.
+  google.ads.googleads.v1.enums.MinuteOfHourEnum.MinuteOfHour end_minute = 2;
+
+  // Starting hour in 24 hour time.
+  // This field must be between 0 and 23, inclusive.
+  //
+  // This field is required for CREATE operations and is prohibited on UPDATE
+  // operations.
+  google.protobuf.Int32Value start_hour = 3;
+
+  // Ending hour in 24 hour time; 24 signifies end of the day.
+  // This field must be between 0 and 24, inclusive.
+  //
+  // This field is required for CREATE operations and is prohibited on UPDATE
+  // operations.
+  google.protobuf.Int32Value end_hour = 4;
+
+  // Day of the week the schedule applies to.
+  //
+  // This field is required for CREATE operations and is prohibited on UPDATE
+  // operations.
+  google.ads.googleads.v1.enums.DayOfWeekEnum.DayOfWeek day_of_week = 5;
+}
+
+// An age range criterion.
+message AgeRangeInfo {
+  // Type of the age range.
+  google.ads.googleads.v1.enums.AgeRangeTypeEnum.AgeRangeType type = 1;
+}
+
+// A gender criterion.
+message GenderInfo {
+  // Type of the gender.
+  google.ads.googleads.v1.enums.GenderTypeEnum.GenderType type = 1;
+}
+
+// An income range criterion.
+message IncomeRangeInfo {
+  // Type of the income range.
+  google.ads.googleads.v1.enums.IncomeRangeTypeEnum.IncomeRangeType type = 1;
+}
+
+// A parental status criterion.
+message ParentalStatusInfo {
+  // Type of the parental status.
+  google.ads.googleads.v1.enums.ParentalStatusTypeEnum.ParentalStatusType type = 1;
+}
+
+// A YouTube Video criterion.
+message YouTubeVideoInfo {
+  // YouTube video id as it appears on the YouTube watch page.
+  google.protobuf.StringValue video_id = 1;
+}
+
+// A YouTube Channel criterion.
+message YouTubeChannelInfo {
+  // The YouTube uploader channel id or the channel code of a YouTube channel.
+  google.protobuf.StringValue channel_id = 1;
+}
+
+// A User List criterion. Represents a user list that is defined by the
+// advertiser to be targeted.
+message UserListInfo {
+  // The User List resource name.
+  google.protobuf.StringValue user_list = 1;
+}
+
+// A Proximity criterion. The geo point and radius determine what geographical
+// area is included. The address is a description of the geo point that does
+// not affect ad serving.
+//
+// There are two ways to create a proximity. First, by setting an address
+// and radius. The geo point will be automatically computed. Second, by
+// setting a geo point and radius. The address is an optional label that won't
+// be validated.
+message ProximityInfo {
+  // Latitude and longitude.
+  GeoPointInfo geo_point = 1;
+
+  // The radius of the proximity.
+  google.protobuf.DoubleValue radius = 2;
+
+  // The unit of measurement of the radius. Default is KILOMETERS.
+  google.ads.googleads.v1.enums.ProximityRadiusUnitsEnum.ProximityRadiusUnits radius_units = 3;
+
+  // Full address.
+  AddressInfo address = 4;
+}
+
+// Geo point for proximity criterion.
+message GeoPointInfo {
+  // Micro degrees for the longitude.
+  google.protobuf.Int32Value longitude_in_micro_degrees = 1;
+
+  // Micro degrees for the latitude.
+  google.protobuf.Int32Value latitude_in_micro_degrees = 2;
+}
+
+// Address for proximity criterion.
+message AddressInfo {
+  // Postal code.
+  google.protobuf.StringValue postal_code = 1;
+
+  // Province or state code.
+  google.protobuf.StringValue province_code = 2;
+
+  // Country code.
+  google.protobuf.StringValue country_code = 3;
+
+  // Province or state name.
+  google.protobuf.StringValue province_name = 4;
+
+  // Street address line 1.
+  google.protobuf.StringValue street_address = 5;
+
+  // Street address line 2. This field is write-only. It is only used for
+  // calculating the longitude and latitude of an address when geo_point is
+  // empty.
+  google.protobuf.StringValue street_address2 = 6;
+
+  // Name of the city.
+  google.protobuf.StringValue city_name = 7;
+}
+
+// A topic criterion. Use topics to target or exclude placements in the
+// Google Display Network based on the category into which the placement falls
+// (for example, "Pets & Animals/Pets/Dogs").
+message TopicInfo {
+  // The Topic Constant resource name.
+  google.protobuf.StringValue topic_constant = 1;
+
+  // The category to target or exclude. Each subsequent element in the array
+  // describes a more specific sub-category. For example,
+  // "Pets & Animals", "Pets", "Dogs" represents the "Pets & Animals/Pets/Dogs"
+  // category.
+  repeated google.protobuf.StringValue path = 2;
+}
+
+// A language criterion.
+message LanguageInfo {
+  // The language constant resource name.
+  google.protobuf.StringValue language_constant = 1;
+}
+
+// An IpBlock criterion used for IP exclusions. We allow:
+//  - IPv4 and IPv6 addresses
+//  - individual addresses (192.168.0.1)
+//  - masks for individual addresses (192.168.0.1/32)
+//  - masks for Class C networks (192.168.0.1/24)
+message IpBlockInfo {
+  // The IP address of this IP block.
+  google.protobuf.StringValue ip_address = 1;
+}
+
+// Content Label for category exclusion.
+message ContentLabelInfo {
+  // Content label type, required for CREATE operations.
+  google.ads.googleads.v1.enums.ContentLabelTypeEnum.ContentLabelType type = 1;
+}
+
+// Represents a Carrier Criterion.
+message CarrierInfo {
+  // The Carrier constant resource name.
+  google.protobuf.StringValue carrier_constant = 1;
+}
+
+// Represents a particular interest-based topic to be targeted.
+message UserInterestInfo {
+  // The UserInterest resource name.
+  google.protobuf.StringValue user_interest_category = 1;
+}
+
+// Represents a criterion for targeting webpages of an advertiser's website.
+message WebpageInfo {
+  // The name of the criterion that is defined by this parameter. The name value
+  // will be used for identifying, sorting and filtering criteria with this type
+  // of parameters.
+  //
+  // This field is required for CREATE operations and is prohibited on UPDATE
+  // operations.
+  google.protobuf.StringValue criterion_name = 1;
+
+  // Conditions, or logical expressions, for webpage targeting. The list of
+  // webpage targeting conditions are and-ed together when evaluated
+  // for targeting.
+  //
+  // This field is required for CREATE operations and is prohibited on UPDATE
+  // operations.
+  repeated WebpageConditionInfo conditions = 2;
+}
+
+// Logical expression for targeting webpages of an advertiser's website.
+message WebpageConditionInfo {
+  // Operand of webpage targeting condition.
+  google.ads.googleads.v1.enums.WebpageConditionOperandEnum.WebpageConditionOperand operand = 1;
+
+  // Operator of webpage targeting condition.
+  google.ads.googleads.v1.enums.WebpageConditionOperatorEnum.WebpageConditionOperator operator = 2;
+
+  // Argument of webpage targeting condition.
+  google.protobuf.StringValue argument = 3;
+}
+
+// Represents an operating system version to be targeted.
+message OperatingSystemVersionInfo {
+  // The operating system version constant resource name.
+  google.protobuf.StringValue operating_system_version_constant = 1;
+}
+
+// An app payment model criterion.
+message AppPaymentModelInfo {
+  // Type of the app payment model.
+  google.ads.googleads.v1.enums.AppPaymentModelTypeEnum.AppPaymentModelType type = 1;
+}
+
+// A mobile device criterion.
+message MobileDeviceInfo {
+  // The mobile device constant resource name.
+  google.protobuf.StringValue mobile_device_constant = 1;
+}
+
+// A custom affinity criterion.
+// A criterion of this type is only targetable.
+message CustomAffinityInfo {
+  // The CustomInterest resource name.
+  google.protobuf.StringValue custom_affinity = 1;
+}
+
+// A custom intent criterion.
+// A criterion of this type is only targetable.
+message CustomIntentInfo {
+  // The CustomInterest resource name.
+  google.protobuf.StringValue custom_intent = 1;
+}
+
+// A radius around a list of locations specified via a feed.
+message LocationGroupInfo {
+  // Feed specifying locations for targeting.
+  // This is required and must be set in CREATE operations.
+  google.protobuf.StringValue feed = 1;
+
+  // Geo target constant(s) restricting the scope of the geographic area within
+  // the feed. Currently only one geo target constant is allowed.
+  repeated google.protobuf.StringValue geo_target_constants = 2;
+
+  // Distance in units specifying the radius around targeted locations.
+  // This is required and must be set in CREATE operations.
+  google.protobuf.Int64Value radius = 3;
+
+  // Unit of the radius, miles and meters supported currently.
+  // This is required and must be set in CREATE operations.
+  google.ads.googleads.v1.enums.LocationGroupRadiusUnitsEnum.LocationGroupRadiusUnits radius_units = 4;
+}

third_party/google/ads/googleads/v1/common/criterion_category_availability.proto

@@ -0,0 +1,84 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/advertising_channel_sub_type.proto";
+import "google/ads/googleads/v1/enums/advertising_channel_type.proto";
+import "google/ads/googleads/v1/enums/criterion_category_channel_availability_mode.proto";
+import "google/ads/googleads/v1/enums/criterion_category_locale_availability_mode.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "CriterionCategoryAvailabilityProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing criterion category availability information.
+
+// Information of category availability, per advertising channel.
+message CriterionCategoryAvailability {
+  // Channel types and subtypes that are available to the category.
+  CriterionCategoryChannelAvailability channel = 1;
+
+  // Locales that are available to the category for the channel.
+  repeated CriterionCategoryLocaleAvailability locale = 2;
+}
+
+// Information of advertising channel type and subtypes a category is available
+// in.
+message CriterionCategoryChannelAvailability {
+  // Format of the channel availability. Can be ALL_CHANNELS (the rest of the
+  // fields will not be set), CHANNEL_TYPE (only advertising_channel_type type
+  // will be set, the category is available to all sub types under it) or
+  // CHANNEL_TYPE_AND_SUBTYPES (advertising_channel_type,
+  // advertising_channel_sub_type, and include_default_channel_sub_type will all
+  // be set).
+  google.ads.googleads.v1.enums.CriterionCategoryChannelAvailabilityModeEnum.CriterionCategoryChannelAvailabilityMode availability_mode = 1;
+
+  // Channel type the category is available to.
+  google.ads.googleads.v1.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType advertising_channel_type = 2;
+
+  // Channel subtypes under the channel type the category is available to.
+  repeated google.ads.googleads.v1.enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType advertising_channel_sub_type = 3;
+
+  // Whether default channel sub type is included. For example,
+  // advertising_channel_type being DISPLAY and include_default_channel_sub_type
+  // being false means that the default display campaign where channel sub type
+  // is not set is not included in this availability configuration.
+  google.protobuf.BoolValue include_default_channel_sub_type = 4;
+}
+
+// Information about which locales a category is available in.
+message CriterionCategoryLocaleAvailability {
+  // Format of the locale availability. Can be LAUNCHED_TO_ALL (both country and
+  // language will be empty), COUNTRY (only country will be set), LANGUAGE (only
+  // language wil be set), COUNTRY_AND_LANGUAGE (both country and language will
+  // be set).
+  google.ads.googleads.v1.enums.CriterionCategoryLocaleAvailabilityModeEnum.CriterionCategoryLocaleAvailabilityMode availability_mode = 1;
+
+  // Code of the country.
+  google.protobuf.StringValue country_code = 2;
+
+  // Code of the language.
+  google.protobuf.StringValue language_code = 3;
+}

third_party/google/ads/googleads/v1/common/custom_parameter.proto

@@ -0,0 +1,42 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "CustomParameterProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing CustomParameter and operation
+
+// A mapping that can be used by custom parameter tags in a
+// `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
+message CustomParameter {
+  // The key matching the parameter tag name.
+  google.protobuf.StringValue key = 1;
+
+  // The value to be substituted.
+  google.protobuf.StringValue value = 2;
+}

third_party/google/ads/googleads/v1/common/dates.proto

@@ -0,0 +1,41 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "DatesProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing date range message.
+
+// A date range.
+message DateRange {
+  // The start date, in yyyy-mm-dd format.
+  google.protobuf.StringValue start_date = 1;
+
+  // The end date, in yyyy-mm-dd format.
+  google.protobuf.StringValue end_date = 2;
+}

third_party/google/ads/googleads/v1/common/explorer_auto_optimizer_setting.proto

@@ -0,0 +1,40 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "ExplorerAutoOptimizerSettingProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing ExplorerAutoOptimizerSetting
+
+// Settings for the
+// <a href="https://support.google.com/google-ads/answer/190596">
+// Display Campaign Optimizer</a>, initially termed "Explorer".
+message ExplorerAutoOptimizerSetting {
+  // Indicates whether the optimizer is turned on.
+  google.protobuf.BoolValue opt_in = 1;
+}

third_party/google/ads/googleads/v1/common/extensions.proto

@@ -0,0 +1,344 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/common/custom_parameter.proto";
+import "google/ads/googleads/v1/common/feed_common.proto";
+import "google/ads/googleads/v1/enums/app_store.proto";
+import "google/ads/googleads/v1/enums/call_conversion_reporting_state.proto";
+import "google/ads/googleads/v1/enums/price_extension_price_qualifier.proto";
+import "google/ads/googleads/v1/enums/price_extension_price_unit.proto";
+import "google/ads/googleads/v1/enums/price_extension_type.proto";
+import "google/ads/googleads/v1/enums/promotion_extension_discount_modifier.proto";
+import "google/ads/googleads/v1/enums/promotion_extension_occasion.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "ExtensionsProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing extension types.
+
+// Represents an App extension.
+message AppFeedItem {
+  // The visible text displayed when the link is rendered in an ad.
+  // The length of this string should be between 1 and 25, inclusive.
+  google.protobuf.StringValue link_text = 1;
+
+  // The store-specific ID for the target application.
+  // This string must not be empty.
+  google.protobuf.StringValue app_id = 2;
+
+  // The application store that the target application belongs to.
+  google.ads.googleads.v1.enums.AppStoreEnum.AppStore app_store = 3;
+
+  // A list of possible final URLs after all cross domain redirects.
+  repeated google.protobuf.StringValue final_urls = 4;
+
+  // A list of possible final mobile URLs after all cross domain redirects.
+  repeated google.protobuf.StringValue final_mobile_urls = 5;
+
+  // URL template for constructing a tracking URL. Default value is "{lpurl}".
+  google.protobuf.StringValue tracking_url_template = 6;
+
+  // A list of mappings to be used for substituting URL custom parameter tags in
+  // the tracking_url_template, final_urls, and/or final_mobile_urls.
+  repeated CustomParameter url_custom_parameters = 7;
+
+  // URL template for appending params to landing page URLs served with parallel
+  // tracking.
+  google.protobuf.StringValue final_url_suffix = 8;
+}
+
+// Represents a Call extension.
+message CallFeedItem {
+  // The advertiser's phone number to append to the ad.
+  // This string must not be empty.
+  google.protobuf.StringValue phone_number = 1;
+
+  // Uppercase two-letter country code of the advertiser's phone number.
+  // This string must not be empty.
+  google.protobuf.StringValue country_code = 2;
+
+  // Indicates whether call tracking is enabled. By default, call tracking is
+  // not enabled.
+  google.protobuf.BoolValue call_tracking_enabled = 3;
+
+  // The conversion action to attribute a call conversion to. If not set a
+  // default conversion action is used. This field only has effect if
+  // call_tracking_enabled is set to true. Otherwise this field is ignored.
+  google.protobuf.StringValue call_conversion_action = 4;
+
+  // If true, disable call conversion tracking. call_conversion_action should
+  // not be set if this is true. Optional.
+  google.protobuf.BoolValue call_conversion_tracking_disabled = 5;
+
+  // Enum value that indicates whether this call extension uses its own call
+  // conversion setting (or just have call conversion disabled), or following
+  // the account level setting.
+  google.ads.googleads.v1.enums.CallConversionReportingStateEnum.CallConversionReportingState call_conversion_reporting_state = 6;
+}
+
+// Represents a callout extension.
+message CalloutFeedItem {
+  // The callout text.
+  // The length of this string should be between 1 and 25, inclusive.
+  google.protobuf.StringValue callout_text = 1;
+}
+
+// Represents a location extension.
+message LocationFeedItem {
+  // The name of the business.
+  google.protobuf.StringValue business_name = 1;
+
+  // Line 1 of the business address.
+  google.protobuf.StringValue address_line_1 = 2;
+
+  // Line 2 of the business address.
+  google.protobuf.StringValue address_line_2 = 3;
+
+  // City of the business address.
+  google.protobuf.StringValue city = 4;
+
+  // Province of the business address.
+  google.protobuf.StringValue province = 5;
+
+  // Postal code of the business address.
+  google.protobuf.StringValue postal_code = 6;
+
+  // Country code of the business address.
+  google.protobuf.StringValue country_code = 7;
+
+  // Phone number of the business.
+  google.protobuf.StringValue phone_number = 8;
+}
+
+// Represents an affiliate location extension.
+message AffiliateLocationFeedItem {
+  // The name of the business.
+  google.protobuf.StringValue business_name = 1;
+
+  // Line 1 of the business address.
+  google.protobuf.StringValue address_line_1 = 2;
+
+  // Line 2 of the business address.
+  google.protobuf.StringValue address_line_2 = 3;
+
+  // City of the business address.
+  google.protobuf.StringValue city = 4;
+
+  // Province of the business address.
+  google.protobuf.StringValue province = 5;
+
+  // Postal code of the business address.
+  google.protobuf.StringValue postal_code = 6;
+
+  // Country code of the business address.
+  google.protobuf.StringValue country_code = 7;
+
+  // Phone number of the business.
+  google.protobuf.StringValue phone_number = 8;
+
+  // Id of the retail chain that is advertised as a seller of your product.
+  google.protobuf.Int64Value chain_id = 9;
+
+  // Name of chain.
+  google.protobuf.StringValue chain_name = 10;
+}
+
+// An extension that users can click on to send a text message to the
+// advertiser.
+message TextMessageFeedItem {
+  // The business name to prepend to the message text.
+  // This field is required.
+  google.protobuf.StringValue business_name = 1;
+
+  // Uppercase two-letter country code of the advertiser's phone number.
+  // This field is required.
+  google.protobuf.StringValue country_code = 2;
+
+  // The advertiser's phone number the message will be sent to. Required.
+  google.protobuf.StringValue phone_number = 3;
+
+  // The text to show in the ad.
+  // This field is required.
+  google.protobuf.StringValue text = 4;
+
+  // The message text populated in the messaging app.
+  google.protobuf.StringValue extension_text = 5;
+}
+
+// Represents a Price extension.
+message PriceFeedItem {
+  // Price extension type of this extension.
+  google.ads.googleads.v1.enums.PriceExtensionTypeEnum.PriceExtensionType type = 1;
+
+  // Price qualifier for all offers of this price extension.
+  google.ads.googleads.v1.enums.PriceExtensionPriceQualifierEnum.PriceExtensionPriceQualifier price_qualifier = 2;
+
+  // Tracking URL template for all offers of this price extension.
+  google.protobuf.StringValue tracking_url_template = 3;
+
+  // The code of the language used for this price extension.
+  google.protobuf.StringValue language_code = 4;
+
+  // The price offerings in this price extension.
+  repeated PriceOffer price_offerings = 5;
+
+  // URL template for appending params to landing page URLs served with parallel
+  // tracking.
+  google.protobuf.StringValue final_url_suffix = 6;
+}
+
+// Represents one price offer in a price extension.
+message PriceOffer {
+  // Header text of this offer.
+  google.protobuf.StringValue header = 1;
+
+  // Description text of this offer.
+  google.protobuf.StringValue description = 2;
+
+  // Price value of this offer.
+  Money price = 3;
+
+  // Price unit for this offer.
+  google.ads.googleads.v1.enums.PriceExtensionPriceUnitEnum.PriceExtensionPriceUnit unit = 4;
+
+  // A list of possible final URLs after all cross domain redirects.
+  repeated google.protobuf.StringValue final_urls = 5;
+
+  // A list of possible final mobile URLs after all cross domain redirects.
+  repeated google.protobuf.StringValue final_mobile_urls = 6;
+}
+
+// Represents a Promotion extension.
+message PromotionFeedItem {
+  // A freeform description of what the promotion is targeting.
+  // This field is required.
+  google.protobuf.StringValue promotion_target = 1;
+
+  // Enum that modifies the qualification of the discount.
+  google.ads.googleads.v1.enums.PromotionExtensionDiscountModifierEnum.PromotionExtensionDiscountModifier discount_modifier = 2;
+
+  // Start date of when the promotion is eligible to be redeemed.
+  google.protobuf.StringValue promotion_start_date = 7;
+
+  // End date of when the promotion is eligible to be redeemed.
+  google.protobuf.StringValue promotion_end_date = 8;
+
+  // The occasion the promotion was intended for.
+  // If an occasion is set, the redemption window will need to fall within
+  // the date range associated with the occasion.
+  google.ads.googleads.v1.enums.PromotionExtensionOccasionEnum.PromotionExtensionOccasion occasion = 9;
+
+  // A list of possible final URLs after all cross domain redirects.
+  // This field is required.
+  repeated google.protobuf.StringValue final_urls = 10;
+
+  // A list of possible final mobile URLs after all cross domain redirects.
+  repeated google.protobuf.StringValue final_mobile_urls = 11;
+
+  // URL template for constructing a tracking URL.
+  google.protobuf.StringValue tracking_url_template = 12;
+
+  // A list of mappings to be used for substituting URL custom parameter tags in
+  // the tracking_url_template, final_urls, and/or final_mobile_urls.
+  repeated CustomParameter url_custom_parameters = 13;
+
+  // URL template for appending params to landing page URLs served with parallel
+  // tracking.
+  google.protobuf.StringValue final_url_suffix = 14;
+
+  // The language of the promotion.
+  // Represented as BCP 47 language tag.
+  google.protobuf.StringValue language_code = 15;
+
+  // Discount type, can be percentage off or amount off.
+  oneof discount_type {
+    // Percentage off discount in the promotion in micros.
+    // One million is equivalent to one percent.
+    // Either this or money_off_amount is required.
+    google.protobuf.Int64Value percent_off = 3;
+
+    // Money amount off for discount in the promotion.
+    // Either this or percent_off is required.
+    Money money_amount_off = 4;
+  }
+
+  // Promotion trigger. Can be by promotion code or promo by eligible order
+  // amount.
+  oneof promotion_trigger {
+    // A code the user should use in order to be eligible for the promotion.
+    google.protobuf.StringValue promotion_code = 5;
+
+    // The amount the total order needs to be for the user to be eligible for
+    // the promotion.
+    Money orders_over_amount = 6;
+  }
+}
+
+// Represents a structured snippet extension.
+message StructuredSnippetFeedItem {
+  // The header of the snippet.
+  // This string must not be empty.
+  google.protobuf.StringValue header = 1;
+
+  // The values in the snippet.
+  // The maximum size of this collection is 10.
+  repeated google.protobuf.StringValue values = 2;
+}
+
+// Represents a sitelink extension.
+message SitelinkFeedItem {
+  // URL display text for the sitelink.
+  // The length of this string should be between 1 and 25, inclusive.
+  google.protobuf.StringValue link_text = 1;
+
+  // First line of the description for the sitelink.
+  // If this value is set, line2 must also be set.
+  // The length of this string should be between 0 and 35, inclusive.
+  google.protobuf.StringValue line1 = 2;
+
+  // Second line of the description for the sitelink.
+  // If this value is set, line1 must also be set.
+  // The length of this string should be between 0 and 35, inclusive.
+  google.protobuf.StringValue line2 = 3;
+
+  // A list of possible final URLs after all cross domain redirects.
+  repeated google.protobuf.StringValue final_urls = 4;
+
+  // A list of possible final mobile URLs after all cross domain redirects.
+  repeated google.protobuf.StringValue final_mobile_urls = 5;
+
+  // URL template for constructing a tracking URL.
+  google.protobuf.StringValue tracking_url_template = 6;
+
+  // A list of mappings to be used for substituting URL custom parameter tags in
+  // the tracking_url_template, final_urls, and/or final_mobile_urls.
+  repeated CustomParameter url_custom_parameters = 7;
+
+  // Final URL suffix to be appended to landing page URLs served with
+  // parallel tracking.
+  google.protobuf.StringValue final_url_suffix = 8;
+}

third_party/google/ads/googleads/v1/common/feed_common.proto

@@ -0,0 +1,41 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "FeedCommonProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing common feed proto messages.
+
+// Represents a price in a particular currency.
+message Money {
+  // Three-character ISO 4217 currency code.
+  google.protobuf.StringValue currency_code = 1;
+
+  // Amount in micros. One million is equivalent to one unit.
+  google.protobuf.Int64Value amount_micros = 2;
+}

third_party/google/ads/googleads/v1/common/final_app_url.proto

@@ -0,0 +1,48 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/app_url_operating_system_type.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "FinalAppUrlProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file FinalAppUrl type.
+
+// A URL for deep linking into an app for the given operating system.
+message FinalAppUrl {
+  // The operating system targeted by this URL. Required.
+  google.ads.googleads.v1.enums.AppUrlOperatingSystemTypeEnum.AppUrlOperatingSystemType os_type = 1;
+
+  // The app deep link URL. Deep links specify a location in an app that
+  // corresponds to the content you'd like to show, and should be of the form
+  // {scheme}://{host_path}
+  // The scheme identifies which app to open. For your app, you can use a custom
+  // scheme that starts with the app's name. The host and path specify the
+  // unique location in the app where your content exists.
+  // Example: "exampleapp://productid_1234". Required.
+  google.protobuf.StringValue url = 2;
+}

third_party/google/ads/googleads/v1/common/frequency_cap.proto

@@ -0,0 +1,63 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/frequency_cap_event_type.proto";
+import "google/ads/googleads/v1/enums/frequency_cap_level.proto";
+import "google/ads/googleads/v1/enums/frequency_cap_time_unit.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "FrequencyCapProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing frequency caps.
+
+// A rule specifying the maximum number of times an ad (or some set of ads) can
+// be shown to a user over a particular time period.
+message FrequencyCapEntry {
+  // The key of a particular frequency cap. There can be no more
+  // than one frequency cap with the same key.
+  FrequencyCapKey key = 1;
+
+  // Maximum number of events allowed during the time range by this cap.
+  google.protobuf.Int32Value cap = 2;
+}
+
+// A group of fields used as keys for a frequency cap.
+// There can be no more than one frequency cap with the same key.
+message FrequencyCapKey {
+  // The level on which the cap is to be applied (e.g. ad group ad, ad group).
+  // The cap is applied to all the entities of this level.
+  google.ads.googleads.v1.enums.FrequencyCapLevelEnum.FrequencyCapLevel level = 1;
+
+  // The type of event that the cap applies to (e.g. impression).
+  google.ads.googleads.v1.enums.FrequencyCapEventTypeEnum.FrequencyCapEventType event_type = 3;
+
+  // Unit of time the cap is defined at (e.g. day, week).
+  google.ads.googleads.v1.enums.FrequencyCapTimeUnitEnum.FrequencyCapTimeUnit time_unit = 2;
+
+  // Number of time units the cap lasts.
+  google.protobuf.Int32Value time_length = 4;
+}

third_party/google/ads/googleads/v1/common/keyword_plan_common.proto

@@ -0,0 +1,42 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/keyword_plan_competition_level.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "KeywordPlanCommonProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing Keyword Planner messages.
+
+// Historical metrics.
+message KeywordPlanHistoricalMetrics {
+  // Average monthly searches for the past 12 months.
+  google.protobuf.Int64Value avg_monthly_searches = 1;
+
+  // The competition level for the query.
+  google.ads.googleads.v1.enums.KeywordPlanCompetitionLevelEnum.KeywordPlanCompetitionLevel competition = 2;
+}

third_party/google/ads/googleads/v1/common/matching_function.proto

@@ -0,0 +1,128 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/matching_function_context_type.proto";
+import "google/ads/googleads/v1/enums/matching_function_operator.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "MatchingFunctionProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing a matching function.
+
+// Matching function associated with a
+// CustomerFeed, CampaignFeed, or AdGroupFeed. The matching function is used
+// to filter the set of feed items selected.
+message MatchingFunction {
+  // String representation of the Function.
+  //
+  // Examples:
+  // 1) IDENTITY(true) or IDENTITY(false). All or none feed items serve.
+  // 2) EQUALS(CONTEXT.DEVICE,"Mobile")
+  // 3) IN(FEED_ITEM_ID,{1000001,1000002,1000003})
+  // 4) CONTAINS_ANY(FeedAttribute[12345678,0],{"Mars cruise","Venus cruise"})
+  // 5) AND(IN(FEED_ITEM_ID,{10001,10002}),EQUALS(CONTEXT.DEVICE,"Mobile"))
+  // See
+  //
+  // https:
+  // //developers.google.com/adwords/api/docs/guides/feed-matching-functions
+  //
+  // Note that because multiple strings may represent the same underlying
+  // function (whitespace and single versus double quotation marks, for
+  // example), the value returned may not be identical to the string sent in a
+  // mutate request.
+  google.protobuf.StringValue function_string = 1;
+
+  // Operator for a function.
+  google.ads.googleads.v1.enums.MatchingFunctionOperatorEnum.MatchingFunctionOperator operator = 4;
+
+  // The operands on the left hand side of the equation. This is also the
+  // operand to be used for single operand expressions such as NOT.
+  repeated Operand left_operands = 2;
+
+  // The operands on the right hand side of the equation.
+  repeated Operand right_operands = 3;
+}
+
+// An operand in a matching function.
+message Operand {
+  // A constant operand in a matching function.
+  message ConstantOperand {
+    // Constant operand values. Required.
+    oneof constant_operand_value {
+      // String value of the operand if it is a string type.
+      google.protobuf.StringValue string_value = 1;
+
+      // Int64 value of the operand if it is a int64 type.
+      google.protobuf.Int64Value long_value = 2;
+
+      // Boolean value of the operand if it is a boolean type.
+      google.protobuf.BoolValue boolean_value = 3;
+
+      // Double value of the operand if it is a double type.
+      google.protobuf.DoubleValue double_value = 4;
+    }
+  }
+
+  // A feed attribute operand in a matching function.
+  // Used to represent a feed attribute in feed.
+  message FeedAttributeOperand {
+    // The associated feed. Required.
+    google.protobuf.Int64Value feed_id = 1;
+
+    // Id of the referenced feed attribute. Required.
+    google.protobuf.Int64Value feed_attribute_id = 2;
+  }
+
+  // A function operand in a matching function.
+  // Used to represent nested functions.
+  message FunctionOperand {
+    // The matching function held in this operand.
+    MatchingFunction matching_function = 1;
+  }
+
+  // An operand in a function referring to a value in the request context.
+  message RequestContextOperand {
+    // Type of value to be referred in the request context.
+    google.ads.googleads.v1.enums.MatchingFunctionContextTypeEnum.MatchingFunctionContextType context_type = 1;
+  }
+
+  // Different operands that can be used in a matching function. Required.
+  oneof function_argument_operand {
+    // A constant operand in a matching function.
+    ConstantOperand constant_operand = 1;
+
+    // This operand specifies a feed attribute in feed.
+    FeedAttributeOperand feed_attribute_operand = 2;
+
+    // A function operand in a matching function.
+    // Used to represent nested functions.
+    FunctionOperand function_operand = 3;
+
+    // An operand in a function referring to a value in the request context.
+    RequestContextOperand request_context_operand = 4;
+  }
+}

third_party/google/ads/googleads/v1/common/metrics.proto

@@ -0,0 +1,527 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/interaction_event_type.proto";
+import "google/ads/googleads/v1/enums/quality_score_bucket.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "MetricsProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing metrics.
+
+// Metrics data.
+message Metrics {
+  // The percent of your ad impressions that are shown as the very first ad
+  // above the organic search results.
+  google.protobuf.DoubleValue absolute_top_impression_percentage = 95;
+
+  // Average cost of viewable impressions (`active_view_impressions`).
+  google.protobuf.DoubleValue active_view_cpm = 1;
+
+  // Active view measurable clicks divided by active view viewable impressions.
+  // This metric is reported only for display network.
+  google.protobuf.DoubleValue active_view_ctr = 79;
+
+  // A measurement of how often your ad has become viewable on a Display
+  // Network site.
+  google.protobuf.Int64Value active_view_impressions = 2;
+
+  // The ratio of impressions that could be measured by Active View over the
+  // number of served impressions.
+  google.protobuf.DoubleValue active_view_measurability = 96;
+
+  // The cost of the impressions you received that were measurable by Active
+  // View.
+  google.protobuf.Int64Value active_view_measurable_cost_micros = 3;
+
+  // The number of times your ads are appearing on placements in positions
+  // where they can be seen.
+  google.protobuf.Int64Value active_view_measurable_impressions = 4;
+
+  // The percentage of time when your ad appeared on an Active View enabled site
+  // (measurable impressions) and was viewable (viewable impressions).
+  google.protobuf.DoubleValue active_view_viewability = 97;
+
+  // All conversions from interactions (as oppose to view through conversions)
+  // divided by the number of ad interactions.
+  google.protobuf.DoubleValue all_conversions_from_interactions_rate = 65;
+
+  // The total value of all conversions.
+  google.protobuf.DoubleValue all_conversions_value = 66;
+
+  // The total number of conversions. This only includes conversion actions
+  // which include_in_conversions_metric attribute is set to true.
+  google.protobuf.DoubleValue all_conversions = 7;
+
+  // The value of all conversions divided by the total cost of ad interactions
+  // (such as clicks for text ads or views for video ads).
+  google.protobuf.DoubleValue all_conversions_value_per_cost = 62;
+
+  // The number of times people clicked the "Call" button to call a store during
+  // or after clicking an ad. This number doesn’t include whether or not calls
+  // were connected, or the duration of any calls.
+  // This metric applies to feed items only.
+  google.protobuf.DoubleValue all_conversions_from_click_to_call = 118;
+
+  // The number of times people clicked a "Get directions" button to navigate to
+  // a store after clicking an ad.
+  // This metric applies to feed items only.
+  google.protobuf.DoubleValue all_conversions_from_directions = 119;
+
+  // The value of all conversions from interactions divided by the total number
+  // of interactions.
+  google.protobuf.DoubleValue all_conversions_from_interactions_value_per_interaction = 67;
+
+  // The number of times people clicked a link to view a store’s menu after
+  // clicking an ad.
+  // This metric applies to feed items only.
+  google.protobuf.DoubleValue all_conversions_from_menu = 120;
+
+  // The number of times people placed an order at a store after clicking an ad.
+  // This metric applies to feed items only.
+  google.protobuf.DoubleValue all_conversions_from_order = 121;
+
+  // The number of other conversions (for example, posting a review or saving a
+  // location for a store) that occurred after people clicked an ad.
+  // This metric applies to feed items only.
+  google.protobuf.DoubleValue all_conversions_from_other_engagement = 122;
+
+  // Estimated number of times people visited a store after clicking an ad.
+  // This metric applies to feed items only.
+  google.protobuf.DoubleValue all_conversions_from_store_visit = 123;
+
+  // The number of times that people were taken to a store's URL after clicking
+  // an ad.
+  // This metric applies to feed items only.
+  google.protobuf.DoubleValue all_conversions_from_store_website = 124;
+
+  // The average amount you pay per interaction. This amount is the total cost
+  // of your ads divided by the total number of interactions.
+  google.protobuf.DoubleValue average_cost = 8;
+
+  // The total cost of all clicks divided by the total number of clicks
+  // received.
+  google.protobuf.DoubleValue average_cpc = 9;
+
+  // The average amount that you've been charged for an ad engagement. This
+  // amount is the total cost of all ad engagements divided by the total number
+  // of ad engagements.
+  google.protobuf.DoubleValue average_cpe = 98;
+
+  // Average cost-per-thousand impressions (CPM).
+  google.protobuf.DoubleValue average_cpm = 10;
+
+  // The average amount you pay each time someone views your ad.
+  // The average CPV is defined by the total cost of all ad views divided by
+  // the number of views.
+  google.protobuf.DoubleValue average_cpv = 11;
+
+  // Average number of times a unique cookie was exposed to your ad
+  // over a given time period. Imported from Google Analytics.
+  google.protobuf.DoubleValue average_frequency = 12;
+
+  // Average number of pages viewed per session.
+  google.protobuf.DoubleValue average_page_views = 99;
+
+  // Your ad's position relative to those of other advertisers.
+  google.protobuf.DoubleValue average_position = 13;
+
+  // Total duration of all sessions (in seconds) / number of sessions. Imported
+  // from Google Analytics.
+  google.protobuf.DoubleValue average_time_on_site = 84;
+
+  // An indication of how other advertisers are bidding on similar products.
+  google.protobuf.DoubleValue benchmark_average_max_cpc = 14;
+
+  // An indication on how other advertisers' Shopping ads for similar products
+  // are performing based on how often people who see their ad click on it.
+  google.protobuf.DoubleValue benchmark_ctr = 77;
+
+  // Percentage of clicks where the user only visited a single page on your
+  // site. Imported from Google Analytics.
+  google.protobuf.DoubleValue bounce_rate = 15;
+
+  // The number of clicks.
+  google.protobuf.Int64Value clicks = 19;
+
+  // The number of times your ad or your site's listing in the unpaid
+  // results was clicked. See the help page at
+  // https://support.google.com/google-ads/answer/3097241 for details.
+  google.protobuf.Int64Value combined_clicks = 115;
+
+  // The number of times your ad or your site's listing in the unpaid
+  // results was clicked (combined_clicks) divided by combined_queries. See the
+  // help page at https://support.google.com/google-ads/answer/3097241 for
+  // details.
+  google.protobuf.DoubleValue combined_clicks_per_query = 116;
+
+  // The number of searches that returned pages from your site in the unpaid
+  // results or showed one of your text ads. See the help page at
+  // https://support.google.com/google-ads/answer/3097241 for details.
+  google.protobuf.Int64Value combined_queries = 117;
+
+  // The estimated percent of times that your ad was eligible to show
+  // on the Display Network but didn't because your budget was too low.
+  // Note: Content budget lost impression share is reported in the range of 0
+  // to 0.9. Any value above 0.9 is reported as 0.9001.
+  google.protobuf.DoubleValue content_budget_lost_impression_share = 20;
+
+  // The impressions you've received on the Display Network divided
+  // by the estimated number of impressions you were eligible to receive.
+  // Note: Content impression share is reported in the range of 0.1 to 1. Any
+  // value below 0.1 is reported as 0.0999.
+  google.protobuf.DoubleValue content_impression_share = 21;
+
+  // The last date/time a conversion tag for this conversion action successfully
+  // fired and was seen by Google Ads. This firing event may not have been the
+  // result of an attributable conversion (e.g. because the tag was fired from a
+  // browser that did not previously click an ad from an appropriate
+  // advertiser). The date/time is in the customer's time zone.
+  google.protobuf.StringValue conversion_last_received_request_date_time = 73;
+
+  // The date of the most recent conversion for this conversion action. The date
+  // is in the customer's time zone.
+  google.protobuf.StringValue conversion_last_conversion_date = 74;
+
+  // The estimated percentage of impressions on the Display Network
+  // that your ads didn't receive due to poor Ad Rank.
+  // Note: Content rank lost impression share is reported in the range of 0
+  // to 0.9. Any value above 0.9 is reported as 0.9001.
+  google.protobuf.DoubleValue content_rank_lost_impression_share = 22;
+
+  // Conversions from interactions divided by the number of ad interactions
+  // (such as clicks for text ads or views for video ads). This only includes
+  // conversion actions which include_in_conversions_metric attribute is set to
+  // true.
+  google.protobuf.DoubleValue conversions_from_interactions_rate = 69;
+
+  // The total value of conversions. This only includes conversion actions which
+  // include_in_conversions_metric attribute is set to true.
+  google.protobuf.DoubleValue conversions_value = 70;
+
+  // The value of conversions divided by the cost of ad interactions. This only
+  // includes conversion actions which include_in_conversions_metric attribute
+  // is set to true.
+  google.protobuf.DoubleValue conversions_value_per_cost = 71;
+
+  // The value of conversions from interactions divided by the number of ad
+  // interactions. This only includes conversion actions which
+  // include_in_conversions_metric attribute is set to true.
+  google.protobuf.DoubleValue conversions_from_interactions_value_per_interaction = 72;
+
+  // The number of conversions. This only includes conversion actions which
+  // include_in_conversions_metric attribute is set to true.
+  google.protobuf.DoubleValue conversions = 25;
+
+  // The sum of your cost-per-click (CPC) and cost-per-thousand impressions
+  // (CPM) costs during this period.
+  google.protobuf.Int64Value cost_micros = 26;
+
+  // The cost of ad interactions divided by all conversions.
+  google.protobuf.DoubleValue cost_per_all_conversions = 68;
+
+  // The cost of ad interactions divided by conversions. This only includes
+  // conversion actions which include_in_conversions_metric attribute is set to
+  // true.
+  google.protobuf.DoubleValue cost_per_conversion = 28;
+
+  // The cost of ad interactions divided by current model attributed
+  // conversions. This only includes conversion actions which
+  // include_in_conversions_metric attribute is set to true.
+  google.protobuf.DoubleValue cost_per_current_model_attributed_conversion = 106;
+
+  // Conversions from when a customer clicks on a Google Ads ad on one device,
+  // then converts on a different device or browser.
+  // Cross-device conversions are already included in all_conversions.
+  google.protobuf.DoubleValue cross_device_conversions = 29;
+
+  // The number of clicks your ad receives (Clicks) divided by the number
+  // of times your ad is shown (Impressions).
+  google.protobuf.DoubleValue ctr = 30;
+
+  // Shows how your historic conversions data would look under the attribution
+  // model you've currently selected. This only includes conversion actions
+  // which include_in_conversions_metric attribute is set to true.
+  google.protobuf.DoubleValue current_model_attributed_conversions = 101;
+
+  // Current model attributed conversions from interactions divided by the
+  // number of ad interactions (such as clicks for text ads or views for video
+  // ads). This only includes conversion actions which
+  // include_in_conversions_metric attribute is set to true.
+  google.protobuf.DoubleValue current_model_attributed_conversions_from_interactions_rate = 102;
+
+  // The value of current model attributed conversions from interactions divided
+  // by the number of ad interactions. This only includes conversion actions
+  // which include_in_conversions_metric attribute is set to true.
+  google.protobuf.DoubleValue current_model_attributed_conversions_from_interactions_value_per_interaction = 103;
+
+  // The total value of current model attributed conversions. This only includes
+  // conversion actions which include_in_conversions_metric attribute is set to
+  // true.
+  google.protobuf.DoubleValue current_model_attributed_conversions_value = 104;
+
+  // The value of current model attributed conversions divided by the cost of ad
+  // interactions. This only includes conversion actions which
+  // include_in_conversions_metric attribute is set to true.
+  google.protobuf.DoubleValue current_model_attributed_conversions_value_per_cost = 105;
+
+  // How often people engage with your ad after it's shown to them. This is the
+  // number of ad expansions divided by the number of times your ad is shown.
+  google.protobuf.DoubleValue engagement_rate = 31;
+
+  // The number of engagements.
+  // An engagement occurs when a viewer expands your Lightbox ad. Also, in the
+  // future, other ad types may support engagement metrics.
+  google.protobuf.Int64Value engagements = 32;
+
+  // Average lead value of hotel.
+  google.protobuf.DoubleValue hotel_average_lead_value_micros = 75;
+
+  // The creative historical quality score.
+  google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket historical_creative_quality_score = 80;
+
+  // The quality of historical landing page experience.
+  google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket historical_landing_page_quality_score = 81;
+
+  // The historical quality score.
+  google.protobuf.Int64Value historical_quality_score = 82;
+
+  // The historical search predicted click through rate (CTR).
+  google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket historical_search_predicted_ctr = 83;
+
+  // The number of times the ad was forwarded to someone else as a message.
+  google.protobuf.Int64Value gmail_forwards = 85;
+
+  // The number of times someone has saved your Gmail ad to their inbox as a
+  // message.
+  google.protobuf.Int64Value gmail_saves = 86;
+
+  // The number of clicks to the landing page on the expanded state of Gmail
+  // ads.
+  google.protobuf.Int64Value gmail_secondary_clicks = 87;
+
+  // Number of unique cookies that were exposed to your ad over a given time
+  // period.
+  google.protobuf.Int64Value impression_reach = 36;
+
+  // The number of times a store's location-based ad was shown.
+  // This metric applies to feed items only.
+  google.protobuf.Int64Value impressions_from_store_reach = 125;
+
+  // Count of how often your ad has appeared on a search results page or
+  // website on the Google Network.
+  google.protobuf.Int64Value impressions = 37;
+
+  // How often people interact with your ad after it is shown to them.
+  // This is the number of interactions divided by the number of times your ad
+  // is shown.
+  google.protobuf.DoubleValue interaction_rate = 38;
+
+  // The number of interactions.
+  // An interaction is the main user action associated with an ad format-clicks
+  // for text and shopping ads, views for video ads, and so on.
+  google.protobuf.Int64Value interactions = 39;
+
+  // The types of payable and free interactions.
+  repeated google.ads.googleads.v1.enums.InteractionEventTypeEnum.InteractionEventType interaction_event_types = 100;
+
+  // The percentage of clicks filtered out of your total number of clicks
+  // (filtered + non-filtered clicks) during the reporting period.
+  google.protobuf.DoubleValue invalid_click_rate = 40;
+
+  // Number of clicks Google considers illegitimate and doesn't charge you for.
+  google.protobuf.Int64Value invalid_clicks = 41;
+
+  // The percentage of mobile clicks that go to a mobile-friendly page.
+  google.protobuf.DoubleValue mobile_friendly_clicks_percentage = 109;
+
+  // The number of times someone clicked your site's listing in the unpaid
+  // results for a particular query. See the help page at
+  // https://support.google.com/google-ads/answer/3097241 for details.
+  google.protobuf.Int64Value organic_clicks = 110;
+
+  // The number of times someone clicked your site's listing in the unpaid
+  // results (organic_clicks) divided by the total number of searches that
+  // returned pages from your site (organic_queries). See the help page at
+  // https://support.google.com/google-ads/answer/3097241 for details.
+  google.protobuf.DoubleValue organic_clicks_per_query = 111;
+
+  // The number of listings for your site in the unpaid search results. See the
+  // help page at https://support.google.com/google-ads/answer/3097241 for
+  // details.
+  google.protobuf.Int64Value organic_impressions = 112;
+
+  // The number of times a page from your site was listed in the unpaid search
+  // results (organic_impressions) divided by the number of searches returning
+  // your site's listing in the unpaid results (organic_queries). See the help
+  // page at https://support.google.com/google-ads/answer/3097241 for details.
+  google.protobuf.DoubleValue organic_impressions_per_query = 113;
+
+  // The total number of searches that returned your site's listing in the
+  // unpaid results. See the help page at
+  // https://support.google.com/google-ads/answer/3097241 for details.
+  google.protobuf.Int64Value organic_queries = 114;
+
+  // Percentage of first-time sessions (from people who had never visited your
+  // site before). Imported from Google Analytics.
+  google.protobuf.DoubleValue percent_new_visitors = 42;
+
+  // Number of offline phone calls.
+  google.protobuf.Int64Value phone_calls = 43;
+
+  // Number of offline phone impressions.
+  google.protobuf.Int64Value phone_impressions = 44;
+
+  // Number of phone calls received (phone_calls) divided by the number of
+  // times your phone number is shown (phone_impressions).
+  google.protobuf.DoubleValue phone_through_rate = 45;
+
+  // Your clickthrough rate (Ctr) divided by the average clickthrough rate of
+  // all advertisers on the websites that show your ads. Measures how your ads
+  // perform on Display Network sites compared to other ads on the same sites.
+  google.protobuf.DoubleValue relative_ctr = 46;
+
+  // The percentage of the customer's Shopping or Search ad impressions that are
+  // shown in the most prominent Shopping position. See
+  // <a href="https://support.google.com/adwords/answer/7501826">this Merchant
+  // Center article</a> for details. Any value below 0.1 is reported as 0.0999.
+  google.protobuf.DoubleValue search_absolute_top_impression_share = 78;
+
+  // The number estimating how often your ad wasn't the very first ad above the
+  // organic search results due to a low budget. Note: Search
+  // budget lost absolute top impression share is reported in the range of 0 to
+  // 0.9. Any value above 0.9 is reported as 0.9001.
+  google.protobuf.DoubleValue search_budget_lost_absolute_top_impression_share = 88;
+
+  // The estimated percent of times that your ad was eligible to show on the
+  // Search Network but didn't because your budget was too low. Note: Search
+  // budget lost impression share is reported in the range of 0 to 0.9. Any
+  // value above 0.9 is reported as 0.9001.
+  google.protobuf.DoubleValue search_budget_lost_impression_share = 47;
+
+  // The number estimating how often your ad didn't show anywhere above the
+  // organic search results due to a low budget. Note: Search
+  // budget lost top impression share is reported in the range of 0 to 0.9. Any
+  // value above 0.9 is reported as 0.9001.
+  google.protobuf.DoubleValue search_budget_lost_top_impression_share = 89;
+
+  // The number of clicks you've received on the Search Network
+  // divided by the estimated number of clicks you were eligible to receive.
+  // Note: Search click share is reported in the range of 0.1 to 1. Any value
+  // below 0.1 is reported as 0.0999.
+  google.protobuf.DoubleValue search_click_share = 48;
+
+  // The impressions you've received divided by the estimated number of
+  // impressions you were eligible to receive on the Search Network for search
+  // terms that matched your keywords exactly (or were close variants of your
+  // keyword), regardless of your keyword match types. Note: Search exact match
+  // impression share is reported in the range of 0.1 to 1. Any value below 0.1
+  // is reported as 0.0999.
+  google.protobuf.DoubleValue search_exact_match_impression_share = 49;
+
+  // The impressions you've received on the Search Network divided
+  // by the estimated number of impressions you were eligible to receive.
+  // Note: Search impression share is reported in the range of 0.1 to 1. Any
+  // value below 0.1 is reported as 0.0999.
+  google.protobuf.DoubleValue search_impression_share = 50;
+
+  // The number estimating how often your ad wasn't the very first ad above the
+  // organic search results due to poor Ad Rank.
+  // Note: Search rank lost absolute top impression share is reported in the
+  // range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
+  google.protobuf.DoubleValue search_rank_lost_absolute_top_impression_share = 90;
+
+  // The estimated percentage of impressions on the Search Network
+  // that your ads didn't receive due to poor Ad Rank.
+  // Note: Search rank lost impression share is reported in the range of 0 to
+  // 0.9. Any value above 0.9 is reported as 0.9001.
+  google.protobuf.DoubleValue search_rank_lost_impression_share = 51;
+
+  // The number estimating how often your ad didn't show anywhere above the
+  // organic search results due to poor Ad Rank.
+  // Note: Search rank lost top impression share is reported in the range of 0
+  // to 0.9. Any value above 0.9 is reported as 0.9001.
+  google.protobuf.DoubleValue search_rank_lost_top_impression_share = 91;
+
+  // The impressions you've received in the top location (anywhere above the
+  // organic search results) compared to the estimated number of impressions you
+  // were eligible to receive in the top location.
+  // Note: Search top impression share is reported in the range of 0.1 to 1. Any
+  // value below 0.1 is reported as 0.0999.
+  google.protobuf.DoubleValue search_top_impression_share = 92;
+
+  // A measure of how quickly your page loads after clicks on your mobile ads.
+  // The score is a range from 1 to 10, 10 being the fastest.
+  google.protobuf.Int64Value speed_score = 107;
+
+  // The percent of your ad impressions that are shown anywhere above the
+  // organic search results.
+  google.protobuf.DoubleValue top_impression_percentage = 93;
+
+  // The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages
+  // that reach a valid AMP page.
+  google.protobuf.DoubleValue valid_accelerated_mobile_pages_clicks_percentage = 108;
+
+  // The value of all conversions divided by the number of all conversions.
+  google.protobuf.DoubleValue value_per_all_conversions = 52;
+
+  // The value of conversions divided by the number of conversions. This only
+  // includes conversion actions which include_in_conversions_metric attribute
+  // is set to true.
+  google.protobuf.DoubleValue value_per_conversion = 53;
+
+  // The value of current model attributed conversions divided by the number of
+  // the conversions. This only includes conversion actions which
+  // include_in_conversions_metric attribute is set to true.
+  google.protobuf.DoubleValue value_per_current_model_attributed_conversion = 94;
+
+  // Percentage of impressions where the viewer watched all of your video.
+  google.protobuf.DoubleValue video_quartile_100_rate = 54;
+
+  // Percentage of impressions where the viewer watched 25% of your video.
+  google.protobuf.DoubleValue video_quartile_25_rate = 55;
+
+  // Percentage of impressions where the viewer watched 50% of your video.
+  google.protobuf.DoubleValue video_quartile_50_rate = 56;
+
+  // Percentage of impressions where the viewer watched 75% of your video.
+  google.protobuf.DoubleValue video_quartile_75_rate = 57;
+
+  // The number of views your TrueView video ad receives divided by its number
+  // of impressions, including thumbnail impressions for TrueView in-display
+  // ads.
+  google.protobuf.DoubleValue video_view_rate = 58;
+
+  // The number of times your video ads were viewed.
+  google.protobuf.Int64Value video_views = 59;
+
+  // The total number of view-through conversions.
+  // These happen when a customer sees an image or rich media ad, then later
+  // completes a conversion on your site without interacting with (e.g.,
+  // clicking on) another ad.
+  google.protobuf.Int64Value view_through_conversions = 60;
+}

third_party/google/ads/googleads/v1/common/policy.proto

@@ -0,0 +1,217 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/policy_topic_entry_type.proto";
+import "google/ads/googleads/v1/enums/policy_topic_evidence_destination_mismatch_url_type.proto";
+import "google/ads/googleads/v1/enums/policy_topic_evidence_destination_not_working_device.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "PolicyProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing policy information.
+
+// Key of the violation. The key is used for referring to a violation
+// when filing an exemption request.
+message PolicyViolationKey {
+  // Unique ID of the violated policy.
+  google.protobuf.StringValue policy_name = 1;
+
+  // The text that violates the policy if specified.
+  // Otherwise, refers to the policy in general
+  // (e.g., when requesting to be exempt from the whole policy).
+  // If not specified for criterion exemptions, the whole policy is implied.
+  // Must be specified for ad exemptions.
+  google.protobuf.StringValue violating_text = 2;
+}
+
+// Parameter for controlling how policy exemption is done. Ignorable policy
+// topics are only usable with expanded text ads and responsive search ads. All
+// other ad types must use policy violation keys.
+message PolicyValidationParameter {
+  // The list of policy topics that should not cause a PolicyFindingError to
+  // be reported. This field is currently only compatible with Enhanced Text Ad.
+  // It corresponds to the PolicyTopicEntry.topic field.
+  //
+  // Resources violating these policies will be saved, but will not be eligible
+  // to serve. They may begin serving at a later time due to a change in
+  // policies, re-review of the resource, or a change in advertiser
+  // certificates.
+  repeated google.protobuf.StringValue ignorable_policy_topics = 1;
+
+  // The list of policy violation keys that should not cause a
+  // PolicyViolationError to be reported. Not all policy violations are
+  // exemptable, please refer to the is_exemptible field in the returned
+  // PolicyViolationError.
+  //
+  // Resources violating these polices will be saved, but will not be eligible
+  // to serve. They may begin serving at a later time due to a change in
+  // policies, re-review of the resource, or a change in advertiser
+  // certificates.
+  repeated PolicyViolationKey exempt_policy_violation_keys = 2;
+}
+
+// Policy finding attached to a resource (e.g. alcohol policy associated with
+// a site that sells alcohol).
+//
+// Each PolicyTopicEntry has a topic that indicates the specific ads policy
+// the entry is about and a type to indicate the effect that the entry will have
+// on serving. It may optionally have one or more evidences that indicate the
+// reason for the finding. It may also optionally have one or more constraints
+// that provide details about how serving may be restricted.
+message PolicyTopicEntry {
+  // Policy topic this finding refers to. For example, "ALCOHOL",
+  // "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible
+  // policy topics is not fixed for a particular API version and may change
+  // at any time.
+  google.protobuf.StringValue topic = 1;
+
+  // Describes the negative or positive effect this policy will have on serving.
+  google.ads.googleads.v1.enums.PolicyTopicEntryTypeEnum.PolicyTopicEntryType type = 2;
+
+  // Additional information that explains policy finding
+  // (e.g. the brand name for a trademark finding).
+  repeated PolicyTopicEvidence evidences = 3;
+
+  // Indicates how serving of this resource may be affected (e.g. not serving
+  // in a country).
+  repeated PolicyTopicConstraint constraints = 4;
+}
+
+// Additional information that explains a policy finding.
+message PolicyTopicEvidence {
+  // A list of fragments of text that violated a policy.
+  message TextList {
+    // The fragments of text from the resource that caused the policy finding.
+    repeated google.protobuf.StringValue texts = 1;
+  }
+
+  // A list of websites that caused a policy finding. Used for
+  // ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more
+  // than five websites, only the top five (those that appear in resources the
+  // most) will be listed here.
+  message WebsiteList {
+    // Websites that caused the policy finding.
+    repeated google.protobuf.StringValue websites = 1;
+  }
+
+  // A list of strings found in a destination page that caused a policy
+  // finding.
+  message DestinationTextList {
+    // List of text found in the resource's destination page.
+    repeated google.protobuf.StringValue destination_texts = 1;
+  }
+
+  // Evidence of mismatches between the URLs of a resource.
+  message DestinationMismatch {
+    // The set of URLs that did not match each other.
+    repeated google.ads.googleads.v1.enums.PolicyTopicEvidenceDestinationMismatchUrlTypeEnum.PolicyTopicEvidenceDestinationMismatchUrlType url_types = 1;
+  }
+
+  // Evidence details when the destination is returning an HTTP error
+  // code or isn't functional in all locations for commonly used devices.
+  message DestinationNotWorking {
+    // The full URL that didn't work.
+    google.protobuf.StringValue expanded_url = 3;
+
+    // The type of device that failed to load the URL.
+    google.ads.googleads.v1.enums.PolicyTopicEvidenceDestinationNotWorkingDeviceEnum.PolicyTopicEvidenceDestinationNotWorkingDevice device = 4;
+
+    // The time the URL was last checked.
+    // The format is "YYYY-MM-DD HH:MM:SS".
+    // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
+    google.protobuf.StringValue last_checked_date_time = 5;
+  }
+
+  // Specific evidence information depending on the evidence type.
+  oneof value {
+    // HTTP code returned when the final URL was crawled.
+    google.protobuf.Int32Value http_code = 2;
+
+    // List of websites linked with this resource.
+    WebsiteList website_list = 3;
+
+    // List of evidence found in the text of a resource.
+    TextList text_list = 4;
+
+    // The language the resource was detected to be written in.
+    // This is an IETF language tag such as "en-US".
+    google.protobuf.StringValue language_code = 5;
+
+    // The text in the destination of the resource that is causing a policy
+    // finding.
+    DestinationTextList destination_text_list = 6;
+
+    // Mismatch between the destinations of a resource's URLs.
+    DestinationMismatch destination_mismatch = 7;
+
+    // Details when the destination is returning an HTTP error code or isn't
+    // functional in all locations for commonly used devices.
+    DestinationNotWorking destination_not_working = 8;
+  }
+}
+
+// Describes the effect on serving that a policy topic entry will have.
+message PolicyTopicConstraint {
+  // A list of countries where a resource's serving is constrained.
+  message CountryConstraintList {
+    // Total number of countries targeted by the resource.
+    google.protobuf.Int32Value total_targeted_countries = 1;
+
+    // Countries in which serving is restricted.
+    repeated CountryConstraint countries = 2;
+  }
+
+  // Indicates that a policy topic was constrained due to disapproval of the
+  // website for reseller purposes.
+  message ResellerConstraint {
+
+  }
+
+  // Indicates that a resource's ability to serve in a particular country is
+  // constrained.
+  message CountryConstraint {
+    // Geo target constant resource name of the country in which serving is
+    // constrained.
+    google.protobuf.StringValue country_criterion = 1;
+  }
+
+  // Specific information about the constraint.
+  oneof value {
+    // Countries where the resource cannot serve.
+    CountryConstraintList country_constraint_list = 1;
+
+    // Reseller constraint.
+    ResellerConstraint reseller_constraint = 2;
+
+    // Countries where a certificate is required for serving.
+    CountryConstraintList certificate_missing_in_country_list = 3;
+
+    // Countries where the resource's domain is not covered by the
+    // certificates associated with it.
+    CountryConstraintList certificate_domain_mismatch_in_country_list = 4;
+  }
+}

third_party/google/ads/googleads/v1/common/real_time_bidding_setting.proto

@@ -0,0 +1,39 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "RealTimeBiddingSettingProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing RealTimeBiddingSetting
+
+// Settings for Real-Time Bidding, a feature only available for campaigns
+// targeting the Ad Exchange network.
+message RealTimeBiddingSetting {
+  // Whether the campaign is opted in to real-time bidding.
+  google.protobuf.BoolValue opt_in = 1;
+}

third_party/google/ads/googleads/v1/common/segments.proto

@@ -0,0 +1,294 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/common/criteria.proto";
+import "google/ads/googleads/v1/enums/ad_network_type.proto";
+import "google/ads/googleads/v1/enums/click_type.proto";
+import "google/ads/googleads/v1/enums/conversion_action_category.proto";
+import "google/ads/googleads/v1/enums/conversion_attribution_event_type.proto";
+import "google/ads/googleads/v1/enums/conversion_lag_bucket.proto";
+import "google/ads/googleads/v1/enums/conversion_or_adjustment_lag_bucket.proto";
+import "google/ads/googleads/v1/enums/day_of_week.proto";
+import "google/ads/googleads/v1/enums/device.proto";
+import "google/ads/googleads/v1/enums/external_conversion_source.proto";
+import "google/ads/googleads/v1/enums/hotel_date_selection_type.proto";
+import "google/ads/googleads/v1/enums/month_of_year.proto";
+import "google/ads/googleads/v1/enums/placeholder_type.proto";
+import "google/ads/googleads/v1/enums/product_channel.proto";
+import "google/ads/googleads/v1/enums/product_channel_exclusivity.proto";
+import "google/ads/googleads/v1/enums/product_condition.proto";
+import "google/ads/googleads/v1/enums/search_engine_results_page_type.proto";
+import "google/ads/googleads/v1/enums/search_term_match_type.proto";
+import "google/ads/googleads/v1/enums/slot.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "SegmentsProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing segment only fields.
+
+// Segment only fields.
+message Segments {
+  // Ad network type.
+  google.ads.googleads.v1.enums.AdNetworkTypeEnum.AdNetworkType ad_network_type = 3;
+
+  // Click type.
+  google.ads.googleads.v1.enums.ClickTypeEnum.ClickType click_type = 26;
+
+  // Resource name of the conversion action.
+  google.protobuf.StringValue conversion_action = 52;
+
+  // Conversion action category.
+  google.ads.googleads.v1.enums.ConversionActionCategoryEnum.ConversionActionCategory conversion_action_category = 53;
+
+  // Conversion action name.
+  google.protobuf.StringValue conversion_action_name = 54;
+
+  // This segments your conversion columns by the original conversion and
+  // conversion value vs. the delta if conversions were adjusted. False row has
+  // the data as originally stated; While true row has the delta between data
+  // now and the data as originally stated. Summing the two together results
+  // post-adjustment data.
+  google.protobuf.BoolValue conversion_adjustment = 27;
+
+  // Conversion attribution event type.
+  google.ads.googleads.v1.enums.ConversionAttributionEventTypeEnum.ConversionAttributionEventType conversion_attribution_event_type = 2;
+
+  // An enum value representing the number of days between the impression and
+  // the conversion.
+  google.ads.googleads.v1.enums.ConversionLagBucketEnum.ConversionLagBucket conversion_lag_bucket = 50;
+
+  // An enum value representing the number of days between the impression and
+  // the conversion or between the impression and adjustments to the conversion.
+  google.ads.googleads.v1.enums.ConversionOrAdjustmentLagBucketEnum.ConversionOrAdjustmentLagBucket conversion_or_adjustment_lag_bucket = 51;
+
+  // Date to which metrics apply.
+  // yyyy-MM-dd format, e.g., 2018-04-17.
+  google.protobuf.StringValue date = 4;
+
+  // Day of the week, e.g., MONDAY.
+  google.ads.googleads.v1.enums.DayOfWeekEnum.DayOfWeek day_of_week = 5;
+
+  // Device to which metrics apply.
+  google.ads.googleads.v1.enums.DeviceEnum.Device device = 1;
+
+  // External conversion source.
+  google.ads.googleads.v1.enums.ExternalConversionSourceEnum.ExternalConversionSource external_conversion_source = 55;
+
+  // Resource name of the geo target constant that represents an airport.
+  google.protobuf.StringValue geo_target_airport = 65;
+
+  // Resource name of the geo target constant that represents a city.
+  google.protobuf.StringValue geo_target_city = 62;
+
+  // Resource name of the geo target constant that represents a county.
+  google.protobuf.StringValue geo_target_county = 68;
+
+  // Resource name of the geo target constant that represents a district.
+  google.protobuf.StringValue geo_target_district = 69;
+
+  // Resource name of the geo target constant that represents a metro.
+  google.protobuf.StringValue geo_target_metro = 63;
+
+  // Resource name of the geo target constant that represents the most
+  // specific location.
+  google.protobuf.StringValue geo_target_most_specific_location = 72;
+
+  // Resource name of the geo target constant that represents a postal code.
+  google.protobuf.StringValue geo_target_postal_code = 71;
+
+  // Resource name of the geo target constant that represents a region.
+  google.protobuf.StringValue geo_target_region = 64;
+
+  // Resource name of the geo target constant that represents a state.
+  google.protobuf.StringValue geo_target_state = 67;
+
+  // Hotel booking window in days.
+  google.protobuf.Int64Value hotel_booking_window_days = 6;
+
+  // Hotel center ID.
+  google.protobuf.Int64Value hotel_center_id = 7;
+
+  // Hotel check-in date. Formatted as yyyy-MM-dd.
+  google.protobuf.StringValue hotel_check_in_date = 8;
+
+  // Hotel check-in day of week.
+  google.ads.googleads.v1.enums.DayOfWeekEnum.DayOfWeek hotel_check_in_day_of_week = 9;
+
+  // Hotel city.
+  google.protobuf.StringValue hotel_city = 10;
+
+  // Hotel class.
+  google.protobuf.Int32Value hotel_class = 11;
+
+  // Hotel country.
+  google.protobuf.StringValue hotel_country = 12;
+
+  // Hotel date selection type.
+  google.ads.googleads.v1.enums.HotelDateSelectionTypeEnum.HotelDateSelectionType hotel_date_selection_type = 13;
+
+  // Hotel length of stay.
+  google.protobuf.Int32Value hotel_length_of_stay = 14;
+
+  // Hotel state.
+  google.protobuf.StringValue hotel_state = 15;
+
+  // Hour of day as a number between 0 and 23, inclusive.
+  google.protobuf.Int32Value hour = 16;
+
+  // Only used with feed item metrics.
+  // Indicates whether the interaction metrics occurred on the feed item itself
+  // or a different extension or ad unit.
+  google.protobuf.BoolValue interaction_on_this_extension = 49;
+
+  // Keyword criterion.
+  Keyword keyword = 61;
+
+  // Month as represented by the date of the first day of a month. Formatted as
+  // yyyy-MM-dd.
+  google.protobuf.StringValue month = 17;
+
+  // Month of the year, e.g., January.
+  google.ads.googleads.v1.enums.MonthOfYearEnum.MonthOfYear month_of_year = 18;
+
+  // Partner hotel ID.
+  google.protobuf.StringValue partner_hotel_id = 19;
+
+  // Placeholder type. This is only used with feed item metrics.
+  google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type = 20;
+
+  // Aggregator ID of the product.
+  google.protobuf.UInt64Value product_aggregator_id = 28;
+
+  // Bidding category (level 1) of the product.
+  google.protobuf.StringValue product_bidding_category_level1 = 56;
+
+  // Bidding category (level 2) of the product.
+  google.protobuf.StringValue product_bidding_category_level2 = 57;
+
+  // Bidding category (level 3) of the product.
+  google.protobuf.StringValue product_bidding_category_level3 = 58;
+
+  // Bidding category (level 4) of the product.
+  google.protobuf.StringValue product_bidding_category_level4 = 59;
+
+  // Bidding category (level 5) of the product.
+  google.protobuf.StringValue product_bidding_category_level5 = 60;
+
+  // Brand of the product.
+  google.protobuf.StringValue product_brand = 29;
+
+  // Channel of the product.
+  google.ads.googleads.v1.enums.ProductChannelEnum.ProductChannel product_channel = 30;
+
+  // Channel exclusivity of the product.
+  google.ads.googleads.v1.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity product_channel_exclusivity = 31;
+
+  // Condition of the product.
+  google.ads.googleads.v1.enums.ProductConditionEnum.ProductCondition product_condition = 32;
+
+  // Resource name of the geo target constant for the country of sale of the
+  // product.
+  google.protobuf.StringValue product_country = 33;
+
+  // Custom attribute 0 of the product.
+  google.protobuf.StringValue product_custom_attribute0 = 34;
+
+  // Custom attribute 1 of the product.
+  google.protobuf.StringValue product_custom_attribute1 = 35;
+
+  // Custom attribute 2 of the product.
+  google.protobuf.StringValue product_custom_attribute2 = 36;
+
+  // Custom attribute 3 of the product.
+  google.protobuf.StringValue product_custom_attribute3 = 37;
+
+  // Custom attribute 4 of the product.
+  google.protobuf.StringValue product_custom_attribute4 = 38;
+
+  // Item ID of the product.
+  google.protobuf.StringValue product_item_id = 39;
+
+  // Resource name of the language constant for the language of the product.
+  google.protobuf.StringValue product_language = 40;
+
+  // Merchant ID of the product.
+  google.protobuf.UInt64Value product_merchant_id = 41;
+
+  // Store ID of the product.
+  google.protobuf.StringValue product_store_id = 42;
+
+  // Title of the product.
+  google.protobuf.StringValue product_title = 43;
+
+  // Type (level 1) of the product.
+  google.protobuf.StringValue product_type_l1 = 44;
+
+  // Type (level 2) of the product.
+  google.protobuf.StringValue product_type_l2 = 45;
+
+  // Type (level 3) of the product.
+  google.protobuf.StringValue product_type_l3 = 46;
+
+  // Type (level 4) of the product.
+  google.protobuf.StringValue product_type_l4 = 47;
+
+  // Type (level 5) of the product.
+  google.protobuf.StringValue product_type_l5 = 48;
+
+  // Quarter as represented by the date of the first day of a quarter.
+  // Uses the calendar year for quarters, e.g., the second quarter of 2018
+  // starts on 2018-04-01. Formatted as yyyy-MM-dd.
+  google.protobuf.StringValue quarter = 21;
+
+  // Type of the search engine results page.
+  google.ads.googleads.v1.enums.SearchEngineResultsPageTypeEnum.SearchEngineResultsPageType search_engine_results_page_type = 70;
+
+  // Match type of the keyword that triggered the ad, including variants.
+  google.ads.googleads.v1.enums.SearchTermMatchTypeEnum.SearchTermMatchType search_term_match_type = 22;
+
+  // Position of the ad.
+  google.ads.googleads.v1.enums.SlotEnum.Slot slot = 23;
+
+  // Resource name of the ad group criterion that represents webpage criterion.
+  google.protobuf.StringValue webpage = 66;
+
+  // Week as defined as Monday through Sunday, and represented by the date of
+  // Monday. Formatted as yyyy-MM-dd.
+  google.protobuf.StringValue week = 24;
+
+  // Year, formatted as yyyy.
+  google.protobuf.Int32Value year = 25;
+}
+
+// A Keyword criterion segment.
+message Keyword {
+  // The AdGroupCriterion resource name.
+  google.protobuf.StringValue ad_group_criterion = 1;
+
+  // Keyword info.
+  KeywordInfo info = 2;
+}

third_party/google/ads/googleads/v1/common/simulation.proto

@@ -0,0 +1,124 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "SimulationProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing simulation points.
+
+// A container for simulation points for simulations of type BID_MODIFIER.
+message BidModifierSimulationPointList {
+  // Projected metrics for a series of bid modifier amounts.
+  repeated BidModifierSimulationPoint points = 1;
+}
+
+// A container for simulation points for simulations of type CPC_BID.
+message CpcBidSimulationPointList {
+  // Projected metrics for a series of cpc bid amounts.
+  repeated CpcBidSimulationPoint points = 1;
+}
+
+// A container for simulation points for simulations of type TARGET_CPA.
+message TargetCpaSimulationPointList {
+  // Projected metrics for a series of target cpa amounts.
+  repeated TargetCpaSimulationPoint points = 1;
+}
+
+// Projected metrics for a specific bid modifier amount.
+message BidModifierSimulationPoint {
+  // The simulated bid modifier upon which projected metrics are based.
+  google.protobuf.DoubleValue bid_modifier = 1;
+
+  // Projected number of biddable conversions.
+  google.protobuf.DoubleValue biddable_conversions = 2;
+
+  // Projected total value of biddable conversions.
+  google.protobuf.DoubleValue biddable_conversions_value = 3;
+
+  // Projected number of clicks.
+  google.protobuf.Int64Value clicks = 4;
+
+  // Projected cost in micros.
+  google.protobuf.Int64Value cost_micros = 5;
+
+  // Projected number of impressions.
+  google.protobuf.Int64Value impressions = 6;
+
+  // Projected number of top slot impressions.
+  google.protobuf.Int64Value top_slot_impressions = 7;
+}
+
+// Projected metrics for a specific cpc bid amount.
+message CpcBidSimulationPoint {
+  // The simulated cpc bid upon which projected metrics are based.
+  google.protobuf.Int64Value cpc_bid_micros = 1;
+
+  // Projected number of biddable conversions.
+  google.protobuf.DoubleValue biddable_conversions = 2;
+
+  // Projected total value of biddable conversions.
+  google.protobuf.DoubleValue biddable_conversions_value = 3;
+
+  // Projected number of clicks.
+  google.protobuf.Int64Value clicks = 4;
+
+  // Projected cost in micros.
+  google.protobuf.Int64Value cost_micros = 5;
+
+  // Projected number of impressions.
+  google.protobuf.Int64Value impressions = 6;
+
+  // Projected number of top slot impressions.
+  // Display network does not support this field at the ad group level.
+  google.protobuf.Int64Value top_slot_impressions = 7;
+}
+
+// Projected metrics for a specific target cpa amount.
+message TargetCpaSimulationPoint {
+  // The simulated target cpa upon which projected metrics are based.
+  google.protobuf.Int64Value target_cpa_micros = 1;
+
+  // Projected number of biddable conversions.
+  google.protobuf.DoubleValue biddable_conversions = 2;
+
+  // Projected total value of biddable conversions.
+  google.protobuf.DoubleValue biddable_conversions_value = 3;
+
+  // Projected number of clicks.
+  google.protobuf.Int64Value clicks = 4;
+
+  // Projected cost in micros.
+  google.protobuf.Int64Value cost_micros = 5;
+
+  // Projected number of impressions.
+  google.protobuf.Int64Value impressions = 6;
+
+  // Projected number of top slot impressions.
+  // Display network does not support this field at the ad group level.
+  google.protobuf.Int64Value top_slot_impressions = 7;
+}

third_party/google/ads/googleads/v1/common/tag_snippet.proto

@@ -0,0 +1,52 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/tracking_code_page_format.proto";
+import "google/ads/googleads/v1/enums/tracking_code_type.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "TagSnippetProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing TagSnippet
+
+// The site tag and event snippet pair for a TrackingCodeType.
+message TagSnippet {
+  // The type of the generated tag snippets for tracking conversions.
+  google.ads.googleads.v1.enums.TrackingCodeTypeEnum.TrackingCodeType type = 1;
+
+  // The format of the web page where the tracking tag and snippet will be
+  // installed, e.g. HTML.
+  google.ads.googleads.v1.enums.TrackingCodePageFormatEnum.TrackingCodePageFormat page_format = 2;
+
+  // The site tag that adds visitors to your basic remarketing lists and sets
+  // new cookies on your domain.
+  google.protobuf.StringValue global_site_tag = 3;
+
+  // The event snippet that works with the site tag to track actions that
+  // should be counted as conversions.
+  google.protobuf.StringValue event_snippet = 4;
+}

third_party/google/ads/googleads/v1/common/targeting_setting.proto

@@ -0,0 +1,57 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/targeting_dimension.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "TargetingSettingProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing TargetingSetting
+
+// Settings for the
+// <a href="https://support.google.com/google-ads/answer/7365594">
+// targeting related features</a>, at Campaign and AdGroup level.
+message TargetingSetting {
+  // The per-targeting-dimension setting to restrict the reach of your campaign
+  // or ad group.
+  repeated TargetRestriction target_restrictions = 1;
+}
+
+// The list of per-targeting-dimension targeting settings.
+message TargetRestriction {
+  // The targeting dimension that these settings apply to.
+  google.ads.googleads.v1.enums.TargetingDimensionEnum.TargetingDimension targeting_dimension = 1;
+
+  // Indicates whether to restrict your ads to show only for the criteria you
+  // have selected for this targeting_dimension, or to target all values for
+  // this targeting_dimension and show ads based on your targeting in other
+  // TargetingDimensions. A value of 'true' means that these criteria will only
+  // apply bid modifiers, and not affect targeting. A value of 'false' means
+  // that these criteria will restrict targeting as well as applying bid
+  // modifiers.
+  google.protobuf.BoolValue bid_only = 2;
+}

third_party/google/ads/googleads/v1/common/text_label.proto

@@ -0,0 +1,42 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "TextLabelProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// A type of label displaying text on a colored background.
+message TextLabel {
+  // Background color of the label in RGB format. This string must match the
+  // regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'.
+  // Note: The background color may not be visible for manager accounts.
+  google.protobuf.StringValue background_color = 1;
+
+  // A short description of the label. The length must be no more than 200
+  // characters.
+  google.protobuf.StringValue description = 2;
+}

third_party/google/ads/googleads/v1/common/url_collection.proto

@@ -0,0 +1,47 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "UrlCollectionProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file UrlCollection type.
+
+// Collection of urls that is tagged with a unique identifier.
+message UrlCollection {
+  // Unique identifier for this UrlCollection instance.
+  google.protobuf.StringValue url_collection_id = 1;
+
+  // A list of possible final URLs.
+  repeated google.protobuf.StringValue final_urls = 2;
+
+  // A list of possible final mobile URLs.
+  repeated google.protobuf.StringValue final_mobile_urls = 3;
+
+  // URL template for constructing a tracking URL.
+  google.protobuf.StringValue tracking_url_template = 4;
+}

third_party/google/ads/googleads/v1/common/user_lists.proto

@@ -0,0 +1,293 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/ads/googleads/v1/enums/customer_match_upload_key_type.proto";
+import "google/ads/googleads/v1/enums/user_list_combined_rule_operator.proto";
+import "google/ads/googleads/v1/enums/user_list_crm_data_source_type.proto";
+import "google/ads/googleads/v1/enums/user_list_date_rule_item_operator.proto";
+import "google/ads/googleads/v1/enums/user_list_logical_rule_operator.proto";
+import "google/ads/googleads/v1/enums/user_list_number_rule_item_operator.proto";
+import "google/ads/googleads/v1/enums/user_list_prepopulation_status.proto";
+import "google/ads/googleads/v1/enums/user_list_rule_type.proto";
+import "google/ads/googleads/v1/enums/user_list_string_rule_item_operator.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "UserListsProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing user list types.
+
+// SimilarUserList is a list of users which are similar to users from another
+// UserList. These lists are read-only and automatically created by Google.
+message SimilarUserListInfo {
+  // Seed UserList from which this list is derived.
+  google.protobuf.StringValue seed_user_list = 1;
+}
+
+// UserList of CRM users provided by the advertiser.
+message CrmBasedUserListInfo {
+  // A string that uniquely identifies a mobile application from which the data
+  // was collected to the Google Ads API.
+  // For iOS, the ID string is the 9 digit string that appears at the end of an
+  // App Store URL (e.g., "476943146" for "Flood-It! 2" whose App Store link is
+  // http://itunes.apple.com/us/app/flood-it!-2/id476943146).
+  // For Android, the ID string is the application's package name
+  // (e.g., "com.labpixies.colordrips" for "Color Drips" given Google Play link
+  // https://play.google.com/store/apps/details?id=com.labpixies.colordrips).
+  // Required when creating CrmBasedUserList for uploading mobile advertising
+  // IDs.
+  google.protobuf.StringValue app_id = 1;
+
+  // Matching key type of the list.
+  // Mixed data types are not allowed on the same list.
+  // This field is required for an ADD operation.
+  google.ads.googleads.v1.enums.CustomerMatchUploadKeyTypeEnum.CustomerMatchUploadKeyType upload_key_type = 2;
+
+  // Data source of the list. Default value is FIRST_PARTY.
+  // Only whitelisted customers can create third-party sourced CRM lists.
+  google.ads.googleads.v1.enums.UserListCrmDataSourceTypeEnum.UserListCrmDataSourceType data_source_type = 3;
+}
+
+// A client defined rule based on custom parameters sent by web sites or
+// uploaded by the advertiser.
+message UserListRuleInfo {
+  // Rule type is used to determine how to group rule items.
+  //
+  // The default is OR of ANDs (disjunctive normal form).
+  // That is, rule items will be ANDed together within rule item groups and the
+  // groups themselves will be ORed together.
+  //
+  // Currently AND of ORs (conjunctive normal form) is only supported for
+  // ExpressionRuleUserList.
+  google.ads.googleads.v1.enums.UserListRuleTypeEnum.UserListRuleType rule_type = 1;
+
+  // List of rule item groups that defines this rule.
+  // Rule item groups are grouped together based on rule_type.
+  repeated UserListRuleItemGroupInfo rule_item_groups = 2;
+}
+
+// A group of rule items.
+message UserListRuleItemGroupInfo {
+  // Rule items that will be grouped together based on rule_type.
+  repeated UserListRuleItemInfo rule_items = 1;
+}
+
+// An atomic rule fragment.
+message UserListRuleItemInfo {
+  // Rule variable name. It should match the corresponding key name fired
+  // by the pixel.
+  // A name must begin with US-ascii letters or underscore or UTF8 code that is
+  // greater than 127 and consist of US-ascii letters or digits or underscore or
+  // UTF8 code that is greater than 127.
+  // For websites, there are two built-in variable URL (name = 'url__') and
+  // referrer URL (name = 'ref_url__').
+  // This field must be populated when creating a new rule item.
+  google.protobuf.StringValue name = 1;
+
+  // An atomic rule fragment.
+  oneof rule_item {
+    // An atomic rule fragment composed of a number operation.
+    UserListNumberRuleItemInfo number_rule_item = 2;
+
+    // An atomic rule fragment composed of a string operation.
+    UserListStringRuleItemInfo string_rule_item = 3;
+
+    // An atomic rule fragment composed of a date operation.
+    UserListDateRuleItemInfo date_rule_item = 4;
+  }
+}
+
+// A rule item composed of date operation.
+message UserListDateRuleItemInfo {
+  // Date comparison operator.
+  // This field is required and must be populated when creating new date
+  // rule item.
+  google.ads.googleads.v1.enums.UserListDateRuleItemOperatorEnum.UserListDateRuleItemOperator operator = 1;
+
+  // String representing date value to be compared with the rule variable.
+  // Supported date format is YYYY-MM-DD.
+  // Times are reported in the customer's time zone.
+  google.protobuf.StringValue value = 2;
+
+  // The relative date value of the right hand side denoted by number of days
+  // offset from now. The value field will override this field when both are
+  // present.
+  google.protobuf.Int64Value offset_in_days = 3;
+}
+
+// A rule item composed of number operation.
+message UserListNumberRuleItemInfo {
+  // Number comparison operator.
+  // This field is required and must be populated when creating a new number
+  // rule item.
+  google.ads.googleads.v1.enums.UserListNumberRuleItemOperatorEnum.UserListNumberRuleItemOperator operator = 1;
+
+  // Number value to be compared with the variable.
+  // This field is required and must be populated when creating a new number
+  // rule item.
+  google.protobuf.DoubleValue value = 2;
+}
+
+// A rule item fragment composed of date operation.
+message UserListStringRuleItemInfo {
+  // String comparison operator.
+  // This field is required and must be populated when creating a new string
+  // rule item.
+  google.ads.googleads.v1.enums.UserListStringRuleItemOperatorEnum.UserListStringRuleItemOperator operator = 1;
+
+  // The right hand side of the string rule item. For URLs or referrer URLs,
+  // the value can not contain illegal URL chars such as newlines, quotes,
+  // tabs, or parentheses. This field is required and must be populated when
+  // creating a new string rule item.
+  google.protobuf.StringValue value = 2;
+}
+
+// User lists defined by combining two rules, left operand and right operand.
+// There are two operators: AND where left operand and right operand have to be
+// true; AND_NOT where left operand is true but right operand is false.
+message CombinedRuleUserListInfo {
+  // Left operand of the combined rule.
+  // This field is required and must be populated when creating new combined
+  // rule based user list.
+  UserListRuleInfo left_operand = 1;
+
+  // Right operand of the combined rule.
+  // This field is required and must be populated when creating new combined
+  // rule based user list.
+  UserListRuleInfo right_operand = 2;
+
+  // Operator to connect the two operands.
+  //
+  // Required for creating a combined rule user list.
+  google.ads.googleads.v1.enums.UserListCombinedRuleOperatorEnum.UserListCombinedRuleOperator rule_operator = 3;
+}
+
+// Visitors of a page during specific dates.
+message DateSpecificRuleUserListInfo {
+  // Boolean rule that defines visitor of a page.
+  //
+  // Required for creating a date specific rule user list.
+  UserListRuleInfo rule = 1;
+
+  // Start date of users visit. If set to 2000-01-01, then the list includes all
+  // users before end_date. The date's format should be YYYY-MM-DD.
+  //
+  // Required for creating a data specific rule user list.
+  google.protobuf.StringValue start_date = 2;
+
+  // End date of users visit. If set to 2037-12-30, then the list includes all
+  // users after start_date. The date's format should be YYYY-MM-DD.
+  //
+  // Required for creating a data specific rule user list.
+  google.protobuf.StringValue end_date = 3;
+}
+
+// Visitors of a page. The page visit is defined by one boolean rule expression.
+message ExpressionRuleUserListInfo {
+  // Boolean rule that defines this user list. The rule consists of a list of
+  // rule item groups and each rule item group consists of a list of rule items.
+  // All the rule item groups are ORed or ANDed together for evaluation based on
+  // rule.rule_type.
+  //
+  // Required for creating an expression rule user list.
+  UserListRuleInfo rule = 1;
+}
+
+// Representation of a userlist that is generated by a rule.
+message RuleBasedUserListInfo {
+  // The status of pre-population. The field is default to NONE if not set which
+  // means the previous users will not be considered. If set to REQUESTED, past
+  // site visitors or app users who match the list definition will be included
+  // in the list (works on the Display Network only). This will only
+  // add past users from within the last 30 days, depending on the
+  // list's membership duration and the date when the remarketing tag is added.
+  // The status will be updated to FINISHED once request is processed, or FAILED
+  // if the request fails.
+  google.ads.googleads.v1.enums.UserListPrepopulationStatusEnum.UserListPrepopulationStatus prepopulation_status = 1;
+
+  // Subtypes of rule based user lists.
+  oneof rule_based_user_list {
+    // User lists defined by combining two rules.
+    // There are two operators: AND, where the left and right operands have to
+    // be true; AND_NOT where left operand is true but right operand is false.
+    CombinedRuleUserListInfo combined_rule_user_list = 2;
+
+    // Visitors of a page during specific dates. The visiting periods are
+    // defined as follows:
+    // Between start_date (inclusive) and end_date (inclusive);
+    // Before end_date (exclusive) with start_date = 2000-01-01;
+    // After start_date (exclusive) with end_date = 2037-12-30.
+    DateSpecificRuleUserListInfo date_specific_rule_user_list = 3;
+
+    // Visitors of a page. The page visit is defined by one boolean rule
+    // expression.
+    ExpressionRuleUserListInfo expression_rule_user_list = 4;
+  }
+}
+
+// Represents a user list that is a custom combination of user lists.
+message LogicalUserListInfo {
+  // Logical list rules that define this user list. The rules are defined as a
+  // logical operator (ALL/ANY/NONE) and a list of user lists. All the rules are
+  // ANDed when they are evaluated.
+  //
+  // Required for creating a logical user list.
+  repeated UserListLogicalRuleInfo rules = 1;
+}
+
+// A user list logical rule. A rule has a logical operator (and/or/not) and a
+// list of user lists as operands.
+message UserListLogicalRuleInfo {
+  // The logical operator of the rule.
+  google.ads.googleads.v1.enums.UserListLogicalRuleOperatorEnum.UserListLogicalRuleOperator operator = 1;
+
+  // The list of operands of the rule.
+  repeated LogicalUserListOperandInfo rule_operands = 2;
+}
+
+// Operand of logical user list that consists of a user list.
+message LogicalUserListOperandInfo {
+  // Resource name of a user list as an operand.
+  google.protobuf.StringValue user_list = 1;
+}
+
+// User list targeting as a collection of conversions or remarketing actions.
+message BasicUserListInfo {
+  // Actions associated with this user list.
+  repeated UserListActionInfo actions = 1;
+}
+
+// Represents an action type used for building remarketing user lists.
+message UserListActionInfo {
+  // Subtypes of user list action.
+  oneof user_list_action {
+    // A conversion action that's not generated from remarketing.
+    google.protobuf.StringValue conversion_action = 1;
+
+    // A remarketing action.
+    google.protobuf.StringValue remarketing_action = 2;
+  }
+}

third_party/google/ads/googleads/v1/common/value.proto

@@ -0,0 +1,52 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.common;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "ValueProto";
+option java_package = "com.google.ads.googleads.v1.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V1::Common";
+
+// Proto file describing value types
+
+// A generic data container.
+message Value {
+  // A value.
+  oneof value {
+    // A boolean.
+    bool boolean_value = 1;
+
+    // An int64.
+    int64 int64_value = 2;
+
+    // A float.
+    float float_value = 3;
+
+    // A double.
+    double double_value = 4;
+
+    // A string.
+    string string_value = 5;
+  }
+}

third_party/google/ads/googleads/v1/enums/access_reason.proto

@@ -0,0 +1,58 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AccessReasonProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Indicates the way the resource such as user list is related to a user.
+message AccessReasonEnum {
+  // Enum describing possible access reasons.
+  enum AccessReason {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // The resource is owned by the user.
+    OWNED = 2;
+
+    // The resource is shared to the user.
+    SHARED = 3;
+
+    // The resource is licensed to the user.
+    LICENSED = 4;
+
+    // The user subscribed to the resource.
+    SUBSCRIBED = 5;
+
+    // The resource is accessible to the user.
+    AFFILIATED = 6;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/account_budget_proposal_status.proto

@@ -0,0 +1,64 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AccountBudgetProposalStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing AccountBudgetProposal statuses.
+
+// Message describing AccountBudgetProposal statuses.
+message AccountBudgetProposalStatusEnum {
+  // The possible statuses of an AccountBudgetProposal.
+  enum AccountBudgetProposalStatus {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // The proposal is pending approval.
+    PENDING = 2;
+
+    // The proposal has been approved but the corresponding billing setup
+    // has not.  This can occur for proposals that set up the first budget
+    // when signing up for billing or when performing a change of bill-to
+    // operation.
+    APPROVED_HELD = 3;
+
+    // The proposal has been approved.
+    APPROVED = 4;
+
+    // The proposal has been cancelled by the user.
+    CANCELLED = 5;
+
+    // The proposal has been rejected by the user, e.g. by rejecting an
+    // acceptance email.
+    REJECTED = 6;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/account_budget_proposal_type.proto

@@ -0,0 +1,57 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AccountBudgetProposalTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing AccountBudgetProposal types.
+
+// Message describing AccountBudgetProposal types.
+message AccountBudgetProposalTypeEnum {
+  // The possible types of an AccountBudgetProposal.
+  enum AccountBudgetProposalType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Identifies a request to create a new budget.
+    CREATE = 2;
+
+    // Identifies a request to edit an existing budget.
+    UPDATE = 3;
+
+    // Identifies a request to end a budget that has already started.
+    END = 4;
+
+    // Identifies a request to remove a budget that hasn't started yet.
+    REMOVE = 5;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/account_budget_status.proto

@@ -0,0 +1,54 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AccountBudgetStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing AccountBudget statuses.
+
+// Message describing AccountBudget statuses.
+message AccountBudgetStatusEnum {
+  // The possible statuses of an AccountBudget.
+  enum AccountBudgetStatus {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // The account budget is pending approval.
+    PENDING = 2;
+
+    // The account budget has been approved.
+    APPROVED = 3;
+
+    // The account budget has been cancelled by the user.
+    CANCELLED = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/ad_customizer_placeholder_field.proto

@@ -0,0 +1,57 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdCustomizerPlaceholderFieldProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing Ad Customizer placeholder fields.
+
+// Values for Ad Customizer placeholder fields.
+message AdCustomizerPlaceholderFieldEnum {
+  // Possible values for Ad Customizers placeholder fields.
+  enum AdCustomizerPlaceholderField {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Data Type: INT64. Integer value to be inserted.
+    INTEGER = 2;
+
+    // Data Type: STRING. Price value to be inserted.
+    PRICE = 3;
+
+    // Data Type: DATE_TIME. Date value to be inserted.
+    DATE = 4;
+
+    // Data Type: STRING. String value to be inserted.
+    STRING = 5;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/ad_group_ad_rotation_mode.proto

@@ -0,0 +1,54 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdGroupAdRotationModeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing ad group ad rotation mode.
+
+// Container for enum describing possible ad rotation modes of ads within an
+// ad group.
+message AdGroupAdRotationModeEnum {
+  // The possible ad rotation modes of an ad group.
+  enum AdGroupAdRotationMode {
+    // The ad rotation mode has not been specified.
+    UNSPECIFIED = 0;
+
+    // The received value is not known in this version.
+    //
+    // This is a response-only value.
+    UNKNOWN = 1;
+
+    // Optimize ad group ads based on clicks or conversions.
+    OPTIMIZE = 2;
+
+    // Rotate evenly forever.
+    ROTATE_FOREVER = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/ad_group_ad_status.proto

@@ -0,0 +1,56 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdGroupAdStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing ad group status.
+
+// Container for enum describing possible statuses of an AdGroupAd.
+message AdGroupAdStatusEnum {
+  // The possible statuses of an AdGroupAd.
+  enum AdGroupAdStatus {
+    // No value has been specified.
+    UNSPECIFIED = 0;
+
+    // The received value is not known in this version.
+    //
+    // This is a response-only value.
+    UNKNOWN = 1;
+
+    // The ad group ad is enabled.
+    ENABLED = 2;
+
+    // The ad group ad is paused.
+    PAUSED = 3;
+
+    // The ad group ad is removed.
+    REMOVED = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/ad_group_criterion_approval_status.proto

@@ -0,0 +1,57 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdGroupCriterionApprovalStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing approval status for the criterion.
+
+// Container for enum describing possible AdGroupCriterion approval statuses.
+message AdGroupCriterionApprovalStatusEnum {
+  // Enumerates AdGroupCriterion approval statuses.
+  enum AdGroupCriterionApprovalStatus {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // The value is unknown in this version.
+    UNKNOWN = 1;
+
+    // Approved.
+    APPROVED = 2;
+
+    // Disapproved.
+    DISAPPROVED = 3;
+
+    // Pending Review.
+    PENDING_REVIEW = 4;
+
+    // Under review.
+    UNDER_REVIEW = 5;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/ad_group_criterion_status.proto

@@ -0,0 +1,56 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdGroupCriterionStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing AdGroupCriterion statuses.
+
+// Message describing AdGroupCriterion statuses.
+message AdGroupCriterionStatusEnum {
+  // The possible statuses of an AdGroupCriterion.
+  enum AdGroupCriterionStatus {
+    // No value has been specified.
+    UNSPECIFIED = 0;
+
+    // The received value is not known in this version.
+    //
+    // This is a response-only value.
+    UNKNOWN = 1;
+
+    // The ad group criterion is enabled.
+    ENABLED = 2;
+
+    // The ad group criterion is paused.
+    PAUSED = 3;
+
+    // The ad group criterion is removed.
+    REMOVED = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/ad_group_status.proto

@@ -0,0 +1,56 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdGroupStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing ad group status.
+
+// Container for enum describing possible statuses of an ad group.
+message AdGroupStatusEnum {
+  // The possible statuses of an ad group.
+  enum AdGroupStatus {
+    // The status has not been specified.
+    UNSPECIFIED = 0;
+
+    // The received value is not known in this version.
+    //
+    // This is a response-only value.
+    UNKNOWN = 1;
+
+    // The ad group is enabled.
+    ENABLED = 2;
+
+    // The ad group is paused.
+    PAUSED = 3;
+
+    // The ad group is removed.
+    REMOVED = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/ad_group_type.proto

@@ -0,0 +1,82 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdGroupTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing ad group types.
+
+// Defines types of an ad group, specific to a particular campaign channel
+// type. This type drives validations that restrict which entities can be
+// added to the ad group.
+message AdGroupTypeEnum {
+  // Enum listing the possible types of an ad group.
+  enum AdGroupType {
+    // The type has not been specified.
+    UNSPECIFIED = 0;
+
+    // The received value is not known in this version.
+    //
+    // This is a response-only value.
+    UNKNOWN = 1;
+
+    // The default ad group type for Search campaigns.
+    SEARCH_STANDARD = 2;
+
+    // The default ad group type for Display campaigns.
+    DISPLAY_STANDARD = 3;
+
+    // The ad group type for Shopping campaigns serving standard product ads.
+    SHOPPING_PRODUCT_ADS = 4;
+
+    // The default ad group type for Hotel campaigns.
+    HOTEL_ADS = 6;
+
+    // The type for ad groups in Smart Shopping campaigns.
+    SHOPPING_SMART_ADS = 7;
+
+    // Short unskippable in-stream video ads.
+    VIDEO_BUMPER = 8;
+
+    // TrueView (skippable) in-stream video ads.
+    VIDEO_TRUE_VIEW_IN_STREAM = 9;
+
+    // TrueView in-display video ads.
+    VIDEO_TRUE_VIEW_IN_DISPLAY = 10;
+
+    // Unskippable in-stream video ads.
+    VIDEO_NON_SKIPPABLE_IN_STREAM = 11;
+
+    // Outstream video ads.
+    VIDEO_OUTSTREAM = 12;
+
+    // Ad group type for Dynamic Search Ads ad groups.
+    SEARCH_DYNAMIC_ADS = 13;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/ad_network_type.proto

@@ -0,0 +1,63 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdNetworkTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing ad network types.
+
+// Container for enumeration of Google Ads network types.
+message AdNetworkTypeEnum {
+  // Enumerates Google Ads network types.
+  enum AdNetworkType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // The value is unknown in this version.
+    UNKNOWN = 1;
+
+    // Google search.
+    SEARCH = 2;
+
+    // Search partners.
+    SEARCH_PARTNERS = 3;
+
+    // Display Network.
+    CONTENT = 4;
+
+    // YouTube Search.
+    YOUTUBE_SEARCH = 5;
+
+    // YouTube Videos
+    YOUTUBE_WATCH = 6;
+
+    // Cross-network.
+    MIXED = 7;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/ad_serving_optimization_status.proto

@@ -0,0 +1,65 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdServingOptimizationStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing ad serving statuses.
+
+// Possible ad serving statuses of a campaign.
+message AdServingOptimizationStatusEnum {
+  // Enum describing possible serving statuses.
+  enum AdServingOptimizationStatus {
+    // No value has been specified.
+    UNSPECIFIED = 0;
+
+    // The received value is not known in this version.
+    //
+    // This is a response-only value.
+    UNKNOWN = 1;
+
+    // Ad serving is optimized based on CTR for the campaign.
+    OPTIMIZE = 2;
+
+    // Ad serving is optimized based on CTR * Conversion for the campaign. If
+    // the campaign is not in the conversion optimizer bidding strategy, it will
+    // default to OPTIMIZED.
+    CONVERSION_OPTIMIZE = 3;
+
+    // Ads are rotated evenly for 90 days, then optimized for clicks.
+    ROTATE = 4;
+
+    // Show lower performing ads more evenly with higher performing ads, and do
+    // not optimize.
+    ROTATE_INDEFINITELY = 5;
+
+    // Ad serving optimization status is not available.
+    UNAVAILABLE = 6;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/ad_strength.proto

@@ -0,0 +1,63 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdStrengthProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing ad strengths.
+
+// Container for enum describing possible ad strengths.
+message AdStrengthEnum {
+  // Enum listing the possible ad strengths.
+  enum AdStrength {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // The ad strength is currently pending.
+    PENDING = 2;
+
+    // No ads could be generated.
+    NO_ADS = 3;
+
+    // Poor strength.
+    POOR = 4;
+
+    // Average strength.
+    AVERAGE = 5;
+
+    // Good strength.
+    GOOD = 6;
+
+    // Excellent strength.
+    EXCELLENT = 7;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/ad_type.proto

@@ -0,0 +1,102 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing the ad type.
+
+// Container for enum describing possible types of an ad.
+message AdTypeEnum {
+  // The possible types of an ad.
+  enum AdType {
+    // No value has been specified.
+    UNSPECIFIED = 0;
+
+    // The received value is not known in this version.
+    //
+    // This is a response-only value.
+    UNKNOWN = 1;
+
+    // The ad is a text ad.
+    TEXT_AD = 2;
+
+    // The ad is an expanded text ad.
+    EXPANDED_TEXT_AD = 3;
+
+    // The ad is a call only ad.
+    CALL_ONLY_AD = 6;
+
+    // The ad is an expanded dynamic search ad.
+    EXPANDED_DYNAMIC_SEARCH_AD = 7;
+
+    // The ad is a hotel ad.
+    HOTEL_AD = 8;
+
+    // The ad is a Smart Shopping ad.
+    SHOPPING_SMART_AD = 9;
+
+    // The ad is a standard Shopping ad.
+    SHOPPING_PRODUCT_AD = 10;
+
+    // The ad is a video ad.
+    VIDEO_AD = 12;
+
+    // This ad is a Gmail ad.
+    GMAIL_AD = 13;
+
+    // This ad is an Image ad.
+    IMAGE_AD = 14;
+
+    // The ad is a responsive search ad.
+    RESPONSIVE_SEARCH_AD = 15;
+
+    // The ad is a legacy responsive display ad.
+    LEGACY_RESPONSIVE_DISPLAY_AD = 16;
+
+    // The ad is an app ad.
+    APP_AD = 17;
+
+    // The ad is a legacy app install ad.
+    LEGACY_APP_INSTALL_AD = 18;
+
+    // The ad is a responsive display ad.
+    RESPONSIVE_DISPLAY_AD = 19;
+
+    // The ad is a display upload ad with the HTML5_UPLOAD_AD product type.
+    HTML5_UPLOAD_AD = 21;
+
+    // The ad is a display upload ad with one of the DYNAMIC_HTML5_* product
+    // types.
+    DYNAMIC_HTML5_AD = 22;
+
+    // The ad is an app engagement ad.
+    APP_ENGAGEMENT_AD = 23;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/advertising_channel_sub_type.proto

@@ -0,0 +1,85 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdvertisingChannelSubTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing advertising channel subtypes.
+
+// An immutable specialization of an Advertising Channel.
+message AdvertisingChannelSubTypeEnum {
+  // Enum describing the different channel subtypes.
+  enum AdvertisingChannelSubType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used as a return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Mobile app campaigns for Search.
+    SEARCH_MOBILE_APP = 2;
+
+    // Mobile app campaigns for Display.
+    DISPLAY_MOBILE_APP = 3;
+
+    // AdWords express campaigns for search.
+    SEARCH_EXPRESS = 4;
+
+    // AdWords Express campaigns for display.
+    DISPLAY_EXPRESS = 5;
+
+    // Smart Shopping campaigns.
+    SHOPPING_SMART_ADS = 6;
+
+    // Gmail Ad campaigns.
+    DISPLAY_GMAIL_AD = 7;
+
+    // Smart display campaigns.
+    DISPLAY_SMART_CAMPAIGN = 8;
+
+    // Video Outstream campaigns.
+    VIDEO_OUTSTREAM = 9;
+
+    // Video TrueView for Action campaigns.
+    VIDEO_ACTION = 10;
+
+    // Video campaigns with non-skippable video ads.
+    VIDEO_NON_SKIPPABLE = 11;
+
+    // App Campaign that allows you to easily promote your Android or iOS app
+    // across Google's top properties including Search, Play, YouTube, and the
+    // Google Display Network.
+    APP_CAMPAIGN = 12;
+
+    // App Campaign for engagement, focused on driving re-engagement with the
+    // app across several of Google’s top properties including Search, YouTube,
+    // and the Google Display Network.
+    APP_CAMPAIGN_FOR_ENGAGEMENT = 13;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/advertising_channel_type.proto

@@ -0,0 +1,65 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AdvertisingChannelTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing advertising channel types
+
+// The channel type a campaign may target to serve on.
+message AdvertisingChannelTypeEnum {
+  // Enum describing the various advertising channel types.
+  enum AdvertisingChannelType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Search Network. Includes display bundled, and Search+ campaigns.
+    SEARCH = 2;
+
+    // Google Display Network only.
+    DISPLAY = 3;
+
+    // Shopping campaigns serve on the shopping property
+    // and on google.com search results.
+    SHOPPING = 4;
+
+    // Hotel Ads campaigns.
+    HOTEL = 5;
+
+    // Video campaigns.
+    VIDEO = 6;
+
+    // App Campaigns, and App Campaigns for Engagement, that run
+    // across multiple channels.
+    MULTI_CHANNEL = 7;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/affiliate_location_feed_relationship_type.proto

@@ -0,0 +1,49 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AffiliateLocationFeedRelationshipTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing relation type for affiliate location feeds.
+
+// Container for enum describing possible values for a relationship type for
+// an affiliate location feed.
+message AffiliateLocationFeedRelationshipTypeEnum {
+  // Possible values for a relationship type for an affiliate location feed.
+  enum AffiliateLocationFeedRelationshipType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // General retailer relationship.
+    GENERAL_RETAILER = 2;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/affiliate_location_placeholder_field.proto

@@ -0,0 +1,78 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AffiliateLocationPlaceholderFieldProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing Affiliate Location placeholder fields.
+
+// Values for Affiliate Location placeholder fields.
+message AffiliateLocationPlaceholderFieldEnum {
+  // Possible values for Affiliate Location placeholder fields.
+  enum AffiliateLocationPlaceholderField {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Data Type: STRING. The name of the business.
+    BUSINESS_NAME = 2;
+
+    // Data Type: STRING. Line 1 of the business address.
+    ADDRESS_LINE_1 = 3;
+
+    // Data Type: STRING. Line 2 of the business address.
+    ADDRESS_LINE_2 = 4;
+
+    // Data Type: STRING. City of the business address.
+    CITY = 5;
+
+    // Data Type: STRING. Province of the business address.
+    PROVINCE = 6;
+
+    // Data Type: STRING. Postal code of the business address.
+    POSTAL_CODE = 7;
+
+    // Data Type: STRING. Country code of the business address.
+    COUNTRY_CODE = 8;
+
+    // Data Type: STRING. Phone number of the business.
+    PHONE_NUMBER = 9;
+
+    // Data Type: STRING. Language code of the business.
+    LANGUAGE_CODE = 10;
+
+    // Data Type: INT64. ID of the chain.
+    CHAIN_ID = 11;
+
+    // Data Type: STRING. Name of the chain.
+    CHAIN_NAME = 12;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/age_range_type.proto

@@ -0,0 +1,66 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AgeRangeTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing age range types.
+
+// Container for enum describing the type of demographic age ranges.
+message AgeRangeTypeEnum {
+  // The type of demographic age ranges (e.g. between 18 and 24 years old).
+  enum AgeRangeType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Between 18 and 24 years old.
+    AGE_RANGE_18_24 = 503001;
+
+    // Between 25 and 34 years old.
+    AGE_RANGE_25_34 = 503002;
+
+    // Between 35 and 44 years old.
+    AGE_RANGE_35_44 = 503003;
+
+    // Between 45 and 54 years old.
+    AGE_RANGE_45_54 = 503004;
+
+    // Between 55 and 64 years old.
+    AGE_RANGE_55_64 = 503005;
+
+    // 65 years old and beyond.
+    AGE_RANGE_65_UP = 503006;
+
+    // Undetermined age range.
+    AGE_RANGE_UNDETERMINED = 503999;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/app_campaign_app_store.proto

@@ -0,0 +1,51 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AppCampaignAppStoreProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing App Campaign app store.
+
+// The application store that distributes mobile applications.
+message AppCampaignAppStoreEnum {
+  // Enum describing app campaign app store.
+  enum AppCampaignAppStore {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Apple app store.
+    APPLE_APP_STORE = 2;
+
+    // Google play.
+    GOOGLE_APP_STORE = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/app_campaign_bidding_strategy_goal_type.proto

@@ -0,0 +1,65 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AppCampaignBiddingStrategyGoalTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing App Campaign bidding strategy goal types.
+
+// Container for enum describing goal towards which the bidding strategy of an
+// app campaign should optimize for.
+message AppCampaignBiddingStrategyGoalTypeEnum {
+  // Goal type of App campaign BiddingStrategy.
+  enum AppCampaignBiddingStrategyGoalType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Aim to maximize the number of app installs. The cpa bid is the
+    // target cost per install.
+    OPTIMIZE_INSTALLS_TARGET_INSTALL_COST = 2;
+
+    // Aim to maximize the long term number of selected in-app conversions from
+    // app installs. The cpa bid is the target cost per install.
+    OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST = 3;
+
+    // Aim to maximize the long term number of selected in-app conversions from
+    // app installs. The cpa bid is the target cost per in-app conversion. Note
+    // that the actual cpa may seem higher than the target cpa at first, since
+    // the long term conversions haven’t happened yet.
+    OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST = 4;
+
+    // Aim to maximize all conversions' value, i.e. install + selected in-app
+    // conversions while achieving or exceeding target return on advertising
+    // spend.
+    OPTIMIZE_RETURN_ON_ADVERTISING_SPEND = 5;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/app_payment_model_type.proto

@@ -0,0 +1,48 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AppPaymentModelTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing criteria types.
+
+// Represents a criterion for targeting paid apps.
+message AppPaymentModelTypeEnum {
+  // Enum describing possible app payment models.
+  enum AppPaymentModelType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Represents paid-for apps.
+    PAID = 30;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/app_placeholder_field.proto

@@ -0,0 +1,76 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AppPlaceholderFieldProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing App placeholder fields.
+
+// Values for App placeholder fields.
+message AppPlaceholderFieldEnum {
+  // Possible values for App placeholder fields.
+  enum AppPlaceholderField {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Data Type: INT64. The application store that the target application
+    // belongs to. Valid values are: 1 = Apple iTunes Store; 2 = Google Play
+    // Store.
+    STORE = 2;
+
+    // Data Type: STRING. The store-specific ID for the target application.
+    ID = 3;
+
+    // Data Type: STRING. The visible text displayed when the link is rendered
+    // in an ad.
+    LINK_TEXT = 4;
+
+    // Data Type: STRING. The destination URL of the in-app link.
+    URL = 5;
+
+    // Data Type: URL_LIST. Final URLs for the in-app link when using Upgraded
+    // URLs.
+    FINAL_URLS = 6;
+
+    // Data Type: URL_LIST. Final Mobile URLs for the in-app link when using
+    // Upgraded URLs.
+    FINAL_MOBILE_URLS = 7;
+
+    // Data Type: URL. Tracking template for the in-app link when using Upgraded
+    // URLs.
+    TRACKING_URL = 8;
+
+    // Data Type: STRING. Final URL suffix for the in-app link when using
+    // parallel tracking.
+    FINAL_URL_SUFFIX = 9;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/app_store.proto

@@ -0,0 +1,51 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AppStoreProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing app store types for an app extension.
+
+// Container for enum describing app store type in an app extension.
+message AppStoreEnum {
+  // App store type in an app extension.
+  enum AppStore {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Apple iTunes.
+    APPLE_ITUNES = 2;
+
+    // Google Play.
+    GOOGLE_PLAY = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/app_url_operating_system_type.proto

@@ -0,0 +1,51 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AppUrlOperatingSystemTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing operating system for a deeplink app URL.
+
+// The possible OS types for a deeplink AppUrl.
+message AppUrlOperatingSystemTypeEnum {
+  // Operating System
+  enum AppUrlOperatingSystemType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // The Apple IOS operating system.
+    IOS = 2;
+
+    // The Android operating system.
+    ANDROID = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/asset_type.proto

@@ -0,0 +1,57 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AssetTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing asset type.
+
+// Container for enum describing the types of asset.
+message AssetTypeEnum {
+  // Enum describing possible types of asset.
+  enum AssetType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // YouTube video asset.
+    YOUTUBE_VIDEO = 2;
+
+    // Media bundle asset.
+    MEDIA_BUNDLE = 3;
+
+    // Image asset.
+    IMAGE = 4;
+
+    // Text asset.
+    TEXT = 5;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/attribution_model.proto

@@ -0,0 +1,73 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "AttributionModelProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Container for enum representing the attribution model that describes how to
+// distribute credit for a particular conversion across potentially many prior
+// interactions.
+message AttributionModelEnum {
+  // The attribution model that describes how to distribute credit for a
+  // particular conversion across potentially many prior interactions.
+  enum AttributionModel {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Uses external attribution.
+    EXTERNAL = 100;
+
+    // Attributes all credit for a conversion to its last click.
+    GOOGLE_ADS_LAST_CLICK = 101;
+
+    // Attributes all credit for a conversion to its first click using Google
+    // Search attribution.
+    GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK = 102;
+
+    // Attributes credit for a conversion equally across all of its clicks using
+    // Google Search attribution.
+    GOOGLE_SEARCH_ATTRIBUTION_LINEAR = 103;
+
+    // Attributes exponentially more credit for a conversion to its more recent
+    // clicks using Google Search attribution (half-life is 1 week).
+    GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY = 104;
+
+    // Attributes 40% of the credit for a conversion to its first and last
+    // clicks. Remaining 20% is evenly distributed across all other clicks. This
+    // uses Google Search attribution.
+    GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED = 105;
+
+    // Flexible model that uses machine learning to determine the appropriate
+    // distribution of credit among clicks using Google Search attribution.
+    GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN = 106;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/bid_modifier_source.proto

@@ -0,0 +1,52 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "BidModifierSourceProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing bid modifier source.
+
+// Container for enum describing possible bid modifier sources.
+message BidModifierSourceEnum {
+  // Enum describing possible bid modifier sources.
+  enum BidModifierSource {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // The bid modifier is specified at the campaign level, on the campaign
+    // level criterion.
+    CAMPAIGN = 2;
+
+    // The bid modifier is specified (overridden) at the ad group level.
+    AD_GROUP = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/bidding_source.proto

@@ -0,0 +1,56 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "BiddingSourceProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing bidding sources.
+
+// Container for enum describing possible bidding sources.
+message BiddingSourceEnum {
+  // Indicates where a bid or target is defined. For example, an ad group
+  // criterion may define a cpc bid directly, or it can inherit its cpc bid from
+  // the ad group.
+  enum BiddingSource {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Effective bid or target is inherited from campaign bidding strategy.
+    CAMPAIGN_BIDDING_STRATEGY = 5;
+
+    // The bid or target is defined on the ad group.
+    AD_GROUP = 6;
+
+    // The bid or target is defined on the ad group criterion.
+    AD_GROUP_CRITERION = 7;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/bidding_strategy_status.proto

@@ -0,0 +1,53 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "BiddingStrategyStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing BiddingStrategy statuses.
+
+// Message describing BiddingStrategy statuses.
+message BiddingStrategyStatusEnum {
+  // The possible statuses of a BiddingStrategy.
+  enum BiddingStrategyStatus {
+    // No value has been specified.
+    UNSPECIFIED = 0;
+
+    // The received value is not known in this version.
+    //
+    // This is a response-only value.
+    UNKNOWN = 1;
+
+    // The bidding strategy is enabled.
+    ENABLED = 2;
+
+    // The bidding strategy is removed.
+    REMOVED = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/bidding_strategy_type.proto

@@ -0,0 +1,105 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "BiddingStrategyTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing bidding schemes.
+
+// Container for enum describing possible bidding strategy types.
+message BiddingStrategyTypeEnum {
+  // Enum describing possible bidding strategy types.
+  enum BiddingStrategyType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Enhanced CPC is a bidding strategy that raises bids for clicks
+    // that seem more likely to lead to a conversion and lowers
+    // them for clicks where they seem less likely.
+    ENHANCED_CPC = 2;
+
+    // Manual click based bidding where user pays per click.
+    MANUAL_CPC = 3;
+
+    // Manual impression based bidding
+    // where user pays per thousand impressions.
+    MANUAL_CPM = 4;
+
+    // A bidding strategy that pays a configurable amount per video view.
+    MANUAL_CPV = 13;
+
+    // A bidding strategy that automatically maximizes number of conversions
+    // given a daily budget.
+    MAXIMIZE_CONVERSIONS = 10;
+
+    // An automated bidding strategy that automatically sets bids to maximize
+    // revenue while spending your budget.
+    MAXIMIZE_CONVERSION_VALUE = 11;
+
+    // Page-One Promoted bidding scheme, which sets max cpc bids to
+    // target impressions on page one or page one promoted slots on google.com.
+    PAGE_ONE_PROMOTED = 5;
+
+    // Percent Cpc is bidding strategy where bids are a fraction of the
+    // advertised price for some good or service.
+    PERCENT_CPC = 12;
+
+    // Target CPA is an automated bid strategy that sets bids
+    // to help get as many conversions as possible
+    // at the target cost-per-acquisition (CPA) you set.
+    TARGET_CPA = 6;
+
+    // Target CPM is an automated bid strategy that sets bids to help get
+    // as many impressions as possible at the target cost per one thousand
+    // impressions (CPM) you set.
+    TARGET_CPM = 14;
+
+    // An automated bidding strategy that sets bids so that a certain percentage
+    // of search ads are shown at the top of the first page (or other targeted
+    // location).
+    TARGET_IMPRESSION_SHARE = 15;
+
+    // Target Outrank Share is an automated bidding strategy that sets bids
+    // based on the target fraction of auctions where the advertiser
+    // should outrank a specific competitor.
+    TARGET_OUTRANK_SHARE = 7;
+
+    // Target ROAS is an automated bidding strategy
+    // that helps you maximize revenue while averaging
+    // a specific target Return On Average Spend (ROAS).
+    TARGET_ROAS = 8;
+
+    // Target Spend is an automated bid strategy that sets your bids
+    // to help get as many clicks as possible within your budget.
+    TARGET_SPEND = 9;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/billing_setup_status.proto

@@ -0,0 +1,59 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "BillingSetupStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing BillingSetup statuses.
+
+// Message describing BillingSetup statuses.
+message BillingSetupStatusEnum {
+  // The possible statuses of a BillingSetup.
+  enum BillingSetupStatus {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // The billing setup is pending approval.
+    PENDING = 2;
+
+    // The billing setup has been approved but the corresponding first budget
+    // has not.  This can only occur for billing setups configured for monthly
+    // invoicing.
+    APPROVED_HELD = 3;
+
+    // The billing setup has been approved.
+    APPROVED = 4;
+
+    // The billing setup was cancelled by the user prior to approval.
+    CANCELLED = 5;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/brand_safety_suitability.proto

@@ -0,0 +1,74 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "BrandSafetySuitabilityProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing brand safety suitability settings.
+
+// Container for enum with 3-Tier brand safety suitability control.
+message BrandSafetySuitabilityEnum {
+  // 3-Tier brand safety suitability control.
+  enum BrandSafetySuitability {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // This option lets you show ads across all inventory on YouTube and video
+    // partners that meet our standards for monetization. This option may be an
+    // appropriate choice for brands that want maximum access to the full
+    // breadth of videos eligible for ads, including, for example, videos that
+    // have strong profanity in the context of comedy or a documentary, or
+    // excessive violence as featured in video games.
+    EXPANDED_INVENTORY = 2;
+
+    // This option lets you show ads across a wide range of content that's
+    // appropriate for most brands, such as popular music videos, documentaries,
+    // and movie trailers. The content you can show ads on is based on YouTube's
+    // advertiser-friendly content guidelines that take into account, for
+    // example, the strength or frequency of profanity, or the appropriateness
+    // of subject matter like sensitive events. Ads won't show, for example, on
+    // content with repeated strong profanity, strong sexual content, or graphic
+    // violence.
+    STANDARD_INVENTORY = 3;
+
+    // This option lets you show ads on a reduced range of content that's
+    // appropriate for brands with particularly strict guidelines around
+    // inappropriate language and sexual suggestiveness; above and beyond what
+    // YouTube's advertiser-friendly content guidelines address. The videos
+    // accessible in this sensitive category meet heightened requirements,
+    // especially for inappropriate language and sexual suggestiveness. For
+    // example, your ads will be excluded from showing on some of YouTube's most
+    // popular music videos and other pop culture content across YouTube and
+    // Google video partners.
+    LIMITED_INVENTORY = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/budget_delivery_method.proto

@@ -0,0 +1,54 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "BudgetDeliveryMethodProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing Budget delivery methods.
+
+// Message describing Budget delivery methods. A delivery method determines the
+// rate at which the Budget is spent.
+message BudgetDeliveryMethodEnum {
+  // Possible delivery methods of a Budget.
+  enum BudgetDeliveryMethod {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // The budget server will throttle serving evenly across
+    // the entire time period.
+    STANDARD = 2;
+
+    // The budget server will not throttle serving,
+    // and ads will serve as fast as possible.
+    ACCELERATED = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/budget_period.proto

@@ -0,0 +1,54 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "BudgetPeriodProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing Budget delivery methods.
+
+// Message describing Budget period.
+message BudgetPeriodEnum {
+  // Possible period of a Budget.
+  enum BudgetPeriod {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Daily budget.
+    DAILY = 2;
+
+    // Custom budget.
+    CUSTOM = 3;
+
+    // Fixed daily budget.
+    FIXED_DAILY = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/budget_status.proto

@@ -0,0 +1,51 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "BudgetStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing Budget statuses
+
+// Message describing a Budget status
+message BudgetStatusEnum {
+  // Possible statuses of a Budget.
+  enum BudgetStatus {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Budget is enabled.
+    ENABLED = 2;
+
+    // Budget is removed.
+    REMOVED = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/budget_type.proto

@@ -0,0 +1,67 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "BudgetTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing Budget types.
+
+// Describes Budget types.
+message BudgetTypeEnum {
+  // Possible Budget types.
+  enum BudgetType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Budget type for standard Google Ads usage.
+    // Caps daily spend at two times the specified budget amount.
+    // Full details: https://support.google.com/google-ads/answer/6385083
+    STANDARD = 2;
+
+    // Budget type for Hotels Ads commission program.
+    // Full details: https://support.google.com/google-ads/answer/9243945
+    //
+    // This type is only supported by campaigns with
+    // AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION and
+    // PaymentMode.CONVERSION_VALUE.
+    HOTEL_ADS_COMMISSION = 3;
+
+    // Budget type with a fixed cost-per-acquisition (conversion).
+    // Full details: https://support.google.com/google-ads/answer/7528254
+    //
+    // This type is only supported by campaigns with
+    // AdvertisingChannelType.DISPLAY (excluding
+    // AdvertisingChannelSubType.DISPLAY_GMAIL),
+    // BiddingStrategyType.TARGET_CPA and PaymentMode.CONVERSIONS.
+    FIXED_CPA = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/call_conversion_reporting_state.proto

@@ -0,0 +1,57 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CallConversionReportingStateProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing call conversion reporting state.
+
+// Container for enum describing possible data types for call conversion
+// reporting state.
+message CallConversionReportingStateEnum {
+  // Possible data types for a call conversion action state.
+  enum CallConversionReportingState {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Call conversion action is disabled.
+    DISABLED = 2;
+
+    // Call conversion action will use call conversion type set at the
+    // account level.
+    USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION = 3;
+
+    // Call conversion action will use call conversion type set at the resource
+    // (call only ads/call extensions) level.
+    USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/call_placeholder_field.proto

@@ -0,0 +1,67 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CallPlaceholderFieldProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing Call placeholder fields.
+
+// Values for Call placeholder fields.
+message CallPlaceholderFieldEnum {
+  // Possible values for Call placeholder fields.
+  enum CallPlaceholderField {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Data Type: STRING. The advertiser's phone number to append to the ad.
+    PHONE_NUMBER = 2;
+
+    // Data Type: STRING. Uppercase two-letter country code of the advertiser's
+    // phone number.
+    COUNTRY_CODE = 3;
+
+    // Data Type: BOOLEAN. Indicates whether call tracking is enabled. Default:
+    // true.
+    TRACKED = 4;
+
+    // Data Type: INT64. The ID of an AdCallMetricsConversion object. This
+    // object contains the phoneCallDurationfield which is the minimum duration
+    // (in seconds) of a call to be considered a conversion.
+    CONVERSION_TYPE_ID = 5;
+
+    // Data Type: STRING. Indicates whether this call extension uses its own
+    // call conversion setting or follows the account level setting.
+    // Valid values are: USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION and
+    // USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
+    CONVERSION_REPORTING_STATE = 6;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/callout_placeholder_field.proto

@@ -0,0 +1,48 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CalloutPlaceholderFieldProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing Callout placeholder fields.
+
+// Values for Callout placeholder fields.
+message CalloutPlaceholderFieldEnum {
+  // Possible values for Callout placeholder fields.
+  enum CalloutPlaceholderField {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Data Type: STRING. Callout text.
+    CALLOUT_TEXT = 2;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/campaign_experiment_type.proto

@@ -0,0 +1,60 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CampaignExperimentTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing campaign experiment type.
+
+// Container for enum describing campaign experiment type.
+message CampaignExperimentTypeEnum {
+  // Indicates if this campaign is a normal campaign,
+  // a draft campaign, or an experiment campaign.
+  enum CampaignExperimentType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // This is a regular campaign.
+    BASE = 2;
+
+    // This is a draft version of a campaign.
+    // It has some modifications from a base campaign,
+    // but it does not serve or accrue metrics.
+    DRAFT = 3;
+
+    // This is an experiment version of a campaign.
+    // It has some modifications from a base campaign,
+    // and a percentage of traffic is being diverted
+    // from the BASE campaign to this experiment campaign.
+    EXPERIMENT = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/campaign_serving_status.proto

@@ -0,0 +1,62 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CampaignServingStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing Campaign serving statuses.
+
+// Message describing Campaign serving statuses.
+message CampaignServingStatusEnum {
+  // Possible serving statuses of a campaign.
+  enum CampaignServingStatus {
+    // No value has been specified.
+    UNSPECIFIED = 0;
+
+    // The received value is not known in this version.
+    //
+    // This is a response-only value.
+    UNKNOWN = 1;
+
+    // Serving.
+    SERVING = 2;
+
+    // None.
+    NONE = 3;
+
+    // Ended.
+    ENDED = 4;
+
+    // Pending.
+    PENDING = 5;
+
+    // Suspended.
+    SUSPENDED = 6;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/campaign_shared_set_status.proto

@@ -0,0 +1,51 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CampaignSharedSetStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing campaign shared set statuses.
+
+// Container for enum describing types of campaign shared set statuses.
+message CampaignSharedSetStatusEnum {
+  // Enum listing the possible campaign shared set statuses.
+  enum CampaignSharedSetStatus {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // The campaign shared set is enabled.
+    ENABLED = 2;
+
+    // The campaign shared set is removed and can no longer be used.
+    REMOVED = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/campaign_status.proto

@@ -0,0 +1,54 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CampaignStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing campaign status.
+
+// Container for enum describing possible statuses of a campaign.
+message CampaignStatusEnum {
+  // Possible statuses of a campaign.
+  enum CampaignStatus {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Campaign is currently serving ads depending on budget information.
+    ENABLED = 2;
+
+    // Campaign has been paused by the user.
+    PAUSED = 3;
+
+    // Campaign has been removed.
+    REMOVED = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/change_status_operation.proto

@@ -0,0 +1,55 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "ChangeStatusOperationProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing the change status operations.
+
+// Container for enum describing operations for the ChangeStatus resource.
+message ChangeStatusOperationEnum {
+  // Status of the changed resource
+  enum ChangeStatusOperation {
+    // No value has been specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents an unclassified resource unknown
+    // in this version.
+    UNKNOWN = 1;
+
+    // The resource was created.
+    ADDED = 2;
+
+    // The resource was modified.
+    CHANGED = 3;
+
+    // The resource was removed.
+    REMOVED = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/change_status_resource_type.proto

@@ -0,0 +1,77 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "ChangeStatusResourceTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing the resource types the ChangeStatus resource supports.
+
+// Container for enum describing supported resource types for the ChangeStatus
+// resource.
+message ChangeStatusResourceTypeEnum {
+  // Enum listing the resource types support by the ChangeStatus resource.
+  enum ChangeStatusResourceType {
+    // No value has been specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents an unclassified resource unknown
+    // in this version.
+    UNKNOWN = 1;
+
+    // An AdGroup resource change.
+    AD_GROUP = 3;
+
+    // An AdGroupAd resource change.
+    AD_GROUP_AD = 4;
+
+    // An AdGroupCriterion resource change.
+    AD_GROUP_CRITERION = 5;
+
+    // A Campaign resource change.
+    CAMPAIGN = 6;
+
+    // A CampaignCriterion resource change.
+    CAMPAIGN_CRITERION = 7;
+
+    // A Feed resource change.
+    FEED = 9;
+
+    // A FeedItem resource change.
+    FEED_ITEM = 10;
+
+    // An AdGroupFeed resource change.
+    AD_GROUP_FEED = 11;
+
+    // A CampaignFeed resource change.
+    CAMPAIGN_FEED = 12;
+
+    // An AdGroupBidModifier resource change.
+    AD_GROUP_BID_MODIFIER = 13;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/click_type.proto

@@ -0,0 +1,201 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "ClickTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing click types.
+
+// Container for enumeration of Google Ads click types.
+message ClickTypeEnum {
+  // Enumerates Google Ads click types.
+  enum ClickType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // The value is unknown in this version.
+    UNKNOWN = 1;
+
+    // App engagement ad deep link.
+    APP_DEEPLINK = 2;
+
+    // Breadcrumbs.
+    BREADCRUMBS = 3;
+
+    // Broadband Plan.
+    BROADBAND_PLAN = 4;
+
+    // Manually dialed phone calls.
+    CALL_TRACKING = 5;
+
+    // Phone calls.
+    CALLS = 6;
+
+    // Click on engagement ad.
+    CLICK_ON_ENGAGEMENT_AD = 7;
+
+    // Driving direction.
+    GET_DIRECTIONS = 8;
+
+    // Get location details.
+    LOCATION_EXPANSION = 9;
+
+    // Call.
+    LOCATION_FORMAT_CALL = 10;
+
+    // Directions.
+    LOCATION_FORMAT_DIRECTIONS = 11;
+
+    // Image(s).
+    LOCATION_FORMAT_IMAGE = 12;
+
+    // Go to landing page.
+    LOCATION_FORMAT_LANDING_PAGE = 13;
+
+    // Map.
+    LOCATION_FORMAT_MAP = 14;
+
+    // Go to store info.
+    LOCATION_FORMAT_STORE_INFO = 15;
+
+    // Text.
+    LOCATION_FORMAT_TEXT = 16;
+
+    // Mobile phone calls.
+    MOBILE_CALL_TRACKING = 17;
+
+    // Print offer.
+    OFFER_PRINTS = 18;
+
+    // Other.
+    OTHER = 19;
+
+    // Product plusbox offer.
+    PRODUCT_EXTENSION_CLICKS = 20;
+
+    // Shopping - Product - Online.
+    PRODUCT_LISTING_AD_CLICKS = 21;
+
+    // Sitelink.
+    SITELINKS = 22;
+
+    // Show nearby locations.
+    STORE_LOCATOR = 23;
+
+    // Headline.
+    URL_CLICKS = 25;
+
+    // App store.
+    VIDEO_APP_STORE_CLICKS = 26;
+
+    // Call-to-Action overlay.
+    VIDEO_CALL_TO_ACTION_CLICKS = 27;
+
+    // Cards.
+    VIDEO_CARD_ACTION_HEADLINE_CLICKS = 28;
+
+    // End cap.
+    VIDEO_END_CAP_CLICKS = 29;
+
+    // Website.
+    VIDEO_WEBSITE_CLICKS = 30;
+
+    // Visual Sitelinks.
+    VISUAL_SITELINKS = 31;
+
+    // Wireless Plan.
+    WIRELESS_PLAN = 32;
+
+    // Shopping - Product - Local.
+    PRODUCT_LISTING_AD_LOCAL = 33;
+
+    // Shopping - Product - MultiChannel Local.
+    PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL = 34;
+
+    // Shopping - Product - MultiChannel Online.
+    PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE = 35;
+
+    // Shopping - Product - Coupon.
+    PRODUCT_LISTING_ADS_COUPON = 36;
+
+    // Shopping - Product - Sell on Google.
+    PRODUCT_LISTING_AD_TRANSACTABLE = 37;
+
+    // Shopping - Product - App engagement ad deep link.
+    PRODUCT_AD_APP_DEEPLINK = 38;
+
+    // Shopping - Showcase - Category.
+    SHOWCASE_AD_CATEGORY_LINK = 39;
+
+    // Shopping - Showcase - Local storefront.
+    SHOWCASE_AD_LOCAL_STOREFRONT_LINK = 40;
+
+    // Shopping - Showcase - Online product.
+    SHOWCASE_AD_ONLINE_PRODUCT_LINK = 42;
+
+    // Shopping - Showcase - Local product.
+    SHOWCASE_AD_LOCAL_PRODUCT_LINK = 43;
+
+    // Promotion Extension.
+    PROMOTION_EXTENSION = 44;
+
+    // Ad Headline.
+    SWIPEABLE_GALLERY_AD_HEADLINE = 45;
+
+    // Swipes.
+    SWIPEABLE_GALLERY_AD_SWIPES = 46;
+
+    // See More.
+    SWIPEABLE_GALLERY_AD_SEE_MORE = 47;
+
+    // Sitelink 1.
+    SWIPEABLE_GALLERY_AD_SITELINK_ONE = 48;
+
+    // Sitelink 2.
+    SWIPEABLE_GALLERY_AD_SITELINK_TWO = 49;
+
+    // Sitelink 3.
+    SWIPEABLE_GALLERY_AD_SITELINK_THREE = 50;
+
+    // Sitelink 4.
+    SWIPEABLE_GALLERY_AD_SITELINK_FOUR = 51;
+
+    // Sitelink 5.
+    SWIPEABLE_GALLERY_AD_SITELINK_FIVE = 52;
+
+    // Hotel price.
+    HOTEL_PRICE = 53;
+
+    // Price Extension.
+    PRICE_EXTENSION = 54;
+
+    // Book on Google hotel room selection.
+    HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION = 55;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/content_label_type.proto

@@ -0,0 +1,90 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "ContentLabelTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing content label types.
+
+// Container for enum describing content label types in ContentLabel.
+message ContentLabelTypeEnum {
+  // Enum listing the content label types supported by ContentLabel criterion.
+  enum ContentLabelType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Sexually suggestive content.
+    SEXUALLY_SUGGESTIVE = 2;
+
+    // Below the fold placement.
+    BELOW_THE_FOLD = 3;
+
+    // Parked domain.
+    PARKED_DOMAIN = 4;
+
+    // Game.
+    GAME = 5;
+
+    // Juvenile, gross & bizarre content.
+    JUVENILE = 6;
+
+    // Profanity & rough language.
+    PROFANITY = 7;
+
+    // Death & tragedy.
+    TRAGEDY = 8;
+
+    // Video.
+    VIDEO = 9;
+
+    // Content rating: G.
+    VIDEO_RATING_DV_G = 10;
+
+    // Content rating: PG.
+    VIDEO_RATING_DV_PG = 11;
+
+    // Content rating: T.
+    VIDEO_RATING_DV_T = 12;
+
+    // Content rating: MA.
+    VIDEO_RATING_DV_MA = 13;
+
+    // Content rating: not yet rated.
+    VIDEO_NOT_YET_RATED = 14;
+
+    // Embedded video.
+    EMBEDDED_VIDEO = 15;
+
+    // Live streaming video.
+    LIVE_STREAMING_VIDEO = 16;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/conversion_action_category.proto

@@ -0,0 +1,62 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "ConversionActionCategoryProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Container for enum describing the category of conversions that are associated
+// with a ConversionAction.
+message ConversionActionCategoryEnum {
+  // The category of conversions that are associated with a ConversionAction.
+  enum ConversionActionCategory {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Default category.
+    DEFAULT = 2;
+
+    // User visiting a page.
+    PAGE_VIEW = 3;
+
+    // Purchase, sales, or "order placed" event.
+    PURCHASE = 4;
+
+    // Signup user action.
+    SIGNUP = 5;
+
+    // Lead-generating action.
+    LEAD = 6;
+
+    // Software download action (as for an app).
+    DOWNLOAD = 7;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/conversion_action_counting_type.proto

@@ -0,0 +1,53 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "ConversionActionCountingTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing conversion action counting type.
+
+// Container for enum describing the conversion deduplication mode for
+// conversion optimizer.
+message ConversionActionCountingTypeEnum {
+  // Indicates how conversions for this action will be counted. For more
+  // information, see https://support.google.com/google-ads/answer/3438531.
+  enum ConversionActionCountingType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Count only one conversion per click.
+    ONE_PER_CLICK = 2;
+
+    // Count all conversions per click.
+    MANY_PER_CLICK = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/conversion_action_status.proto

@@ -0,0 +1,55 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "ConversionActionStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing conversion action status.
+
+// Container for enum describing possible statuses of a conversion action.
+message ConversionActionStatusEnum {
+  // Possible statuses of a conversion action.
+  enum ConversionActionStatus {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Conversions will be recorded.
+    ENABLED = 2;
+
+    // Conversions will not be recorded.
+    REMOVED = 3;
+
+    // Conversions will not be recorded and the conversion action will not
+    // appear in the UI.
+    HIDDEN = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/conversion_action_type.proto

@@ -0,0 +1,74 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "ConversionActionTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing conversion action type.
+
+// Container for enum describing possible types of a conversion action.
+message ConversionActionTypeEnum {
+  // Possible types of a conversion action.
+  enum ConversionActionType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Conversions that occur when a user clicks on an ad's call extension.
+    AD_CALL = 2;
+
+    // Conversions that occur when a user on a mobile device clicks a phone
+    // number.
+    CLICK_TO_CALL = 3;
+
+    // Conversions that occur when a user downloads a mobile app from the Google
+    // Play Store.
+    GOOGLE_PLAY_DOWNLOAD = 4;
+
+    // Conversions that occur when a user makes a purchase in an app through
+    // Android billing.
+    GOOGLE_PLAY_IN_APP_PURCHASE = 5;
+
+    // Call conversions that are tracked by the advertiser and uploaded.
+    UPLOAD_CALLS = 6;
+
+    // Conversions that are tracked by the advertiser and uploaded with
+    // attributed clicks.
+    UPLOAD_CLICKS = 7;
+
+    // Conversions that occur on a webpage.
+    WEBPAGE = 8;
+
+    // Conversions that occur when a user calls a dynamically-generated phone
+    // number from an advertiser's website.
+    WEBSITE_CALL = 9;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/conversion_adjustment_type.proto

@@ -0,0 +1,53 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "ConversionAdjustmentTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing conversion adjustment type.
+
+// Container for enum describing conversion adjustment types.
+message ConversionAdjustmentTypeEnum {
+  // The different actions advertisers can take to adjust the conversions that
+  // they already reported. Retractions negate a conversion. Restatements change
+  // the value of a conversion.
+  enum ConversionAdjustmentType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Negates a conversion so that its total value and count are both zero.
+    RETRACTION = 2;
+
+    // Changes the value of a conversion.
+    RESTATEMENT = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/conversion_attribution_event_type.proto

@@ -0,0 +1,49 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "ConversionAttributionEventTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Container for enum indicating the event type the conversion is attributed to.
+message ConversionAttributionEventTypeEnum {
+  // The event type of conversions that are attributed to.
+  enum ConversionAttributionEventType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // The conversion is attributed to an impression.
+    IMPRESSION = 2;
+
+    // The conversion is attributed to an interaction.
+    INTERACTION = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/conversion_lag_bucket.proto

@@ -0,0 +1,118 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "ConversionLagBucketProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Container for enum representing the number of days between impression and
+// conversion.
+message ConversionLagBucketEnum {
+  // Enum representing the number of days between impression and conversion.
+  enum ConversionLagBucket {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Conversion lag bucket from 0 to 1 day. 0 day is included, 1 day is not.
+    LESS_THAN_ONE_DAY = 2;
+
+    // Conversion lag bucket from 1 to 2 days. 1 day is included, 2 days is not.
+    ONE_TO_TWO_DAYS = 3;
+
+    // Conversion lag bucket from 2 to 3 days. 2 days is included,
+    // 3 days is not.
+    TWO_TO_THREE_DAYS = 4;
+
+    // Conversion lag bucket from 3 to 4 days. 3 days is included,
+    // 4 days is not.
+    THREE_TO_FOUR_DAYS = 5;
+
+    // Conversion lag bucket from 4 to 5 days. 4 days is included,
+    // 5 days is not.
+    FOUR_TO_FIVE_DAYS = 6;
+
+    // Conversion lag bucket from 5 to 6 days. 5 days is included,
+    // 6 days is not.
+    FIVE_TO_SIX_DAYS = 7;
+
+    // Conversion lag bucket from 6 to 7 days. 6 days is included,
+    // 7 days is not.
+    SIX_TO_SEVEN_DAYS = 8;
+
+    // Conversion lag bucket from 7 to 8 days. 7 days is included,
+    // 8 days is not.
+    SEVEN_TO_EIGHT_DAYS = 9;
+
+    // Conversion lag bucket from 8 to 9 days. 8 days is included,
+    // 9 days is not.
+    EIGHT_TO_NINE_DAYS = 10;
+
+    // Conversion lag bucket from 9 to 10 days. 9 days is included,
+    // 10 days is not.
+    NINE_TO_TEN_DAYS = 11;
+
+    // Conversion lag bucket from 10 to 11 days. 10 days is included,
+    // 11 days is not.
+    TEN_TO_ELEVEN_DAYS = 12;
+
+    // Conversion lag bucket from 11 to 12 days. 11 days is included,
+    // 12 days is not.
+    ELEVEN_TO_TWELVE_DAYS = 13;
+
+    // Conversion lag bucket from 12 to 13 days. 12 days is included,
+    // 13 days is not.
+    TWELVE_TO_THIRTEEN_DAYS = 14;
+
+    // Conversion lag bucket from 13 to 14 days. 13 days is included,
+    // 14 days is not.
+    THIRTEEN_TO_FOURTEEN_DAYS = 15;
+
+    // Conversion lag bucket from 14 to 21 days. 14 days is included,
+    // 21 days is not.
+    FOURTEEN_TO_TWENTY_ONE_DAYS = 16;
+
+    // Conversion lag bucket from 21 to 30 days. 21 days is included,
+    // 30 days is not.
+    TWENTY_ONE_TO_THIRTY_DAYS = 17;
+
+    // Conversion lag bucket from 30 to 45 days. 30 days is included,
+    // 45 days is not.
+    THIRTY_TO_FORTY_FIVE_DAYS = 18;
+
+    // Conversion lag bucket from 45 to 60 days. 45 days is included,
+    // 60 days is not.
+    FORTY_FIVE_TO_SIXTY_DAYS = 19;
+
+    // Conversion lag bucket from 60 to 90 days. 60 days is included,
+    // 90 days is not.
+    SIXTY_TO_NINETY_DAYS = 20;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/conversion_or_adjustment_lag_bucket.proto

@@ -0,0 +1,207 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "ConversionOrAdjustmentLagBucketProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Container for enum representing the number of days between the impression and
+// the conversion or between the impression and adjustments to the conversion.
+message ConversionOrAdjustmentLagBucketEnum {
+  // Enum representing the number of days between the impression and the
+  // conversion or between the impression and adjustments to the conversion.
+  enum ConversionOrAdjustmentLagBucket {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Conversion lag bucket from 0 to 1 day. 0 day is included, 1 day is not.
+    CONVERSION_LESS_THAN_ONE_DAY = 2;
+
+    // Conversion lag bucket from 1 to 2 days. 1 day is included, 2 days is not.
+    CONVERSION_ONE_TO_TWO_DAYS = 3;
+
+    // Conversion lag bucket from 2 to 3 days. 2 days is included,
+    // 3 days is not.
+    CONVERSION_TWO_TO_THREE_DAYS = 4;
+
+    // Conversion lag bucket from 3 to 4 days. 3 days is included,
+    // 4 days is not.
+    CONVERSION_THREE_TO_FOUR_DAYS = 5;
+
+    // Conversion lag bucket from 4 to 5 days. 4 days is included,
+    // 5 days is not.
+    CONVERSION_FOUR_TO_FIVE_DAYS = 6;
+
+    // Conversion lag bucket from 5 to 6 days. 5 days is included,
+    // 6 days is not.
+    CONVERSION_FIVE_TO_SIX_DAYS = 7;
+
+    // Conversion lag bucket from 6 to 7 days. 6 days is included,
+    // 7 days is not.
+    CONVERSION_SIX_TO_SEVEN_DAYS = 8;
+
+    // Conversion lag bucket from 7 to 8 days. 7 days is included,
+    // 8 days is not.
+    CONVERSION_SEVEN_TO_EIGHT_DAYS = 9;
+
+    // Conversion lag bucket from 8 to 9 days. 8 days is included,
+    // 9 days is not.
+    CONVERSION_EIGHT_TO_NINE_DAYS = 10;
+
+    // Conversion lag bucket from 9 to 10 days. 9 days is included,
+    // 10 days is not.
+    CONVERSION_NINE_TO_TEN_DAYS = 11;
+
+    // Conversion lag bucket from 10 to 11 days. 10 days is included,
+    // 11 days is not.
+    CONVERSION_TEN_TO_ELEVEN_DAYS = 12;
+
+    // Conversion lag bucket from 11 to 12 days. 11 days is included,
+    // 12 days is not.
+    CONVERSION_ELEVEN_TO_TWELVE_DAYS = 13;
+
+    // Conversion lag bucket from 12 to 13 days. 12 days is included,
+    // 13 days is not.
+    CONVERSION_TWELVE_TO_THIRTEEN_DAYS = 14;
+
+    // Conversion lag bucket from 13 to 14 days. 13 days is included,
+    // 14 days is not.
+    CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS = 15;
+
+    // Conversion lag bucket from 14 to 21 days. 14 days is included,
+    // 21 days is not.
+    CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS = 16;
+
+    // Conversion lag bucket from 21 to 30 days. 21 days is included,
+    // 30 days is not.
+    CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS = 17;
+
+    // Conversion lag bucket from 30 to 45 days. 30 days is included,
+    // 45 days is not.
+    CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS = 18;
+
+    // Conversion lag bucket from 45 to 60 days. 45 days is included,
+    // 60 days is not.
+    CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS = 19;
+
+    // Conversion lag bucket from 60 to 90 days. 60 days is included,
+    // 90 days is not.
+    CONVERSION_SIXTY_TO_NINETY_DAYS = 20;
+
+    // Conversion adjustment lag bucket from 0 to 1 day. 0 day is included,
+    // 1 day is not.
+    ADJUSTMENT_LESS_THAN_ONE_DAY = 21;
+
+    // Conversion adjustment lag bucket from 1 to 2 days. 1 day is included,
+    // 2 days is not.
+    ADJUSTMENT_ONE_TO_TWO_DAYS = 22;
+
+    // Conversion adjustment lag bucket from 2 to 3 days. 2 days is included,
+    // 3 days is not.
+    ADJUSTMENT_TWO_TO_THREE_DAYS = 23;
+
+    // Conversion adjustment lag bucket from 3 to 4 days. 3 days is included,
+    // 4 days is not.
+    ADJUSTMENT_THREE_TO_FOUR_DAYS = 24;
+
+    // Conversion adjustment lag bucket from 4 to 5 days. 4 days is included,
+    // 5 days is not.
+    ADJUSTMENT_FOUR_TO_FIVE_DAYS = 25;
+
+    // Conversion adjustment lag bucket from 5 to 6 days. 5 days is included,
+    // 6 days is not.
+    ADJUSTMENT_FIVE_TO_SIX_DAYS = 26;
+
+    // Conversion adjustment lag bucket from 6 to 7 days. 6 days is included,
+    // 7 days is not.
+    ADJUSTMENT_SIX_TO_SEVEN_DAYS = 27;
+
+    // Conversion adjustment lag bucket from 7 to 8 days. 7 days is included,
+    // 8 days is not.
+    ADJUSTMENT_SEVEN_TO_EIGHT_DAYS = 28;
+
+    // Conversion adjustment lag bucket from 8 to 9 days. 8 days is included,
+    // 9 days is not.
+    ADJUSTMENT_EIGHT_TO_NINE_DAYS = 29;
+
+    // Conversion adjustment lag bucket from 9 to 10 days. 9 days is included,
+    // 10 days is not.
+    ADJUSTMENT_NINE_TO_TEN_DAYS = 30;
+
+    // Conversion adjustment lag bucket from 10 to 11 days. 10 days is included,
+    // 11 days is not.
+    ADJUSTMENT_TEN_TO_ELEVEN_DAYS = 31;
+
+    // Conversion adjustment lag bucket from 11 to 12 days. 11 days is included,
+    // 12 days is not.
+    ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS = 32;
+
+    // Conversion adjustment lag bucket from 12 to 13 days. 12 days is included,
+    // 13 days is not.
+    ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS = 33;
+
+    // Conversion adjustment lag bucket from 13 to 14 days. 13 days is included,
+    // 14 days is not.
+    ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS = 34;
+
+    // Conversion adjustment lag bucket from 14 to 21 days. 14 days is included,
+    // 21 days is not.
+    ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS = 35;
+
+    // Conversion adjustment lag bucket from 21 to 30 days. 21 days is included,
+    // 30 days is not.
+    ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS = 36;
+
+    // Conversion adjustment lag bucket from 30 to 45 days. 30 days is included,
+    // 45 days is not.
+    ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS = 37;
+
+    // Conversion adjustment lag bucket from 45 to 60 days. 45 days is included,
+    // 60 days is not.
+    ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS = 38;
+
+    // Conversion adjustment lag bucket from 60 to 90 days. 60 days is included,
+    // 90 days is not.
+    ADJUSTMENT_SIXTY_TO_NINETY_DAYS = 39;
+
+    // Conversion adjustment lag bucket from 90 to 145 days. 90 days is
+    // included, 145 days is not.
+    ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS = 40;
+
+    // Conversion lag bucket UNKNOWN. This is for dates before conversion lag
+    // bucket was available in Google Ads.
+    CONVERSION_UNKNOWN = 41;
+
+    // Conversion adjustment lag bucket UNKNOWN. This is for dates before
+    // conversion adjustment lag bucket was available in Google Ads.
+    ADJUSTMENT_UNKNOWN = 42;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/criterion_category_channel_availability_mode.proto

@@ -0,0 +1,59 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CriterionCategoryChannelAvailabilityModeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing the criterion category channel availability mode.
+
+// Describes channel availability mode for a criterion availability - whether
+// the availability is meant to include all advertising channels, or a
+// particular channel with all its channel subtypes, or a channel with a certain
+// subset of channel subtypes.
+message CriterionCategoryChannelAvailabilityModeEnum {
+  // Enum containing the possible CriterionCategoryChannelAvailabilityMode.
+  enum CriterionCategoryChannelAvailabilityMode {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // The category is available to campaigns of all channel types and subtypes.
+    ALL_CHANNELS = 2;
+
+    // The category is available to campaigns of a specific channel type,
+    // including all subtypes under it.
+    CHANNEL_TYPE_AND_ALL_SUBTYPES = 3;
+
+    // The category is available to campaigns of a specific channel type and
+    // subtype(s).
+    CHANNEL_TYPE_AND_SUBSET_SUBTYPES = 4;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/criterion_category_locale_availability_mode.proto

@@ -0,0 +1,62 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CriterionCategoryLocaleAvailabilityModeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing the criterion category locale availability mode.
+
+// Describes locale availabilty mode for a criterion availability - whether
+// it's available globally, or a particular country with all languages, or a
+// particular language with all countries, or a country-language pair.
+message CriterionCategoryLocaleAvailabilityModeEnum {
+  // Enum containing the possible CriterionCategoryLocaleAvailabilityMode.
+  enum CriterionCategoryLocaleAvailabilityMode {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // The category is available to campaigns of all locales.
+    ALL_LOCALES = 2;
+
+    // The category is available to campaigns within a list of countries,
+    // regardless of language.
+    COUNTRY_AND_ALL_LANGUAGES = 3;
+
+    // The category is available to campaigns within a list of languages,
+    // regardless of country.
+    LANGUAGE_AND_ALL_COUNTRIES = 4;
+
+    // The category is available to campaigns within a list of country, language
+    // pairs.
+    COUNTRY_AND_LANGUAGE = 5;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/criterion_system_serving_status.proto

@@ -0,0 +1,51 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CriterionSystemServingStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing approval status for the criterion.
+
+// Container for enum describing possible criterion system serving statuses.
+message CriterionSystemServingStatusEnum {
+  // Enumerates criterion system serving statuses.
+  enum CriterionSystemServingStatus {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // The value is unknown in this version.
+    UNKNOWN = 1;
+
+    // Eligible.
+    ELIGIBLE = 2;
+
+    // Low search volume.
+    RARELY_SERVED = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/criterion_type.proto

@@ -0,0 +1,135 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CriterionTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing criteria types.
+
+// The possible types of a criterion.
+message CriterionTypeEnum {
+  // Enum describing possible criterion types.
+  enum CriterionType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Keyword. e.g. 'mars cruise'.
+    KEYWORD = 2;
+
+    // Placement, aka Website. e.g. 'www.flowers4sale.com'
+    PLACEMENT = 3;
+
+    // Mobile application categories to target.
+    MOBILE_APP_CATEGORY = 4;
+
+    // Mobile applications to target.
+    MOBILE_APPLICATION = 5;
+
+    // Devices to target.
+    DEVICE = 6;
+
+    // Locations to target.
+    LOCATION = 7;
+
+    // Listing groups to target.
+    LISTING_GROUP = 8;
+
+    // Ad Schedule.
+    AD_SCHEDULE = 9;
+
+    // Age range.
+    AGE_RANGE = 10;
+
+    // Gender.
+    GENDER = 11;
+
+    // Income Range.
+    INCOME_RANGE = 12;
+
+    // Parental status.
+    PARENTAL_STATUS = 13;
+
+    // YouTube Video.
+    YOUTUBE_VIDEO = 14;
+
+    // YouTube Channel.
+    YOUTUBE_CHANNEL = 15;
+
+    // User list.
+    USER_LIST = 16;
+
+    // Proximity.
+    PROXIMITY = 17;
+
+    // A topic target on the display network (e.g. "Pets & Animals").
+    TOPIC = 18;
+
+    // Listing scope to target.
+    LISTING_SCOPE = 19;
+
+    // Language.
+    LANGUAGE = 20;
+
+    // IpBlock.
+    IP_BLOCK = 21;
+
+    // Content Label for category exclusion.
+    CONTENT_LABEL = 22;
+
+    // Carrier.
+    CARRIER = 23;
+
+    // A category the user is interested in.
+    USER_INTEREST = 24;
+
+    // Webpage criterion for dynamic search ads.
+    WEBPAGE = 25;
+
+    // Operating system version.
+    OPERATING_SYSTEM_VERSION = 26;
+
+    // App payment model.
+    APP_PAYMENT_MODEL = 27;
+
+    // Mobile device.
+    MOBILE_DEVICE = 28;
+
+    // Custom affinity.
+    CUSTOM_AFFINITY = 29;
+
+    // Custom intent.
+    CUSTOM_INTENT = 30;
+
+    // Location group.
+    LOCATION_GROUP = 31;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/custom_interest_member_type.proto

@@ -0,0 +1,51 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CustomInterestMemberTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing custom interest member type.
+
+// The types of custom interest member, either KEYWORD or URL.
+message CustomInterestMemberTypeEnum {
+  // Enum containing possible custom interest member types.
+  enum CustomInterestMemberType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Custom interest member type KEYWORD.
+    KEYWORD = 2;
+
+    // Custom interest member type URL.
+    URL = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/custom_interest_status.proto

@@ -0,0 +1,52 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CustomInterestStatusProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing custom interest status.
+
+// The status of custom interest.
+message CustomInterestStatusEnum {
+  // Enum containing possible custom interest types.
+  enum CustomInterestStatus {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Enabled status - custom interest is enabled and can be targeted to.
+    ENABLED = 2;
+
+    // Removed status - custom interest is removed and cannot be used for
+    // targeting.
+    REMOVED = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/custom_interest_type.proto

@@ -0,0 +1,51 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CustomInterestTypeProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing custom interest type.
+
+// The types of custom interest.
+message CustomInterestTypeEnum {
+  // Enum containing possible custom interest types.
+  enum CustomInterestType {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Allows brand advertisers to define custom affinity audience lists.
+    CUSTOM_AFFINITY = 2;
+
+    // Allows advertisers to define custom intent audience lists.
+    CUSTOM_INTENT = 3;
+  }
+
+
+}

third_party/google/ads/googleads/v1/enums/custom_placeholder_field.proto

@@ -0,0 +1,130 @@
+// 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.
+//
+
+syntax = "proto3";
+
+package google.ads.googleads.v1.enums;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V1.Enums";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/enums;enums";
+option java_multiple_files = true;
+option java_outer_classname = "CustomPlaceholderFieldProto";
+option java_package = "com.google.ads.googleads.v1.enums";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Enums";
+option ruby_package = "Google::Ads::GoogleAds::V1::Enums";
+
+// Proto file describing Custom placeholder fields.
+
+// Values for Custom placeholder fields.
+// For more information about dynamic remarketing feeds, see
+// https://support.google.com/google-ads/answer/6053288.
+message CustomPlaceholderFieldEnum {
+  // Possible values for Custom placeholder fields.
+  enum CustomPlaceholderField {
+    // Not specified.
+    UNSPECIFIED = 0;
+
+    // Used for return value only. Represents value unknown in this version.
+    UNKNOWN = 1;
+
+    // Data Type: STRING. Required. Combination ID and ID2 must be unique per
+    // offer.
+    ID = 2;
+
+    // Data Type: STRING. Combination ID and ID2 must be unique per offer.
+    ID2 = 3;
+
+    // Data Type: STRING. Required. Main headline with product name to be shown
+    // in dynamic ad.
+    ITEM_TITLE = 4;
+
+    // Data Type: STRING. Optional text to be shown in the image ad.
+    ITEM_SUBTITLE = 5;
+
+    // Data Type: STRING. Optional description of the product to be shown in the
+    // ad.
+    ITEM_DESCRIPTION = 6;
+
+    // Data Type: STRING. Full address of your offer or service, including
+    // postal code. This will be used to identify the closest product to the
+    // user when there are multiple offers in the feed that are relevant to the
+    // user.
+    ITEM_ADDRESS = 7;
+
+    // Data Type: STRING. Price to be shown in the ad.
+    // Example: "100.00 USD"
+    PRICE = 8;
+
+    // Data Type: STRING. Formatted price to be shown in the ad.
+    // Example: "Starting at $100.00 USD", "$80 - $100"
+    FORMATTED_PRICE = 9;
+
+    // Data Type: STRING. Sale price to be shown in the ad.
+    // Example: "80.00 USD"
+    SALE_PRICE = 10;
+
+    // Data Type: STRING. Formatted sale price to be shown in the ad.
+    // Example: "On sale for $80.00", "$60 - $80"
+    FORMATTED_SALE_PRICE = 11;
+
+    // Data Type: URL. Image to be displayed in the ad. Highly recommended for
+    // image ads.
+    IMAGE_URL = 12;
+
+    // Data Type: STRING. Used as a recommendation engine signal to serve items
+    // in the same category.
+    ITEM_CATEGORY = 13;
+
+    // Data Type: URL_LIST. Final URLs for the ad when using Upgraded
+    // URLs. User will be redirected to these URLs when they click on an ad, or
+    // when they click on a specific product for ads that have multiple
+    // products.
+    FINAL_URLS = 14;
+
+    // Data Type: URL_LIST. Final mobile URLs for the ad when using Upgraded
+    // URLs.
+    FINAL_MOBILE_URLS = 15;
+
+    // Data Type: URL. Tracking template for the ad when using Upgraded URLs.
+    TRACKING_URL = 16;
+
+    // Data Type: STRING_LIST. Keywords used for product retrieval.
+    CONTEXTUAL_KEYWORDS = 17;
+
+    // Data Type: STRING. Android app link. Must be formatted as:
+    // android-app://{package_id}/{scheme}/{host_path}.
+    // The components are defined as follows:
+    // package_id: app ID as specified in Google Play.
+    // scheme: the scheme to pass to the application. Can be HTTP, or a custom
+    //   scheme.
+    // host_path: identifies the specific content within your application.
+    ANDROID_APP_LINK = 18;
+
+    // Data Type: STRING_LIST. List of recommended IDs to show together with
+    // this item.
+    SIMILAR_IDS = 19;
+
+    // Data Type: STRING. iOS app link.
+    IOS_APP_LINK = 20;
+
+    // Data Type: INT64. iOS app store ID.
+    IOS_APP_STORE_ID = 21;
+  }
+
+
+}