--- v17/resources/conversion_value_rule.proto 2024-06-05 23:17:09.000000000 +0000
+++ v18/resources/conversion_value_rule.proto 2024-10-16 17:56:30.000000000 +0000
@@ -1,140 +1,199 @@
// Copyright 2024 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.v17.resources;
+package google.ads.googleads.v18.resources;
-import "google/ads/googleads/v17/enums/conversion_value_rule_status.proto";
-import "google/ads/googleads/v17/enums/value_rule_device_type.proto";
-import "google/ads/googleads/v17/enums/value_rule_geo_location_match_type.proto";
-import "google/ads/googleads/v17/enums/value_rule_operation.proto";
+import "google/ads/googleads/v18/enums/conversion_value_rule_status.proto";
+import "google/ads/googleads/v18/enums/value_rule_device_type.proto";
+import "google/ads/googleads/v18/enums/value_rule_geo_location_match_type.proto";
+import "google/ads/googleads/v18/enums/value_rule_operation.proto";
import "google/api/field_behavior.proto";
import "google/api/resource.proto";
-option csharp_namespace = "Google.Ads.GoogleAds.V17.Resources";
-option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v17/resources;resources";
+option csharp_namespace = "Google.Ads.GoogleAds.V18.Resources";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v18/resources;resources";
option java_multiple_files = true;
option java_outer_classname = "ConversionValueRuleProto";
-option java_package = "com.google.ads.googleads.v17.resources";
+option java_package = "com.google.ads.googleads.v18.resources";
option objc_class_prefix = "GAA";
-option php_namespace = "Google\\Ads\\GoogleAds\\V17\\Resources";
-option ruby_package = "Google::Ads::GoogleAds::V17::Resources";
+option php_namespace = "Google\\Ads\\GoogleAds\\V18\\Resources";
+option ruby_package = "Google::Ads::GoogleAds::V18::Resources";
// Proto file describing the Conversion Value Rule resource.
// A conversion value rule
message ConversionValueRule {
option (google.api.resource) = {
type: "googleads.googleapis.com/ConversionValueRule"
pattern: "customers/{customer_id}/conversionValueRules/{conversion_value_rule_id}"
};
// Action applied when rule is applied.
message ValueRuleAction {
// Specifies applied operation.
- google.ads.googleads.v17.enums.ValueRuleOperationEnum.ValueRuleOperation
+ google.ads.googleads.v18.enums.ValueRuleOperationEnum.ValueRuleOperation
operation = 1;
// Specifies applied value.
double value = 2;
}
// Condition on Geo dimension.
message ValueRuleGeoLocationCondition {
// Geo locations that advertisers want to exclude.
repeated string excluded_geo_target_constants = 1
[(google.api.resource_reference) = {
type: "googleads.googleapis.com/GeoTargetConstant"
}];
// Excluded Geo location match type.
- google.ads.googleads.v17.enums.ValueRuleGeoLocationMatchTypeEnum
+ google.ads.googleads.v18.enums.ValueRuleGeoLocationMatchTypeEnum
.ValueRuleGeoLocationMatchType excluded_geo_match_type = 2;
// Geo locations that advertisers want to include.
repeated string geo_target_constants = 3
[(google.api.resource_reference) = {
type: "googleads.googleapis.com/GeoTargetConstant"
}];
// Included Geo location match type.
- google.ads.googleads.v17.enums.ValueRuleGeoLocationMatchTypeEnum
+ google.ads.googleads.v18.enums.ValueRuleGeoLocationMatchTypeEnum
.ValueRuleGeoLocationMatchType geo_match_type = 4;
}
// Condition on Device dimension.
message ValueRuleDeviceCondition {
// Value for device type condition.
- repeated google.ads.googleads.v17.enums.ValueRuleDeviceTypeEnum
+ repeated google.ads.googleads.v18.enums.ValueRuleDeviceTypeEnum
.ValueRuleDeviceType device_types = 1;
}
// Condition on Audience dimension.
message ValueRuleAudienceCondition {
// User Lists.
repeated string user_lists = 1 [(google.api.resource_reference) = {
type: "googleads.googleapis.com/UserList"
}];
// User Interests.
repeated string user_interests = 2 [(google.api.resource_reference) = {
type: "googleads.googleapis.com/UserInterest"
}];
}
+ // Condition on Itinerary dimension.
+ message ValueRuleItineraryCondition {
+ // Range for the number of days between the date of the booking and the
+ // start of the itinerary.
+ ValueRuleItineraryAdvanceBookingWindow advance_booking_window = 1;
+
+ // Range for the itinerary length in number of nights.
+ ValueRuleItineraryTravelLength travel_length = 2;
+
+ // The days of the week on which this itinerary's travel can start.
+ ValueRuleItineraryTravelStartDay travel_start_day = 3;
+ }
+
+ // Range for the number of days between the date of the booking and the
+ // start of the itinerary.
+ message ValueRuleItineraryAdvanceBookingWindow {
+ // Minimum number of days between the date of the booking the start date.
+ int32 min_days = 1;
+
+ // Maximum number of days between the date of the booking the start date.
+ int32 max_days = 2;
+ }
+
+ // Range for the itinerary length in number of nights.
+ message ValueRuleItineraryTravelLength {
+ // Minimum number of nights between the start date and the end date.
+ int32 min_nights = 1;
+
+ // Maximum number of days between the start date and the end date.
+ int32 max_nights = 2;
+ }
+
+ // The days of the week on which an itinerary's travel can start.
+ message ValueRuleItineraryTravelStartDay {
+ // The travel can start on Monday.
+ bool monday = 1;
+
+ // The travel can start on Tuesday.
+ bool tuesday = 2;
+
+ // The travel can start on Wednesday.
+ bool wednesday = 3;
+
+ // The travel can start on Thursday.
+ bool thursday = 4;
+
+ // The travel can start on Friday.
+ bool friday = 5;
+
+ // The travel can start on Saturday.
+ bool saturday = 6;
+
+ // The travel can start on Sunday.
+ bool sunday = 7;
+ }
+
// Immutable. The resource name of the conversion value rule.
// Conversion value rule resource names have the form:
//
// `customers/{customer_id}/conversionValueRules/{conversion_value_rule_id}`
string resource_name = 1 [
(google.api.field_behavior) = IMMUTABLE,
(google.api.resource_reference) = {
type: "googleads.googleapis.com/ConversionValueRule"
}
];
// Output only. The ID of the conversion value rule.
int64 id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
// Action applied when the rule is triggered.
ValueRuleAction action = 3;
// Condition for Geo location that must be satisfied for the value rule to
// apply.
ValueRuleGeoLocationCondition geo_location_condition = 4;
// Condition for device type that must be satisfied for the value rule to
// apply.
ValueRuleDeviceCondition device_condition = 5;
// Condition for audience that must be satisfied for the value rule to apply.
ValueRuleAudienceCondition audience_condition = 6;
+ // Condition for itinerary that must be satisfied for the value rule to apply.
+ ValueRuleItineraryCondition itinerary_condition = 9;
+
// Output only. The resource name of the conversion value rule's owner
// customer. When the value rule is inherited from a manager customer,
// owner_customer will be the resource name of the manager whereas the
// customer in the resource_name will be of the requesting serving customer.
// ** Read-only **
string owner_customer = 7 [
(google.api.field_behavior) = OUTPUT_ONLY,
(google.api.resource_reference) = {
type: "googleads.googleapis.com/Customer"
}
];
// The status of the conversion value rule.
- google.ads.googleads.v17.enums.ConversionValueRuleStatusEnum
+ google.ads.googleads.v18.enums.ConversionValueRuleStatusEnum
.ConversionValueRuleStatus status = 8;
}
