Wednesday, July 18, 2012

Good news, Hangout Hackers!  hangoutiframer is now at v0.4.  Your app URLs will look like this:

https://hangoutiframer.appspot.com/forward/v0.4?u=https://[yourfile]

There are new features since v0.2: dynamic height and an additional scope argument.


Dynamic Height

You may have noticed that hangoutiframer apps get an iframe that's exactly 1000px high.  NO MORE!  Now it will size to the available space.

Try it out with this app URL in your API console:

https://hangoutiframer.appspot.com/forward/v0.4?u=https://wolffexperiments.appspot.com/static/app-that-resizes.html

Additional Scope Parameter

If you want another OAuth 2.0 scope for your Hangout App, you can request it in the API console.  After that, you need to tell hangoutiframer to request it for you, like so:

https://hangoutiframer.appspot.com/forward/v0.4?u=https://wolff.com/myapp.html&scope=https://www.googleapis.com/auth/myawesomescope

That will change the .xml hangoutiframer creates to include this additional scope.

(Note: If you need two or more additional scopes, you will need to cut'n'paste the output of hangoutiframer, edit to add all your scopes, and host it yourself.)


Deprecation notice

In 30 days, I will be deprecating the v0.0 version of hangoutiframer, which are URLs in this form:

https://hangoutiframer.appspot.com/forward/gadgetspec?u=[URL]

Please upgrade to v0.4 at your earliest convenience. Note that if you have not already, you will need to create an OAuth 2.0 client ID in your API Console.

Good luck!

Monday, July 2, 2012

Slight update to the OAuth 2.0 examples in hangout-experiments.

I added a new sample, minimalistAuth.xml that uses the Standalone Auth Client.  It loads slightly less JS on startup, but cannot make use of the full Google JS Client API.  Thus, the example only retrieves the access token and doesn't make any further calls.

This can be a little lighter-weight if you are only using your access token for verification---that is, you're using it to tell that the request came from a particular user, rather than using the token to retrieve new data.

I also took the liberty of updating the old experiments to use v1.1 of the hangouts.js library.