gdata-jruby-client 0.7.0

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2009 Jerry Luk <jerryluk@gmail.com>
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,25 @@
+GData JRuby Client
+=====================
+The GData JRuby Client allows you to easily access data through Google Data APIs. It uses the GData Java Client Library from Google.
+
+See more at http://code.google.com/apis/gdata/docs/client-libraries.html
+The jar files are based on gdata-java-client v1.40.0
+
+GData JRuby Client is released under MIT License and GData Java Client Library is released under the Apache License 2.0.
+
+Running the test cases
+========================
+To run the test case, please create 'google_key.rb' and put it inside the 'spec' folder with something similar to the following:
+
+# Use OAuth
+CONSUMER_KEY = "yourdomain.com"
+CONSUMER_SECRET = "consumer_secret_from_google"
+TOKEN = "oauth_access_token"
+TOKEN_SECRET = "oauth_access_token_secret"
+
+# Use AuthSubToken
+SESSION_TOKEN = "auth_sub_token"
+
+Usage
+=======
+TBD

data/lib/base.rb

@@ -0,0 +1,16 @@
+Dir.glob("#{File.dirname(__FILE__)}/gdata/java/deps/*.jar").each do |j|
+  require j
+end
+
+Dir.glob("#{File.dirname(__FILE__)}/gdata/java/lib/*.jar").each do |j|
+  require j
+end
+
+module GData
+  include_package 'com.google.gdata.data'
+  include_package 'com.google.gdata.data.acl'
+  include_package 'com.google.gdata.data.batch'
+  include_package 'com.google.gdata.util'
+  include_package 'com.google.gdata.client'
+  include_package 'com.google.gdata.client.authn.oauth'
+end

data/lib/base_entry.rb

@@ -0,0 +1,20 @@
+class Java::ComGoogleGdataData::BaseEntry
+  include GoogleHelpers
+  
+  alias_method :orig_initialize, :initialize
+  
+  def initialize(options=nil)
+    if options.is_a? Hash
+      orig_initialize()
+      update_attributes(options)
+    elsif options.nil?
+      orig_initialize()
+    else
+      orig_initialize
+    end
+  end
+  
+  def id
+    get_id
+  end
+end

data/lib/calendar_event_entry.rb

@@ -0,0 +1,3 @@
+class Java::ComGoogleGdataDataCalendar::CalendarEventEntry
+  alias_method :extended_properties, :extended_property
+end

data/lib/calendar_service.rb

@@ -0,0 +1,19 @@
+module GData
+  include_package 'com.google.gdata.data.calendar'
+  include_package 'com.google.gdata.client.calendar'
+  include_package 'com.google.gdata.data.extensions'
+end
+
+class Java::ComGoogleGdataClientCalendar::CalendarService
+  ALL_CALENDAR_URL = 'http://www.google.com/calendar/feeds/default/allcalendars/full'
+  OWN_CALENDAR_URL = 'http://www.google.com/calendar/feeds/default/owncalendars/full'
+  DEFAULT_CALENDAR_URI = 'http://www.google.com/calendar/feeds/default/private/full'
+  
+  def find_feed(options)
+    super(options.merge({:class => GData::CalendarFeed}))
+  end
+  
+  def find_entry(options)
+    super(options.merge({:class => GData::CalendarEntry}))
+  end
+end

data/lib/contacts_service.rb

@@ -0,0 +1,17 @@
+module GData
+  include_package 'com.google.gdata.data.contacts'
+  include_package 'com.google.gdata.client.contacts'
+  include_package 'com.google.gdata.data.extensions'
+end
+
+class Java::ComGoogleGdataClientContacts::ContactsService
+  DEFAULT_CONTACTS_URI = 'http://www.google.com/m8/feeds/contacts/default/full'
+  
+  def find_feed(options)
+    super(options.merge({:class => GData::ContactFeed}))
+  end
+  
+  def find_entry(options)
+    super(options.merge({:class => GData::ContactEntry}))
+  end
+end

data/lib/email.rb

@@ -0,0 +1,16 @@
+class Java::ComGoogleGdataDataExtensions::Email
+  include GoogleHelpers
+  
+  alias_method :orig_initialize, :initialize
+  
+  def initialize(options=nil)
+    if options.is_a? Hash
+      orig_initialize()
+      update_attributes(options)
+    elsif options.nil?
+      orig_initialize()
+    else
+      orig_initialize
+    end
+  end
+end

data/lib/extended_property.rb

@@ -0,0 +1,14 @@
+class Java::ComGoogleGdataDataExtensions::ExtendedProperty
+  include GoogleHelpers
+  
+  alias_method :orig_initialize, :initialize
+  
+  def initialize(options=nil)
+    if options.is_a? Hash
+      orig_initialize()
+      update_attributes(options)
+    else
+      orig_initialize()
+    end
+  end
+end

data/lib/gdata/COPYING

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/lib/gdata/RELEASE_NOTES.txt

@@ -0,0 +1,448 @@
+Google Data API - Release Notes
+
+Notes for v1.40.0
+-----------------
+o  Added site usefulness element in Google Sidewiki Data API.  For additional
+   details see http://code.google.com/apis/sidewiki/changelog.html.
+
+Notes for v1.39.0
+-----------------
+o  Added support for Google Project Hosting Data API.
+
+Notes for v1.38.0
+-----------------
+Sep 24, 2009
+o  Added support for Google Sites Data API.
+
+Notes for v1.37.0
+-----------------
+Sep 23, 2009
+o  Added support for Google Sidewiki Data API
+   (http://code.google.com/apis/sidewiki).
+
+Notes for v1.36.0
+-----------------
+Aug 25, 2009
+o  Added support for version 3 of Documents List Data API.  This update
+   includes support for PDF uploads, folder sharing, domain and group
+   level ACLs, and document revision history.
+
+Notes for v1.35.1
+-----------------
+Aug 8, 2009
+o  Expanded Google Maps Data API sample code and minor bug fixes.
+
+Notes for v1.35.0
+-----------------
+Jul 22, 2009
+o  Updated Photos Data API to use Version 2 of Google Data Protocol.
+o  Removed com.google.gdata.util.common.annotations package in favor of
+   com.google.common.annotations available in google-collections library.
+o  Fixed bug java.lang.UnsupportedClassVersionError in version 1.34.
+
+Notes for v1.34.0
+-----------------
+Jun 24, 2009
+o  Updated YouTube API data model classes.
+o  Fixed encoding issue with atom content in a multipart/related body.
+
+Notes for v1.33.0
+-----------------
+Jun 8, 2009
+o  Update Google Contacts Data API to support version 3 of Contacts API.
+   Version 3.0 brings greatly expanded data schema, including support for
+   structured name and postal address.
+o  Added support for generic group attributes in Google Base Data API.
+o  Updated OAuth implementation to support changes related to OAuth 1.0a
+   specification.
+
+Notes for v1.32.1
+-----------------
+May 27, 2009
+o  Added support for Table and Record feeds in Google Spreadsheets Data API.
+
+Notes for v1.32.0
+-----------------
+May 20, 2009
+o  Added support for Google Maps Data API.
+
+Notes for v1.31.1
+-----------------
+Apr 22, 2009
+o  Fixed bug in com.google.gdata.util.net.UriEncoder which causes infinite
+   when run in JDK 1.5 in MacOS because of a JDK bug.
+
+Notes for v1.31.0
+-----------------
+Apr 21, 2009
+o  Added support for Analytics Google Data API.
+o  Updated Books API, Docs API and OAuth samples code.
+o  Updated Apps Groups API to use https instead of http.
+o  Fixed non-blocking bugs related to comptability with Google Java App Engine.
+
+Notes for v1.30.0
+-----------------
+Feb 11, 2009
+o  Updated ant build configuration to reduce build time by ~60%.  Thanks to
+   "mchenryc" for this contribution.  See
+   http://code.google.com/p/gdata-java-client/issues/detail?id=82 for details.
+o  Added support for ChannelFeed and UserEventFeed in YouTube Data API.
+o  Fixed batch support issue in YouTube Data API Feed classes.
+o  Fixed bug relaed to GoogleService#delete fails in case of redirection in
+   GData Protocol version 2. See
+   http://code.google.com/p/gdata-java-client/issues/detail?id=82 for details.
+
+Notes for v1.29.0
+-----------------
+Jan 9, 2009
+o  Added support for AppsForYourDomain Groups API.
+
+Notes for v1.28.0
+-----------------
+Dec 17, 2008
+o  Fixed bug in com.google.gdata.util.common.base.CharMatcher which shows up
+   only when executing in eclipse with JDK 1.5.
+
+Notes for v1.27.0
+-----------------
+Dec 10, 2008
+o  Updated Contacts, Webmaster Tools Google Data APIs to use Version 2 of
+   Google Data Protocol. With this
+   change all requests from the above mentioned APIs will send requests with
+   the "GData-Version" http header set to "2.0".  If you need to request older
+   versions of the feed, you can do so by calling "{Property}Service#setProtocolVersion".
+o  Contacts Version 2 API has few breaking changes.  For details refer to
+   Contacts API version 2 migration guide at
+   http://code.google.com/apis/contacts/docs/2.0/migration_guide.html
+o  Webmaster Tools Version 2 API does not contain any new features.  But it
+   inherits all of the GData Protocol Version 2 core capabilities including
+   Etags and user of new opensearch namespace.
+o  Added new data model classes for Attendee Feed and Access Control Entry in
+   Calendar Data API.
+
+Notes for v1.26.0
+-----------------
+Nov 20, 2008
+o  Fixed bug related to failure to load com.google.gdata.util.common.xml.XmlWriter
+   when executing in eclipse with JDK 1.5.
+
+Notes for v1.25.0
+-----------------
+Nov 13, 2008
+o  Updated Google Base, Blogger, Calendar, Code Search, Document List, Finance, Health
+   and Spreadsheet Data APIs to use version 2 of Google Data Protocol.  With this
+   change all requests from the above mentioned APIs will send requests with
+   the "GData-Version" http header set to "2.0".  If you need to request older
+   versions of the feed, you can do so by calling "{Property}Service#setProtocolVersion".
+o  The Version 2 protocol for above APIs does not contain any new features
+   specific to that API.  But they inherit all of the GData Protocol Version 2
+   core capabilities including Etags, use of new opensearch namespace.
+
+Notes for v1.24.0
+-----------------
+Oct 20, 2008
+o  Added support for version 2 of Google Data API.  API versioning is
+   rolled-out in phases and currently limited documentation about API
+   versioning is available at
+   http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#API_Versioning.
+   As of this release only YouTube Data API supports version 2.
+   Version 2 provides significant feature enhancements including:
+   1. Added Support for caching through http ETag headers.  The implementation is
+      compatible with specification in RFC 2616 with support for If-Match,
+      If-None-Match, If-Modified-Since headers.  Other conditional headers are
+      not supported.
+   2. Updated OpenSearch namespace from http://a9.com/-/spec/opensearchrss/1.0/
+      to http://a9.com/-/spec/opensearch/1.1/.
+   3. Introduced "GData-Version" header to indicate requested protocol
+      version.  The GData-Version header value is of format
+      "<major_version>.<minor_version>".  Possible values as of this release
+      are "1.0" and "2.0".  The version information can also be specified
+      using "v=2.0" query parameter.
+   All version 2 enabled Google Data API Services will continue to support
+   version 1 of the protocol.  If both "GData-Version" header and "v" query
+   parameter are not specified in the request, the server defaults to
+   version 1.0.
+o  Updated com.google.gdata.client.youtube.YouTubeService class to use
+   version 2 of the YouTube Data API as default version. Refer to YouTube API
+   developer guide at
+   http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html for
+   details on version 2 API.  Refer to YouTube Data API Migration Guide at
+   http://code.google.com/apis/youtube/2.0/migration.html for details on
+   breaking changes from version 1 to version 2, and details on how to migrate
+   your code to work with version 2 of the YouTube Data API.
+   NOTE: There are breaking API changes between version 1 and version 2.
+   Though it is not required to upgrade to version 2.0 immediately, it is
+   highly recommended to upgrade version 2.0.  Older versions of YouTube Data
+   API libraries will continue to work until version 1.0 is deprecated.
+
+Notes for v1.23.0
+-----------------
+Oct 2, 2008
+o  Added samples for Apps API interface to update gmail settings.
+
+Notes for v1.22.0
+-----------------
+Sep 22, 2008
+o  Added support for Book Search Data API.
+o  Data model updates for Blogger Data API, Youtube Data API.
+
+Notes for v1.21.0
+-----------------
+Sep 9, 2008
+o  Added support for OAuth authentication with options to sign requests
+   using RSA-SHA1 or HMAC-SHA1.  See OAuth sample included in this package
+   for usage details.
+o  Updated PicasaWeb Album API and YouTube API data model classes.
+o  Added Atom threading extensions (RFC 4685) support in Blogger API.
+o  Fixed a bug related to retries related to session expiry.
+o  Support for chunking related to media uploads for large video files.
+
+Notes for v1.20.0
+-----------------
+Jun 24, 2008
+o  Added support for Finance GData API.  For details refer to
+   http://code.google.com/apis/finance/.
+
+Notes for v1.19.0
+-----------------
+Jun 19, 2008
+o  Added support for Webmaster Tools API.  For details refer to
+   http://code.google.com/apis/webmastertools/.
+
+Notes for v1.18.0
+-----------------
+May 29, 2008
+o  Added support to handle GData Protocol Version 2.  This provides capability
+   for the APIs to be fully compliant with Atom Publishing Protocol
+   (http://bitworking.org/projects/atom/rfc5023.html).  This introduces a new
+   HTTP request header "GData-Version" which indicates whether a
+   request/response is v1 or v2.  Not all services are v2 compatible yet.
+   Only Blogger API is v2 compatible as of this release.  By default all requests
+   will use GData Protocol Version 1.
+o  Added support to handle ETags and if-match, if-none-match,
+   if-modified-since conditional headers as defined in
+   http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.19.  This is
+   applicable only for GData Protocol Version 2.
+o  Added several new features in Contacts API
+   o  Added support to group contacts.
+   o  Added support to access/update contact photos.
+   o  Added ability to append custom contact fields.
+   For details refer to http://code.google.com/apis/contacts/.
+
+Notes for v1.17.0
+-----------------
+May 20, 2008
+o  Added support for Google Health GData API.  This provides minimal interface
+   to interact with Google Health Service.  This API does not include data
+   model classes for CCR health records.
+o  Added new error types in Google Apps API.
+
+Notes for v1.16.4
+-----------------
+Apr 19, 2008
+o  Fixed compiled jars to be compatible with Java 5.
+
+Notes for v1.16.3
+-----------------
+Apr 03, 2008
+o  Added support to enable Authentication to Proxy Service for hosted
+   Google Apps.  See AuthSub for Web Application documentation for details
+   http://code.google.com/apis/accounts/docs/AuthForWebApps.html.
+o  Added support for RFC 822 text message encoding in Email Migration API.
+o  Fixed issue related to handling YouTube video entries with empty
+   description.
+
+Notes for v1.16.2
+-----------------
+Mar 12, 2008
+o  Added write support including video upload feature in YouTube API.
+
+Notes for v1.16.1
+-----------------
+Mar 11, 2008
+o  Fixed bug related to YouTube video feed parsing error.
+
+Notes for v1.16.0
+-----------------
+Mar 05, 2008
+o  Added Java client support for Google Contacts API.
+o  Samples are packaged separately from source code.  With this change, there
+   will be two packages, gdata-src.java.zip which contains the API source
+   and gdata-samples.java.zip which contains samples and precompiled lib.
+
+Notes for v1.15.2
+-----------------
+Dec 27, 2007
+o  Added support to upload image files using Document List Feed Data API.
+
+Notes for v1.15.1
+-----------------
+Dec 6, 2007
+o  Added support for media feed in Google Base data API.  With the media feed
+   support you can manage binary attachments to your Google Base items.  With
+   this change you will require Java Mail and Java Activation Framework to
+   use Google Base data API.
+
+Notes for v1.15.0
+-----------------
+Nov 15, 2007
+o  Added Java client support for Google Apps Email Migration API.
+o  Removed GData API documentation from the release package.  Online
+   documentation is available at http://code.google.com/apis/gdata.
+
+Notes for v1.14.1
+-----------------
+Oct 02, 2007
+o  Added batch support for Event Feed in Calendar Data API.
+o  Added batch support for Cells Feed in Spreadsheet Data API.
+o  Added support to handle foreign markup constraints as specified in RFC4287
+   sec 6.3 and AtomPub section 6.2.
+o  Lowered visibility of log messages reporting on unrecognized foreign markup
+   in xml feeds from INFO level to FINE level.
+
+Notes for v1.14.0
+-----------------
+Aug 28, 2007
+o  Added support for YouTube Data API.
+o  Refactored core GData code to remove dependency on
+   JavaMail, Java Activation Framework for non-media services.
+   With this change, only media dependent services such as,
+   Document List Data API, Picasa Web Album API and YouTube Data API require
+   JavaMail and Java Activation Framework.
+o  Simplified ant build configuration into multiple files.  This may require
+   updates to your IDE settings to point to new ant targets.  For the list of
+   available build targets refer to java/build.xml ant build file.
+
+Notes for v1.13.0
+-----------------
+July 30, 2007
+o  Added support for Google Documents List Data API.
+o  Added support for Calendar Gadgets in Calendar Data API.
+o  Added samples for interacting with read/write calendar feeds in
+   Calendar Data API
+o  Deprecated Geo format gd:geoPt from data model.
+
+Notes for v1.12.0
+-----------------
+June 21, 2007
+o  Added support for standard Geo formats including GeoRSS, W3C Semantic Web IG
+   and GML format.  The use of gd:geoPt is discouraged.
+o  Updated GData Java client library versioning to follow the standard format
+   "<major_release>.<minor_release>.<patch_release>". In this release the
+   version number changed from "1.0.11" to "1.12.0" to reflect the updated
+   versioning scheme.
+
+Notes for v1.0.11
+-----------------
+May 15, 2007
+o  Added event publisher mashup sample that demonstrates how to retrieve and
+   publish structured data from one google service to another google service.
+   This sample retrieves list of events stored in a Google Spreadsheet and
+   publish those events to Google Calendar and Google Base.
+
+Notes for v1.0.10
+-----------------
+May 1, 2007
+o  Added Java client support and extenstions for Google Calendar
+   access control lists (ACLs).
+o  Added Blogger GData API sample.
+o  Changed inheritance hierarchy for CalendarEventFeed.  As a side effect,
+   getEntries() method for Calendar event feed will return list of
+   objects of type CalendarEventEntry instead of EventEntry.
+o  Changed participant types for CalendarEventEntry.  As a side effect,
+   getParticipants() method for Calendar event entry will return list of
+   objects of type EventWho instead of Who.
+
+Notes for v1.0.9
+----------------
+March 21, 2007
+o  Added Java client support and extensions for GData Picasa Web Album API.
+o  Added Java client support and extensions for GData Apps For Your Domain API.
+o  Added "method" attribute to <gd:reminder>.  The "method" attribute can be
+   used to specify notification method for Calendar event related reminders.
+   The "method" value can be one of ALERT, EMAIL, SMS, ALL or NONE.
+o  Introduced dependency on Sun's JavaMail API.  To use client package,
+   download and install activation.jar, mail.jar libraries from Sun's JavaMail
+   API package version 1.4 or later.
+
+Notes for v1.0.8
+----------------
+February 22, 2007
+o  Added Java client support and extensions for GData Google Base API.
+o  Added Java client support and extensions for GData Notebook API.
+
+Notes for v1.0.7
+----------------
+February 06, 2007
+o  Added "return-empty" query parameter to the Spreadsheet Cells feed.
+   When present, empty cells are included in query results.
+o  Spreadsheets data API: Modified the Spreadsheet Cells feed to allow
+   Update (ie. HTTP PUT) on all cells, even empty ones, to change their
+   contents.  The use of INSERT on cells is deprecated.  DELETE is
+   synonymous with updating the gs:cell@inputValue to the empty string.
+o  Fixed the issue of Calendar API sending never-ending series
+   of sharding redirects.
+o  Modified default configuration of the METHOD_OVERRIDE_PROPERTY
+   system property to false.  The Update and Delete methods now use
+   HTTP PUT and DELETE, respectively.  To continue with old behavior:
+   Using Java command line argument:
+      -Dcom.google.gdata.UseMethodOverride=true
+   In client code:
+      System.setProperty(HttpGDataRequest.METHOD_OVERRIDE_PROPERTY, "true");
+
+Notes for v1.0.6
+----------------
+November 30, 2006
+o  Added Java client support and extensions for GData Spreadsheets
+   API.
+
+Notes for v1.0.5
+----------------
+October 05, 2006
+o  Added Java client support and extensions for GData CodeSearch
+   API.
+
+Notes for v1.0.4
+----------------
+September 27, 2006
+o  Support Calendar events with web content of different MIME
+   types.
+o  Support two new data model classes, ValueConstruct and
+   EnumConstruct in the Java client library.
+o  Change to introspection document collection representation
+   (Collection.java) in response to changes in APP draft-10. The
+   title information is no longer contained in an attribute of
+   <app:collection> but is instead a nested <atom:title> element.
+
+Notes for v1.0.3
+----------------
+August 29, 2006
+o  Added Batch support in GData library for the Google Base API.
+o  Added introspection support to the client library.  This
+   feature will be supported in the future.
+o  Added ability for calendar API to send notifications to users
+   when events are added.
+o  Added the 'web content' field to Calendar feeds which accepts
+   MIME types.
+o  Fixed 'pub:draft'.  It was a part of an incorrect namespace and
+   has been moved to the Atom Publishing Control namespace.
+
+Notes for v1.0.2
+----------------
+July 27, 2006
+o  Included the AuthSub utility classes
+o  Included samples for the Calendar client and AuthSub
+
+Notes for v1.0.1
+----------------
+April 28, 2006
+o  Introduce System property "com.google.gdata.UseMethodOverride"
+   to toggle method override functionality.  Currently defaults
+   to use the method override.  (The method override is used to
+   workaround proxies that do not handle the HTTP methods PUT and
+   DELETE properly)
+
+Notes for v1.0.0
+----------------
+April 19, 2006
+o  Initial release