Added a ForceYouTubeRestrict policy and deprecated the old ForceYouTubeSafetyMode policy

chrome/browser/net/safe_search_util.h

 // Copyright 2014 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.
 
 #ifndef CHROME_BROWSER_NET_SAFE_SEARCH_UTIL_H_
 #define CHROME_BROWSER_NET_SAFE_SEARCH_UTIL_H_
 
 class GURL;
 
 namespace net {
 class HttpRequestHeaders;
 class URLRequest;
 }
 
 namespace safe_search_util {
 
+// Values for YouTube Restricted Mode.
+// VALUES MUST COINCIDE WITH ForceYouTubeRestrict POLICY.
+enum YouTubeRestrictMode {

[Marc Treib, 2016/09/05 09:58:10]

optional: enum class, with values OFF, MODERATE, STRICT?
(In particular, "YouTubeRestrictMode.OFF" is IMO much clearer than
"YOUTUBE_OFF".)

[ljusten (tachyonic), 2016/09/05 15:24:32]

I like that. It also adds type-safety as it requires explicit casts to int in a
couple of places, e.g. when passing the enum into the constructor of
FundamentalValue.

+  YOUTUBE_OFF = 0,      // Do not restrict YouTube content. YouTube might still
+                        // restrict content based on its user settings.
+  YOUTUBE_MODERATE = 1, // Enforce at least a moderately strict content filter
+                        // for YouTube.
+  YOUTUBE_STRICT = 2,   // Enforce a strict content filter for YouTube.
+};
+
 // If |request| is a request to Google Web Search, enforces that the SafeSearch
 // query parameters are set to active. Sets |new_url| to a copy of the request
 // url in which the query part contains the new values of the parameters.
 void ForceGoogleSafeSearch(const net::URLRequest* request, GURL* new_url);
 
-// If |request| is a request to YouTube, enforces YouTube's Safety Mode by
-// setting YouTube's Safety Mode header.
-void ForceYouTubeSafetyMode(const net::URLRequest* request,
-                            net::HttpRequestHeaders* headers);
+// Does nothing if |request| is not a request to YouTube. Otherwise, if |mode|
+// is not |YOUTUBE_OFF|, enforces a minimum YouTube Restrict mode by setting
+// YouTube Restrict header. Setting |YOUTUBE_OFF| removes a Restrict header
+// if it exists.
+void ForceYouTubeRestrict(const net::URLRequest* request,
+                          net::HttpRequestHeaders* headers,
+                          YouTubeRestrictMode mode);
 
 int GetForceGoogleSafeSearchCountForTesting();
-int GetForceYouTubeSafetyModeCountForTesting();
+int GetForceYouTubeRestrictCountForTesting();
 void ClearForceGoogleSafeSearchCountForTesting();
-void ClearForceYouTubeSafetyModeCountForTesting();
+void ClearForceYouTubeRestrictCountForTesting();
 
 }  // namespace safe_search_util
 
 #endif  // CHROME_BROWSER_NET_SAFE_SEARCH_UTIL_H_