add third_party proto

pull/133/head
Tony 6 years ago
parent 5094137516
commit 7d2d851720
  1. 7
      third_party/CHANGELOG.md
  2. 5
      third_party/OWNERS
  3. 15
      third_party/github.com/gogo/protobuf/AUTHORS
  4. 23
      third_party/github.com/gogo/protobuf/CONTRIBUTORS
  5. 35
      third_party/github.com/gogo/protobuf/LICENSE
  6. 144
      third_party/github.com/gogo/protobuf/gogoproto/gogo.proto
  7. 21
      third_party/google/ads/googleads/README.md
  8. 276
      third_party/google/ads/googleads/base.yaml
  9. 63
      third_party/google/ads/googleads/v1/common/ad_asset.proto
  10. 571
      third_party/google/ads/googleads/v1/common/ad_type_infos.proto
  11. 82
      third_party/google/ads/googleads/v1/common/asset_types.proto
  12. 232
      third_party/google/ads/googleads/v1/common/bidding.proto
  13. 50
      third_party/google/ads/googleads/v1/common/click_location.proto
  14. 594
      third_party/google/ads/googleads/v1/common/criteria.proto
  15. 84
      third_party/google/ads/googleads/v1/common/criterion_category_availability.proto
  16. 42
      third_party/google/ads/googleads/v1/common/custom_parameter.proto
  17. 41
      third_party/google/ads/googleads/v1/common/dates.proto
  18. 40
      third_party/google/ads/googleads/v1/common/explorer_auto_optimizer_setting.proto
  19. 344
      third_party/google/ads/googleads/v1/common/extensions.proto
  20. 41
      third_party/google/ads/googleads/v1/common/feed_common.proto
  21. 48
      third_party/google/ads/googleads/v1/common/final_app_url.proto
  22. 63
      third_party/google/ads/googleads/v1/common/frequency_cap.proto
  23. 42
      third_party/google/ads/googleads/v1/common/keyword_plan_common.proto
  24. 128
      third_party/google/ads/googleads/v1/common/matching_function.proto
  25. 527
      third_party/google/ads/googleads/v1/common/metrics.proto
  26. 217
      third_party/google/ads/googleads/v1/common/policy.proto
  27. 39
      third_party/google/ads/googleads/v1/common/real_time_bidding_setting.proto
  28. 294
      third_party/google/ads/googleads/v1/common/segments.proto
  29. 124
      third_party/google/ads/googleads/v1/common/simulation.proto
  30. 52
      third_party/google/ads/googleads/v1/common/tag_snippet.proto
  31. 57
      third_party/google/ads/googleads/v1/common/targeting_setting.proto
  32. 42
      third_party/google/ads/googleads/v1/common/text_label.proto
  33. 47
      third_party/google/ads/googleads/v1/common/url_collection.proto
  34. 293
      third_party/google/ads/googleads/v1/common/user_lists.proto
  35. 52
      third_party/google/ads/googleads/v1/common/value.proto
  36. 58
      third_party/google/ads/googleads/v1/enums/access_reason.proto
  37. 64
      third_party/google/ads/googleads/v1/enums/account_budget_proposal_status.proto
  38. 57
      third_party/google/ads/googleads/v1/enums/account_budget_proposal_type.proto
  39. 54
      third_party/google/ads/googleads/v1/enums/account_budget_status.proto
  40. 57
      third_party/google/ads/googleads/v1/enums/ad_customizer_placeholder_field.proto
  41. 54
      third_party/google/ads/googleads/v1/enums/ad_group_ad_rotation_mode.proto
  42. 56
      third_party/google/ads/googleads/v1/enums/ad_group_ad_status.proto
  43. 57
      third_party/google/ads/googleads/v1/enums/ad_group_criterion_approval_status.proto
  44. 56
      third_party/google/ads/googleads/v1/enums/ad_group_criterion_status.proto
  45. 56
      third_party/google/ads/googleads/v1/enums/ad_group_status.proto
  46. 82
      third_party/google/ads/googleads/v1/enums/ad_group_type.proto
  47. 63
      third_party/google/ads/googleads/v1/enums/ad_network_type.proto
  48. 65
      third_party/google/ads/googleads/v1/enums/ad_serving_optimization_status.proto
  49. 63
      third_party/google/ads/googleads/v1/enums/ad_strength.proto
  50. 102
      third_party/google/ads/googleads/v1/enums/ad_type.proto
  51. 85
      third_party/google/ads/googleads/v1/enums/advertising_channel_sub_type.proto
  52. 65
      third_party/google/ads/googleads/v1/enums/advertising_channel_type.proto
  53. 49
      third_party/google/ads/googleads/v1/enums/affiliate_location_feed_relationship_type.proto
  54. 78
      third_party/google/ads/googleads/v1/enums/affiliate_location_placeholder_field.proto
  55. 66
      third_party/google/ads/googleads/v1/enums/age_range_type.proto
  56. 51
      third_party/google/ads/googleads/v1/enums/app_campaign_app_store.proto
  57. 65
      third_party/google/ads/googleads/v1/enums/app_campaign_bidding_strategy_goal_type.proto
  58. 48
      third_party/google/ads/googleads/v1/enums/app_payment_model_type.proto
  59. 76
      third_party/google/ads/googleads/v1/enums/app_placeholder_field.proto
  60. 51
      third_party/google/ads/googleads/v1/enums/app_store.proto
  61. 51
      third_party/google/ads/googleads/v1/enums/app_url_operating_system_type.proto
  62. 57
      third_party/google/ads/googleads/v1/enums/asset_type.proto
  63. 73
      third_party/google/ads/googleads/v1/enums/attribution_model.proto
  64. 52
      third_party/google/ads/googleads/v1/enums/bid_modifier_source.proto
  65. 56
      third_party/google/ads/googleads/v1/enums/bidding_source.proto
  66. 53
      third_party/google/ads/googleads/v1/enums/bidding_strategy_status.proto
  67. 105
      third_party/google/ads/googleads/v1/enums/bidding_strategy_type.proto
  68. 59
      third_party/google/ads/googleads/v1/enums/billing_setup_status.proto
  69. 74
      third_party/google/ads/googleads/v1/enums/brand_safety_suitability.proto
  70. 54
      third_party/google/ads/googleads/v1/enums/budget_delivery_method.proto
  71. 54
      third_party/google/ads/googleads/v1/enums/budget_period.proto
  72. 51
      third_party/google/ads/googleads/v1/enums/budget_status.proto
  73. 67
      third_party/google/ads/googleads/v1/enums/budget_type.proto
  74. 57
      third_party/google/ads/googleads/v1/enums/call_conversion_reporting_state.proto
  75. 67
      third_party/google/ads/googleads/v1/enums/call_placeholder_field.proto
  76. 48
      third_party/google/ads/googleads/v1/enums/callout_placeholder_field.proto
  77. 60
      third_party/google/ads/googleads/v1/enums/campaign_experiment_type.proto
  78. 62
      third_party/google/ads/googleads/v1/enums/campaign_serving_status.proto
  79. 51
      third_party/google/ads/googleads/v1/enums/campaign_shared_set_status.proto
  80. 54
      third_party/google/ads/googleads/v1/enums/campaign_status.proto
  81. 55
      third_party/google/ads/googleads/v1/enums/change_status_operation.proto
  82. 77
      third_party/google/ads/googleads/v1/enums/change_status_resource_type.proto
  83. 201
      third_party/google/ads/googleads/v1/enums/click_type.proto
  84. 90
      third_party/google/ads/googleads/v1/enums/content_label_type.proto
  85. 62
      third_party/google/ads/googleads/v1/enums/conversion_action_category.proto
  86. 53
      third_party/google/ads/googleads/v1/enums/conversion_action_counting_type.proto
  87. 55
      third_party/google/ads/googleads/v1/enums/conversion_action_status.proto
  88. 74
      third_party/google/ads/googleads/v1/enums/conversion_action_type.proto
  89. 53
      third_party/google/ads/googleads/v1/enums/conversion_adjustment_type.proto
  90. 49
      third_party/google/ads/googleads/v1/enums/conversion_attribution_event_type.proto
  91. 118
      third_party/google/ads/googleads/v1/enums/conversion_lag_bucket.proto
  92. 207
      third_party/google/ads/googleads/v1/enums/conversion_or_adjustment_lag_bucket.proto
  93. 59
      third_party/google/ads/googleads/v1/enums/criterion_category_channel_availability_mode.proto
  94. 62
      third_party/google/ads/googleads/v1/enums/criterion_category_locale_availability_mode.proto
  95. 51
      third_party/google/ads/googleads/v1/enums/criterion_system_serving_status.proto
  96. 135
      third_party/google/ads/googleads/v1/enums/criterion_type.proto
  97. 51
      third_party/google/ads/googleads/v1/enums/custom_interest_member_type.proto
  98. 52
      third_party/google/ads/googleads/v1/enums/custom_interest_status.proto
  99. 51
      third_party/google/ads/googleads/v1/enums/custom_interest_type.proto
  100. 130
      third_party/google/ads/googleads/v1/enums/custom_placeholder_field.proto
  101. Some files were not shown because too many files have changed in this diff Show More

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

@ -0,0 +1,5 @@
# See the OWNERS docs at https://go.k8s.io/owners
approvers:
- haoguanwei
- maojian

@ -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>

@ -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>

@ -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.

@ -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;
}

@ -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.

@ -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

@ -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;
}

@ -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;
}
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}
}

@ -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 doesnt 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 stores 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;
}

@ -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;
}
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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 Googles top properties including Search, YouTube,
// and the Google Display Network.
APP_CAMPAIGN_FOR_ENGAGEMENT = 13;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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 havent 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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

@ -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;
}
}

Some files were not shown because too many files have changed in this diff Show More

Loading…
Cancel
Save