Gmail

From OpenSocial

1 Summary
2 Container-specific Tips

Summary

Gmail is a new kind of webmail, built on the idea that email can be more intuitive, efficient, and useful. And maybe even fun. After all, Gmail has:

Less spam - Keep unwanted messages out of your inbox with Google's innovative technology.
Mobile access - Read Gmail on your mobile phone by pointing your phone's web browser to http://gmail.com/app.
Lots of space - Over 7297.030426 megabytes (and counting) of free storage so you'll never need to delete another message.

Name	Gmail
Status	Live as a Gmail Labs feature
Main Site	http://www.gmail.com
Developer Site	http://mail.google.com/mail/#settings/labs
Documentation Site	http://wiki.opensocial.org/index.php?title=Gmail
Discussion Group	http://groups.google.com/group/opensocial-api
Developer Blog	http://gmailblog.blogspot.com
JavaScript API Support	v0.8
Server to Server Support	None
API Extensions	None
Compliance Test Results	http://opensocial-compliance.appspot.com/#gmail.com

Back to Containers page

Container-specific Tips

Submission

Gmail does not have an application gallery, so there is no submission process. To install an app on Gmail follow these steps:

Go to the 'Labs' tab under Gmail Settings.
Enable the 'Add any gadget by URL' experiment and click 'Save Changes.'
Now you'll have a 'Gadgets' tab under Settings.
Enter the URL of an OpenSocial gadget spec and click 'Add'.

Views

Gmail supports a leftnav and canvas view. You can specify the leftnav view using <Content type="html" view="nav">. If you don't specify a 'nav' view, Gmail will use the default view for the leftnav.

In order to use requestNavigateTo to reach the canvas view, you must also include <Optional feature="maximize"> in your ModulePrefs. This is only temporary.

Gmail's lefnav view defaults to 160x150 pixels. The height can be expanded by calling gadgets.window.adjustHeight.

Gmail's canvas view defaults to 582x150 pixels, but the width will expand to fill the page. The height can be expanded by calling gadgets.window.adjustHeight.

Implementation Differences

Gadgets in Gmail return information from your Google public profile when you request data for the owner or viewer.

Gmail does not support the requestSendMessage, requestCreateActivity, and requestShareApp methods.

Gadget specs are cached for one hour and there is currently no mechanism to bypass this cache. We know this makes developing your gadgets tedious, so we're looking at ways to address the issue.