ad_group_criterion_simulation.proto 4.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889
  1. // Copyright 2022 Google LLC
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. // http://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  14. syntax = "proto3";
  15. package google.ads.googleads.v12.resources;
  16. import "google/ads/googleads/v12/common/simulation.proto";
  17. import "google/ads/googleads/v12/enums/simulation_modification_method.proto";
  18. import "google/ads/googleads/v12/enums/simulation_type.proto";
  19. import "google/api/field_behavior.proto";
  20. import "google/api/resource.proto";
  21. option csharp_namespace = "Google.Ads.GoogleAds.V12.Resources";
  22. option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v12/resources;resources";
  23. option java_multiple_files = true;
  24. option java_outer_classname = "AdGroupCriterionSimulationProto";
  25. option java_package = "com.google.ads.googleads.v12.resources";
  26. option objc_class_prefix = "GAA";
  27. option php_namespace = "Google\\Ads\\GoogleAds\\V12\\Resources";
  28. option ruby_package = "Google::Ads::GoogleAds::V12::Resources";
  29. // Proto file describing the ad group criterion simulation resource.
  30. // An ad group criterion simulation. Supported combinations of advertising
  31. // channel type, criterion type, simulation type, and simulation modification
  32. // method are detailed below respectively. Hotel AdGroupCriterion simulation
  33. // operations starting in V5.
  34. //
  35. // 1. DISPLAY - KEYWORD - CPC_BID - UNIFORM
  36. // 2. SEARCH - KEYWORD - CPC_BID - UNIFORM
  37. // 3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM
  38. // 4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORM
  39. // 5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
  40. message AdGroupCriterionSimulation {
  41. option (google.api.resource) = {
  42. type: "googleads.googleapis.com/AdGroupCriterionSimulation"
  43. pattern: "customers/{customer_id}/adGroupCriterionSimulations/{ad_group_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}"
  44. };
  45. // Output only. The resource name of the ad group criterion simulation.
  46. // Ad group criterion simulation resource names have the form:
  47. //
  48. // `customers/{customer_id}/adGroupCriterionSimulations/{ad_group_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}`
  49. string resource_name = 1 [
  50. (google.api.field_behavior) = OUTPUT_ONLY,
  51. (google.api.resource_reference) = {
  52. type: "googleads.googleapis.com/AdGroupCriterionSimulation"
  53. }
  54. ];
  55. // Output only. AdGroup ID of the simulation.
  56. optional int64 ad_group_id = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
  57. // Output only. Criterion ID of the simulation.
  58. optional int64 criterion_id = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
  59. // Output only. The field that the simulation modifies.
  60. google.ads.googleads.v12.enums.SimulationTypeEnum.SimulationType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
  61. // Output only. How the simulation modifies the field.
  62. google.ads.googleads.v12.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
  63. // Output only. First day on which the simulation is based, in YYYY-MM-DD format.
  64. optional string start_date = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
  65. // Output only. Last day on which the simulation is based, in YYYY-MM-DD format.
  66. optional string end_date = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
  67. // List of simulation points.
  68. oneof point_list {
  69. // Output only. Simulation points if the simulation type is CPC_BID.
  70. google.ads.googleads.v12.common.CpcBidSimulationPointList cpc_bid_point_list = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
  71. // Output only. Simulation points if the simulation type is PERCENT_CPC_BID.
  72. google.ads.googleads.v12.common.PercentCpcBidSimulationPointList percent_cpc_bid_point_list = 13 [(google.api.field_behavior) = OUTPUT_ONLY];
  73. }
  74. }