Identity API: Add token cache and identity.invalidateAuthToken.

chrome/common/extensions/api/experimental_identity.idl

 // 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.
 
 namespace experimental.identity {

[Matt Perry, 2013/04/18 17:46:37]

I hadn't seen this before, but we're trying to kill off the experimental
namespace. https://code.google.com/p/chromium/issues/detail?id=232888

Instead, prefer to add an entry to _permission_features.json with a channel
restriction to "dev". You can also whitelist certain extension IDs to work on
the stable channel if you want.

[Michael Courage, 2013/04/18 19:52:24]

The release of the Identity API has been blocked on web-based dialogs (which
this CL is part of). I'm planning to wrap up this change and then release the
API in M28.

I filed a separate bug to explicitly track removal of the prefix.
https://code.google.com/p/chromium/issues/detail?id=233250
Sounds good?

 
   [inline_doc] dictionary TokenDetails {
     // Whether to prompt the user to log in or grant scope permissions (if they
     // have not already done so). Default is false.
     boolean? interactive;
   };
 
+  [inline_doc] dictionary InvalidTokenDetails {
+    // The specific token that should be removed from the cache.
+    DOMString token;
+  };
+
   [inline_doc] dictionary WebAuthFlowDetails {
     // The URL that initiates the auth flow.
     DOMString url;
 
     // Whether to launch auth flow in interactive mode. Default is false.
     boolean? interactive;
 
     // Width of the window, if one is shown in interactive mode.
     long? width;
 
     // Height of the window, if one is shown in interactive mode.
     long? height;
 
     // X coordinate of the window, if one is shown in interactive mode.
     long? left;
 
     // Y coordinate of the window, if one is shown in interactive mode.
     long? top;
   };
 
   callback GetAuthTokenCallback = void (optional DOMString token);
+  callback InvalidateAuthTokenCallback = void ();
   callback LaunchWebAuthFlowCallback = void (optional DOMString responseUrl);
 
   interface Functions {
     // Gets an OAuth2 access token as specified by the manifest.
     //
     // |details| : Token options.
     // |callback| : Called with an OAuth2 access token as specified by the
     // manifest, or undefined if there was an error.
     static void getAuthToken(optional TokenDetails details,
                              GetAuthTokenCallback callback);
 
+    // Removes an OAuth2 access token from the token cache.
+    //
+    // |details| : Token information.
+    // |callback| : Called when the token has been removed from the cache.
+    static void invalidateAuthToken(InvalidTokenDetails details,
+                                    InvalidateAuthTokenCallback callback);
+
     // Starts an auth flow at the specified URL.
     //
     // |details| : WebAuth flow options.
     // |callback| : Called with the URL redirected back to your application.
     static void launchWebAuthFlow(WebAuthFlowDetails details,
                                   LaunchWebAuthFlowCallback callback);
   };
 };