Obfuscated Gaia ID fetcher

chrome/common/extensions/api/experimental_push_messaging.idl

Index: chrome/common/extensions/api/experimental_push_messaging.idl
diff --git a/chrome/common/extensions/api/experimental_push_messaging.idl b/chrome/common/extensions/api/experimental_push_messaging.idl
index 1a27433dfbbc5d75b3cc838dc7f3fd98261b8d1c..75106b3bfffb42bf1a991ab9ce67c76533409d4d 100644
--- a/chrome/common/extensions/api/experimental_push_messaging.idl
+++ b/chrome/common/extensions/api/experimental_push_messaging.idl
@@ -13,6 +13,22 @@
     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.