Identity API: Add token cache and identity.invalidateAuthToken.

chrome/common/extensions/api/experimental_identity.idl

Index: chrome/common/extensions/api/experimental_identity.idl
diff --git a/chrome/common/extensions/api/experimental_identity.idl b/chrome/common/extensions/api/experimental_identity.idl
index 625b0cd645cbaf60b738f585654bddb260579c52..d85987e1384eaf10b06a1db065d23c88b1eef95e 100644
--- a/chrome/common/extensions/api/experimental_identity.idl
+++ b/chrome/common/extensions/api/experimental_identity.idl
@@ -10,6 +10,11 @@ namespace experimental.identity {
     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;
@@ -31,6 +36,7 @@ namespace experimental.identity {
   };
 
   callback GetAuthTokenCallback = void (optional DOMString token);
+  callback InvalidateAuthTokenCallback = void ();
   callback LaunchWebAuthFlowCallback = void (optional DOMString responseUrl);
 
   interface Functions {
@@ -42,6 +48,13 @@ namespace experimental.identity {
     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.