IT Lesson

Nearly 3 months ago we announced a preview of the Google Apps Marketplace billing feature. Based on feedback we’ve received over this time from trusted testers and other early adopters, we are closing the preview for new developers and will launch a significant update later this year.

For the next version, we’re working on making the billing features both easier to integrate with and easier for customers to use. Additional changes will enable us to innovate faster with expanded country support, payment options, and other exciting features due later on. Version 2 of the licensing API will continue to be supported throughout these changes.

Developers using the preview implementation can continue to do so until the new version is available and customers are transitioned. Those just getting started with the Marketplace are encouraged to use their own payment solution until the new version is available.

Please let us know if you have any questions by posting in the Google Apps Marketplace API forum.

Posted by Steven Bazyl, Google Apps Marketplace Team

Sometimes you’re only interested in specific elements from a Google Data API feed. With most APIs, you typically have to retrieve the entire feed and parse out the individual required elements. This can be very expensive for some applications-- especially mobile apps with limited bandwidth.

We recently launched the partial response and update feature for the Google Calendar Data API. Partial response and update allows you to request and update feeds containing only the elements that you’re interested in.

To request a partial response, you’ll need to add the fields query parameter to the end of the feed URL.

Request:

GET http://www.google.com/calendar/feeds/example@google.com/private/full?fields=entry(title,gd:when)

Response:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:gd="http://schemas.google.com/g/2005">
 <entry>
   <title type="text">Example meeting</title>
   <gd:when endTime="2010-03-25T09:00:00.000-07:00" startTime="2010-03-25T08:00:00.000-07:00">
     <gd:reminder method="alert" minutes="10"/>
     <gd:reminder method="sms" minutes="10"/>
   </gd:when>
 </entry>
 ... more entries ...
</feed>

To partially update a feed, you simply need to modify the partial request with your updates and submit it back to the server using HTTP PATCH. The HTTP PATCH method prompts for the requested changes to be applied to the resource defined by the request URL. To remove elements, partial updates can use the gd:field attributes, which specifies elements to remove before merging with the target source. The example below updates the event title and time.

Request:

PATCH http://www.google.com/calendar/feeds/default/private/full/eventID HTTP/1.1
Content-Type: application/xml
Host: www.google.com
GData-Version: 2
If-Match "FE8LQQJJeSp7IWA6WhVa"

<?xml version="1.0" encoding="UTF-8"?>
<entry>
 <title type="text">Example meeting update</title>
 <gd:when endTime="2010-03-27T10:00:00.000-07:00" startTime="2010-03-27T09:00:00.000-07:00">
   <gd:reminder method="alert" minutes="10"/>
   <gd:reminder method="sms" minutes="10"/>   
 </gd:when>
</entry>

As you can see, the ability to partially request and update feeds greatly reduces the amount of data transferred, which is especially important in the mobile world.

For documentation on Google Calendar partial response and update, please refer to our Developer’s Guide.

We’ve also launched partial response and update for the YouTube Data API and Picasa Web Albums Data API and partial retrieval for the read-only Sidewiki Data API. For full details, please refer to our post on the Google Code Blog.

Posted by Peng Ying, Google Calendar API Team