--- v15/resources/experiment.proto 2023-10-18 20:10:59.000000000 +0000 +++ v16/resources/experiment.proto 2024-02-20 20:02:50.000000000 +0000 @@ -1,110 +1,115 @@ // Copyright 2023 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.v15.resources; +package google.ads.googleads.v16.resources; -import "google/ads/googleads/v15/common/metric_goal.proto"; -import "google/ads/googleads/v15/enums/async_action_status.proto"; -import "google/ads/googleads/v15/enums/experiment_status.proto"; -import "google/ads/googleads/v15/enums/experiment_type.proto"; +import "google/ads/googleads/v16/common/metric_goal.proto"; +import "google/ads/googleads/v16/enums/async_action_status.proto"; +import "google/ads/googleads/v16/enums/experiment_status.proto"; +import "google/ads/googleads/v16/enums/experiment_type.proto"; import "google/api/field_behavior.proto"; import "google/api/resource.proto"; -option csharp_namespace = "Google.Ads.GoogleAds.V15.Resources"; -option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v15/resources;resources"; +option csharp_namespace = "Google.Ads.GoogleAds.V16.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v16/resources;resources"; option java_multiple_files = true; option java_outer_classname = "ExperimentProto"; -option java_package = "com.google.ads.googleads.v15.resources"; +option java_package = "com.google.ads.googleads.v16.resources"; option objc_class_prefix = "GAA"; -option php_namespace = "Google\\Ads\\GoogleAds\\V15\\Resources"; -option ruby_package = "Google::Ads::GoogleAds::V15::Resources"; +option php_namespace = "Google\\Ads\\GoogleAds\\V16\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V16::Resources"; // Proto file describing the Experiment resource. // A Google ads experiment for users to experiment changes on multiple // campaigns, compare the performance, and apply the effective changes. message Experiment { option (google.api.resource) = { type: "googleads.googleapis.com/Experiment" pattern: "customers/{customer_id}/experiments/{trial_id}" }; // Immutable. The resource name of the experiment. // Experiment resource names have the form: // // `customers/{customer_id}/experiments/{experiment_id}` string resource_name = 1 [ (google.api.field_behavior) = IMMUTABLE, (google.api.resource_reference) = { type: "googleads.googleapis.com/Experiment" } ]; // Output only. The ID of the experiment. Read only. optional int64 experiment_id = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; // Required. The name of the experiment. It must have a minimum length of 1 // and maximum length of 1024. It must be unique under a customer. string name = 10 [(google.api.field_behavior) = REQUIRED]; // The description of the experiment. It must have a minimum length of 1 and // maximum length of 2048. string description = 11; // For system managed experiments, the advertiser must provide a suffix during // construction, in the setup stage before moving to initiated. The suffix // will be appended to the in-design and experiment campaign names so that the // name is base campaign name + suffix. string suffix = 12; // Required. The product/feature that uses this experiment. - google.ads.googleads.v15.enums.ExperimentTypeEnum.ExperimentType type = 13 + google.ads.googleads.v16.enums.ExperimentTypeEnum.ExperimentType type = 13 [(google.api.field_behavior) = REQUIRED]; // The Advertiser-chosen status of this experiment. - google.ads.googleads.v15.enums.ExperimentStatusEnum.ExperimentStatus status = + google.ads.googleads.v16.enums.ExperimentStatusEnum.ExperimentStatus status = 14; // Date when the experiment starts. By default, the experiment starts // now or on the campaign's start date, whichever is later. If this field is // set, then the experiment starts at the beginning of the specified date in // the customer's time zone. // // Format: YYYY-MM-DD // Example: 2019-03-14 optional string start_date = 15; // Date when the experiment ends. By default, the experiment ends on // the campaign's end date. If this field is set, then the experiment ends at // the end of the specified date in the customer's time zone. // // Format: YYYY-MM-DD // Example: 2019-04-18 optional string end_date = 16; // The goals of this experiment. - repeated google.ads.googleads.v15.common.MetricGoal goals = 17; + repeated google.ads.googleads.v16.common.MetricGoal goals = 17; // Output only. The resource name of the long-running operation that can be // used to poll for completion of experiment schedule or promote. The most // recent long running operation is returned. optional string long_running_operation = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The status of the experiment promotion process. - google.ads.googleads.v15.enums.AsyncActionStatusEnum.AsyncActionStatus + google.ads.googleads.v16.enums.AsyncActionStatusEnum.AsyncActionStatus promote_status = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Set to true if changes to base campaigns should be synced to the + // trial campaigns. Any changes made directly to trial campaigns will be + // preserved. This field can only be set when the experiment is being created. + optional bool sync_enabled = 20 [(google.api.field_behavior) = IMMUTABLE]; }
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-02-20 UTC.