G Suite Developers Blog: 12/1/10

Integrating your Rails application with Google Apps and the Apps Marketplace

December 21, 2010

Editor’s note: Vincent Van Gemert is a software engineer at Floorplanner, an online floor planning application which launched in June on the Google Apps Marketplace.launching it1. The initial setupSign In<?xml version="1.0" encoding="UTF-8" ?>
<ApplicationManifest xmlns="http://schemas.google.com/ApplicationManifest/2009">

<Name>[ApplicationName]</Name>
<Description>[Description]</Description>


<Support>

<Link rel="setup" href="[ApplicationSetupUrl]?domain=${DOMAIN_NAME}" />


<Link rel="manage" href="[ApplicationAdminUrl]?domain=${DOMAIN_NAME}" />


<Link rel="support" href="[ApplicationHelpUrl]" />


<Link rel="deletion-policy" href="[ApplicationPolicyUrl]" />
</Support>


<Extension id="navLink" type="link">
<Name>[ApplicationName]</Name>
<Url>[ApplicationLoginUrl]?domain=${DOMAIN_NAME}</Url>

<Scope ref="contactFeed"/>
<Scope ref="spreadsheetFeed"/>
<Scope ref="doclistFeed"/>
</Extension>


<Extension id="realm" type="openIdRealm">
<Url>[ApplicationRealm]</Url>
</Extension>

<Scope id="doclistFeed">
<Url>https://docs.google.com/feeds/</Url>
<Reason>[Reason]</Reason>
</Scope>

<Scope id="contactFeed">
<Url>https://www.google.com/m8/feeds/</Url>
<Reason>[Reason]</Reason>
</Scope>

</ApplicationManifest>setup page2. Rails libraries and OpenID

OAuth Gem

Ruby-openid

Rack-openid

Ruby-openid-apps-discovery

properly configured realmdef login

# The domain needs to be set. For example with params[:domain]
authenticate_with_open_id(params[:domain]),
{ :required => ["http://axschema.org/contact/email"], :return_to => '/login'}) do |result, identity_url, registration|

if result.successful?
# Succesfully logged in, retrieve email address
email = get_email(registration)
else
# Failed to login
end
end

end

def get_email(registration)

ax_response = OpenID::AX::FetchResponse.from_success_response(
request.env[Rack::OpenID::RESPONSE])
ax_response.data["http://axschema.org/contact/email"].first

endCreating a Listing3. Using the Google Data APIsgranted the appropriate permissionsCONSUMER_KEY = "Your-consumer-key"
CONSUMER_SECRET = "Your-consumer-secret"

def get_contacts

# Retrieve contacts
email = "user@email.com"
url = "https://www.google.com/m8/feeds/contacts/default/full?xoauth_requestor_id=#{email}"
contacts = gdata_request(url, :get)

end

def gdata_request(url, method, headers = {}, data = "")

uri = URI.parse(url)

# Setting up two-legged-oauth
consumer = OAuth::Consumer.new(CONSUMER_KEY, CONSUMER_SECRET)
oauth_params = {:consumer => consumer, :method => method, :request_uri => uri.to_s}

# Set Net:HTTP connection
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = (uri.port == 443)

if method == :post
req = Net::HTTP::Post.new(uri.request_uri)
req.body = data
else
req = Net::HTTP::Get.new(uri.request_uri)
end

# Set authorization header
oauth_helper = OAuth::Client::Helper.new(req, oauth_params)
req.initialize_http_header(headers.merge({'Authorization' => oauth_helper.header}))

# Execute request
response = http.request(req)
response.body

endOAuth PlaygroundGoogle Docs documentationdef submit_csv_to_gdocs

email = 'user@email.com'
url = 'https://docs.google.com/feeds/default/private/full?xoauth_requestor_id=#{email}'

# Create new CSV
csv = StringIO.new

CSV::Writer.generate(csv, ',') do |line|
line << ["Example 1", "Example 2"]
end

csv.rewind

# Send request
gdata_request(url, :post,
{ 'Content-Type' => 'text/csv',
'Slug' => 'test.csv',
'GData-Version' => '3.0' },
csv.read)

endGoogle Apps Marketplace Developer overviewOAuth Playground

Set the signature method to HMAC-SHA1

Type in your consumer key and consumer secret (these can be found in your Vendor Profile)

Set your Feed URL (step 6)

Set GData-version to 3.0 unless the API only supports 2.0

Click execute

Google Data APIs Ruby Utility LibraryWant to weigh in on this topic? Discuss on Buzz

Preview the New Marketplace Billing APIs

December 14, 2010

billing APIsGoogle Apps MarketplaceSlideRocketGQueuesCohumanWikiFYDAPI documentationpayment policyFAQGoogle Apps Marketplace Developer Community groupPosted by Rui Jiang, Google Apps Marketplace TeamWant to weigh in on this topic? Discuss on Buzz

New version of .Net Gdata client library

December 2, 2010

We just released version 1.7 of the .NET GData client library which adds support for two extensions of the Google Apps Provisioning API: Organization Units and Multiple Domains. It also adds a default retry count for failed HTTP requests and fixes a set of issues, including one on the implementation of the ResumableUploader component introduced in the previous version.For the complete list of changes, check the Release Notes: http://google-gdata.googlecode.com/svn/trunk/clients/cs/RELEASE_NOTES.HTMLThe new version of the .NET GData client library can be downloaded from http://code.google.com/p/google-gdata/downloads/list and, as usual, you are invited to report issues of file feature requests at http://code.google.com/p/google-gdata/issues/list.Posted by Claudio Cherubino, Developer Relations TeamWant to weigh in on this topic? Discuss on Buzz

Expanding the Google Apps Reporting API for resellers

December 1, 2010

Google Enterprise BlogGoogle Apps Reporting API

Accounts – Contains a list of the customer’s end-user accounts on a particular day.

Activity – Identifies the number of customer end-user accounts as well as the number of active and idle accounts over several different time periods.

Disk Space – Shows the amount of disk space used by a customer’s mailboxes.

Email Clients – Identifies how the customer’s end-users access their accounts on a day-by-day basis.

Summary – Contains the customer’s total number of accounts, total mailbox storage usage and total mailbox quota.

over 2,000 and growinglearn more and get startedWant to weigh in on this topic? Discuss on Buzz