Obfuscated Gaia ID fetcher

chrome/common/extensions/api/experimental_push_messaging.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.
 
 // File-level comment to appease parser. Eventually this will not be necessary.
 
 [nodoc] namespace experimental.pushMessaging{
   dictionary Message {
     // The subchannel the message was sent on.
     long subchannelId;
 
     // The payload associated with the message, if any.
     DOMString payload;
   };
 
+  dictionary ChannelIdResult {
+    // The subchannel the message was sent on.
+    long status;
+
+    // The payload associated with the message, if any.
+    DOMString channelId;
+  };
+
+  callback ChannelIdCallback = void (ChannelIdResult channelId);
+
+  interface Functions {
+    // Async calculate the channel ID for the app to give to its push server

[dcheng, 2012/08/20 19:10:01]

These comments will end up in the generated documentation. All extension
functions are, by definition, asynchronous. How about a comment like this
instead?
// Retrieves the channel ID associated with this extension. Typically, an
extension will want to send this value to its application server so the server
can use it to trigger push messages back to the extension.

I used "extension" instead of "app" here but I think that's OK, since it helps
disambiguate between "Chrome extension" and the "application server" (not sure
what a better term here would be).

[Pete Williamson, 2012/08/20 20:53:05]

Done.

+    // the callback function recieves the channel ID as a string
+    static void getChannelId(ChannelIdCallback callback);
+  };
+
   interface Events {
     // Fired when a push message has been received.
     // |message| : The details associated with the message.
     static void onMessage(Message message);
   };
 };