Adding support for authenticated copresence calls

chrome/common/extensions/api/copresence.idl

 // 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.
 
 // Use the <code>chrome.copresence</code> API to communicate with other nearby
 // devices using Google's copresence service.
 namespace copresence {
   // Suggestions to copresence on how to do the publication and subscription.
   // Note: These are only suggestions. Actual behavior may not always match
   // what is requested.
@@ skipping 104 matching lines @@
 
   // Callback to return the status of a completed batchExecute() call.
   callback ExecuteCallback = void(ExecuteStatus status);
 
   interface Functions {
     // Sets the API key to use with the app. This parameter only needs to be
     // set to communicate with apps on other platforms. Once the API key is set,
     // apps on any platform that are using this API key can publish/subscribe to
     // each other.
     [nodoc] static void setApiKey(DOMString apiKey);
+
+    // Temporary call to enable authenticated copresence
+    // with an externally provided OAuth token.
+    // TODO(ckehoe): Replace this with a proper API.
+    [nodoc] static void setAuthToken(DOMString token);
     
     // Executes a set of copresence operations in one batch. They will either
     // all be executed, or none will be executed (due to an error in one or
     // more of them). Publish/Subscribe operations are executed in the order
     // that they exist in the array. Unpublish and Unsubscribe are processsed
     // at the end, again, in the order that they exist in the array.
     static void execute(Operation[] operations, ExecuteCallback callback);
   };
 
   interface Events {
     // Fired when new messages arrive.
     static void onMessagesReceived(DOMString subscriptionId,
                                    Message[] messages);
                                    
     // Fired when a new copresence status update is available.
     static void onStatusUpdated(Status status);
   };
 };