Add chrome.searchEnginesPrivate API and Search Settings page.

chrome/common/extensions/api/search_engines_private.idl

Index: chrome/common/extensions/api/search_engines_private.idl
diff --git a/chrome/common/extensions/api/search_engines_private.idl b/chrome/common/extensions/api/search_engines_private.idl
new file mode 100644
index 0000000000000000000000000000000000000000..90819f7a88b15a15c1326178276b9880ac72d5f9
--- /dev/null
+++ b/chrome/common/extensions/api/search_engines_private.idl
@@ -0,0 +1,36 @@
+// Copyright 2015 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.
+
+// Use the <code>chrome.searchEnginesPrivate</code> API to get or set
+// preferences from the settings UI.
+namespace searchEnginesPrivate {
+
+  dictionary SearchEngine {
+    // The unique ID of the engine in the list.
+    DOMString guid;
+
+    // The name of the engine.
+    DOMString name;
+
+    // Whether the engine is the selected a.k.a. "default" search engine.
+    boolean isSelected;

[not at google - send to devlin, 2015/04/23 19:42:35]

consider making this optional, you might as well, it's hardly ever going to be
set and no point sending down a whole bunch of "isSelected:false" all the time.

[Oren Blasberg, 2015/04/23 20:48:34]

Done.

+  };
+
+  callback SearchEnginesCallback = void (SearchEngine[] engines);
+
+  interface Functions {
+    // Gets a list of the "default” search engines.
+    // Exactly one of the values should have default == true.
+    static void getDefaultSearchEngines(SearchEnginesCallback callback);
+
+    // Sets the search engine with the given GUID as the selected default.
+    static void setSelectedSearchEngine(DOMString guid);
+  };
+
+  interface Events {
+    // Fires when the list of default search engines changes or
+    // when the user selects a preferred default search engine.
+    static void onDefaultSearchEnginesChanged(SearchEngine[] engines);
+  };
+};