Adding support for exclude locales to variations.

components/variations/proto/study.proto

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 syntax = "proto2";
 
 option optimize_for = LITE_RUNTIME;
 
 package variations;
 
@@ skipping 180 matching lines @@
   // Possible form factors Chrome is running on.
   enum FormFactor {
     DESKTOP = 0;
     PHONE   = 1;
     TABLET  = 2;
   }
 
   // Filtering criteria specifying whether this study is applicable to a given
   // Chrome instance.
   //
-  // Next tag: 12
+  // Next tag: 13
   message Filter {
     // The start date of the study in Unix time format. (Seconds since midnight
     // January 1, 1970 UTC). See: http://en.wikipedia.org/wiki/Unix_time
     // Ex: 1330893974  (corresponds to 2012-03-04 20:46:14Z)
     optional int64 start_date = 1;
 
     // The minimum Chrome version for this study, allowing a trailing '*'
     // character for pattern matching. Inclusive. (To check for a match, iterate
     // over each component checking >= until a * or end of string is reached.)
     // Optional - if not specified, there is no minimum version.
@@ skipping 11 matching lines @@
     // applies to all channels.
     // Ex: [BETA, STABLE]
     repeated Channel channel = 4;
 
     // List of platforms that will receive this study. If omitted, the study
     // applies to all platforms.
     // Ex: [PLATFORM_WINDOWS, PLATFORM_MAC]
     repeated Platform platform = 5;
 
     // List of locales that will receive this study. If omitted, the study
-    // applies to all locales.
+    // applies to all locales, unless |exclude_locale| is specified. Mutually
+    // exclusive with |exclude_locale|.
     // Ex: ["en-US", "en-CA"]
     repeated string locale = 6;
 
+    // List of locales that will be excluded from this study. If omitted, the
+    // study applies to all locales unless |locale| is specified. Mutually
+    // exclusive with |locale|.
+    // Ex: ["en-US", "en-CA"]
+    repeated string exclude_locale = 12;
+
     // List of form factors that will receive this study. If omitted, the study
     // applies to all form factors.
     // Ex: [PHONE, TABLET]
     repeated FormFactor form_factor = 7;
 
     // List of ChromeOS hardware classes that will receive this study. Each
     // entry is treated as a substring of the actual device hardware_class,
     // so "FOO" will match the client's hardware class "Device FOOBAR". If
     // omitted, the study applies to all hardware classes unless
     // |exclude_hardware_class| is specified. Mutually exclusive with
@@ skipping 11 matching lines @@
     repeated string exclude_hardware_class = 9;
 
     // List of lowercase ISO 3166-1 alpha-2 country codes that will receive this
     // study. If omitted, the study applies to all countries unless
     // |exclude_country| is specified. Mutually exclusive with
     // |exclude_country|.
     // Ex: ["in", "us"]
     repeated string country = 10;
 
     // List of lowercase ISO 3166-1 alpha-2 country codes that will be excluded
-    // in this study. If omitted, the study applies to all countries unless
+    // from this study. If omitted, the study applies to all countries unless
     // |country| is specified. Mutually exclusive with |country|.
     // Ex: ["in", "us"]
     repeated string exclude_country = 11;
   }
 
   // Filtering criteria for this study. A study that is filtered out for a given
   // client is equivalent to that study not being sent at all.
   optional Filter filter = 10;
 
   // Randomization seed to be used when |consistency| is set to PERMANENT. If
   // not specified, randomization will be done using the trial name.
   optional uint32 randomization_seed = 11;
 
   // Specifies whether the study starts as active initially, or whether it
   // requires the client to query its state before it is marked as active.
   enum ActivationType {
     // The study will be activated when its state is queried by the client.
     // This is recommended for most studies that include client code.
     ACTIVATION_EXPLICIT  = 0;
     // The study will be automatically activated when it is created. This
     // is recommended for studies that do not have any client logic.
     ACTIVATION_AUTO      = 1;
   }
 
   // Activation type for this study. Defaults to ACTIVATION_EXPLICIT if omitted.
   optional ActivationType activation_type = 12;
 }