Add IDL and stub implementation for chrome.usersPrivate API.

chrome/common/extensions/api/users_private.idl

Index: chrome/common/extensions/api/users_private.idl
diff --git a/chrome/common/extensions/api/users_private.idl b/chrome/common/extensions/api/users_private.idl
new file mode 100644
index 0000000000000000000000000000000000000000..c0bde777e723664694cd8e1272d5687f94cd380e
--- /dev/null
+++ b/chrome/common/extensions/api/users_private.idl
@@ -0,0 +1,45 @@
+// 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.usersPrivate</code> API to manage users.
+namespace usersPrivate {
+
+  dictionary User {
+    // Email for the user.
+    DOMString email;
+
+    // Whether this user is the owner. Only specified if the current user (i.e.
+    // the one performing the method call to get users) is the owner.
+    boolean? isOwner;

[Ken Rockot(use gerrit already), 2015/06/01 19:14:45]

nit: IMHO it's kind of weird to have a field that is either true or undefined.
Consider making this a required field.

[Oren Blasberg, 2015/06/01 19:17:32]

Done.

+  };
+
+  callback UsersCallback = void (User[] users);
+  callback UserAddedCallback = void (boolean success);
+  callback UserRemovedCallback = void (boolean success);
+  callback IsOwnerCallback = void (boolean isOwner);
+  callback ManagedCallback = void (boolean managed);
+
+  interface Functions {
+    // Gets a list of the currently whitelisted users.
+    static void getWhitelistedUsers(UsersCallback callback);
+
+    // Adds a new user with the given email to the whitelist.
+    // The callback is called with true if the user was added succesfully, or
+    // with false if not (e.g. because the user was already present, or the
+    // current user isn't the owner).
+    static void addWhitelistedUser(DOMString email, UserAddedCallback callback);
+
+    // Removes the user with the given email from the whitelist.
+    // The callback is called with true if the user was removed succesfully, or
+    // with false if not (e.g. because the user was not already present, or
+    // the current user isn't the owner).
+    static void removeWhitelistedUser(DOMString email, UserRemovedCallback callback);
+
+    // Whether the current user is the owner of the device.
+    static void isCurrentUserOwner(IsOwnerCallback callback);
+
+    // Whether the whitelist is managed by enterprise.
+    static void isWhitelistManaged(ManagedCallback callback);
+  };
+};