Added Google Contacts API

Author: vbarathan

INSTALL-samples.txt

@@ -0,0 +1,57 @@
+Installing GData Java Client API library
+========================================
+
+Table of Contents
+------------------
+  1. Package Contents
+  2. Requirements
+  3. Installation
+
+PACKAGE CONTENTS:
+-----------------
+Google Data APIs ("GData" for short) Java client provides source code and
+libraries for interacting with GData-enabled services.  This package includes
+  1. Precompile java libraries under "gdata/java/lib".
+  2. Third party dependencies under "gdata/java/third_party".
+  3. GData-enabled service specific samples under "gdata/java/sample".
+  4. Ant build configuration to run the sample code.
+  5. Javadoc for client source under "gdata/java/doc".
+
+REQUIREMENTS:
+-------------
+GData Java Client depends on following tools/platforms.
+1. Java Development Kit version 5.0 or greater.  Latest version of JDK
+   available for download from http://java.sun.com.
+2. Apache ANT version 1.7 or greater.  Apache's ANT binary is available for
+   download from http://ant.apache.org.
+
+Following third_party dependency libraries are required to compile/run the
+samples.
+1. mail.jar in Sun's JavaMail API (version 1.4 or greater).
+   Sun's JavaMail package available for download from
+   "http://java.sun.com/products/javamail/downloads/index.html". This is only
+   required for media specific APIs including Google Base data API,
+   Document List data API, Picasa Web Album API and YouTube data API.
+2. activation.jar in Sun's JavaBeans Activation Framewrok.
+   This is required only if using JDK version 1.5.
+   Sun's JavaBeansActivationFramework is available for download from
+   "http://java.sun.com/javase/technologies/desktop/javabeans/jaf/downloads/index.html".
+   This is only required for media specific APIs including
+   Google Base data API, Document List data API, Picasa Web Album API and
+   YouTube data API.
+3. servlet.jar in Sun's Servlet API (version 2.3 or greater).
+   This is required only if executing code samples in 'sample.authsub' or
+   'sample.gbase.recipe' packages.  Sun's Servlet API package can be
+   downloaded from "http://java.sun.com/products/servlet/download.html".
+Download above mentioned third_party jar files and save under
+"gdata/java/third_party".
+
+INSTALLATION:
+-------------
+1. Unpack gdata-samples.zip package to local folder.
+2. Edit "gdata/java/build-samples/build.properties" file to specify location
+   of required third_party jar files. Also specify applicable input data
+   for samples.
+3. To run a specific sample, execute the ant run target corresponding to the
+   sample.  For example to execute calendar sample, run command
+   "ant -f build-samples.xml sample.calendar.run" from folder "gdata/java".

INSTALL.txt INSTALL-src.txt

@@ -1,67 +1,54 @@
-Installing GData Java Client API library
-========================================
+Installing GData Java Client API Source
+=======================================
 
 Table of Contents
 ------------------
   1. Package Contents
   2. Requirements
   3. Installation
-  4. Executing Samples
 
 PACKAGE CONTENTS:
 -----------------
-Google Data APIs ("GData" for short) Java client provides source code and 
+Google Data APIs ("GData" for short) Java client provides source code and
 libraries for interacting with GData-enabled services.  This package includes
   1. GData Java client source under "gdata/java/src".
   2. GData Java client libraries under "gdata/java/lib".
-  3. Ant build configuration to compile the source code.
+  3. Ant build configuration to re-compile the source code.
   4. Javadoc for client source under "gdata/java/doc".
-  5. GData-enabled service specific samples under "gdata/java/sample".
 
 REQUIREMENTS:
 -------------
-GData Java Client depends on following external utilities/libraries on top of 
+GData Java Client depends on following external utilities/libraries on top of
 standard Java installation.
 1. Java Development Kit version 5.0 or greater.  Latest version of JDK
    available for download from http://java.sun.com.
 2. Apache ANT version 1.7 or greater.  Apache's ANT binary is available for
    download from http://ant.apache.org.
 3. mail.jar in Sun's JavaMail API (version 1.4 or greater).
-   Sun's JavaMail package available for download from 
+   Sun's JavaMail package available for download from
    "http://java.sun.com/products/javamail/downloads/index.html". This is only
-   required for media specific APIs including Google Base data API, 
+   required for media specific APIs including Google Base data API,
    Document List data API, Picasa Web Album API and YouTube data API.
 4. activation.jar in Sun's JavaBeans Activation Framewrok.
    This is required only if using JDK version 1.5.
-   Sun's JavaBeansActivationFramework is available for download from 
-   "http://java.sun.com/products/javabeans/jaf/downloads/index.html".  This is
-   only required for media specific APIs including Google Base data API, 
-   Document List data API, Picasa Web Album API and YouTube data API.
+   Sun's JavaBeansActivationFramework is available for download from
+   "http://java.sun.com/javase/technologies/desktop/javabeans/jaf/downloads/index.html".
+   This is only required for media specific APIs including
+   Google Base data API, Document List data API, Picasa Web Album API and
+   YouTube data API.
 5. servlet.jar in Sun's Servlet API (version 2.3 or greater).
    This is required only if executing code samples in 'sample.authsub' or
    'sample.gbase.recipe' packages.  Sun's Servlet API package can be
-   downloaded from "http://java.sun.com/products/servlet/download.html".  This
-   is only required for media specific APIs including Document List Data API,
-   Picasa Web Album API and YouTube Data API.
+   downloaded from "http://java.sun.com/products/servlet/download.html".
 
 INSTALLATION:
 -------------
 Update ant build configuration to point to right path for dependency jars.
-1. Unpack gdata.java.zip package to local folder.
-2. Edit the following lines in "gdata/java/build/build.properties" to point to 
-   correct path for dependency jar files
+1. Unpack gdata-src.zip package to local folder.
+2. Edit the following lines in "gdata/java/build-src/build.properties"
+   to point to correct path for dependency jar files
     activation.jar=<path to activation.jar file>
     mail.jar=<path to mail.jar file>
     servlet.jar=<path to servlet.jar file>
-    
-EXECUTING SAMPLES:
-------------------
-GData-enabled service specific samples can be executed through ant build 
-targets.
-1. Edit "gdata/java/build/build.properties" file to specify input data
-   for samples. This step is required only for samples that use user data
-   from build.properties file.
-2. To run a specific sample execute the ant run target corresponding to the 
-   sample.  For example to execute calendar sample, run command 
-   "ant sample.calendar.run" from folder "gdata/java".
-
+3. To recompile source files, execute the ant build target
+   "ant -f build-src.xml" from folder "gdata/java".

README-samples.txt

@@ -0,0 +1,40 @@
+Google data API - README for samples package
+Mar 05, 2008
+
+Overview
+========
+The Google data APIs ("GData" for short) provide a simple standard protocol for
+reading and writing data on the web. GData combines common XML-based
+syndication formats (Atom and RSS) with a feed-publishing system based on the
+Atom publishing protocol, plus some extensions for handling queries.
+
+Google also provides a set of client libraries for interacting with
+GData-enabled services, in a variety of programming languages. Using these
+libraries, you can construct GData requests, send them to a service, and
+receive responses.
+
+Several services currently support the GData API. A complete up-to-date list
+along with respective documentation can be found on the GData site at
+http://code.google.com/apis/gdata.
+
+
+Package information
+===================
+This package contains:
+ o  Code samples to interact with each of the Google Services using GData Java
+    API.
+ o  Precompiled libraries to access supported Google Services using GData API.
+ o  Javadoc for GData API.
+
+Refer to INSTALL-samples.txt for details on how to install and use this package.
+
+Related Resources:
+==================
+1. GData API documentation:
+    http://code.google.com/apis/gdata/
+2. First time users refer to getting started guide
+    http://code.google.com/support/bin/answer.py?answer=78455&topic=12022
+3. Using Proxy Servers with GData Java client library
+    http://code.google.com/support/bin/answer.py?answer=71349&topic=11369#java
+4. For questions/reporting bugs/feedback visit
+    http://groups.google.com/group/google-help-dataapi

README.txt README-src.txt

@@ -1,4 +1,4 @@
-Google data API - README.TXT
+Google data API - README for source package
 Mar 21, 2007
 
 Overview
@@ -21,22 +21,23 @@ http://code.google.com/apis/gdata
 Package information
 ===================
 The GData package contains:
- o  documentation for GData, the GData-enabled services, and the client
-    libraries
- o  the Java client library, its sources, and build files
+ o  Java source code to interact with GData enabled Google Services.
+ o  Javadoc for the GData Java API.
 
 The documentation can be found in the 'doc' folder.  The package contains just
 the 'java' library which can be found in the 'java' folder. Refer to
-INSTALL.txt for details on package dependencies and install instructions. 
-There are client libraries in various other languages including C#, PHP, 
+INSTALL-src.txt for details on package dependencies and install instructions.
+There are client libraries in various other languages including C#, PHP,
 JavaScript and more. Please see the GData web page for information on obtaining
-other client libraries:
-http://code.google.com/apis/gdata
-
-
-Known Issues
-============
-
-The Google data APIs and libraries are still in beta so please use one of
-the API support Google Groups to give us any feedback, issues or bugs:
-http://groups.google.com/group/google-help-dataapi
+other client libraries at http://code.google.com/apis/gdata.
+
+Related Resources:
+==================
+1. GData API documentation:
+    http://code.google.com/apis/gdata/
+2. First time users refer to getting started guide
+    http://code.google.com/support/bin/answer.py?answer=78455&topic=12022
+3. Using Proxy Servers with GData Java client library
+    http://code.google.com/support/bin/answer.py?answer=71349&topic=11369#java
+4. For questions/reporting bugs/feedback visit
+    http://groups.google.com/group/google-help-dataapi

RELEASE_NOTES.txt

@@ -1,10 +1,22 @@
 Google Data API - Release Notes
 
+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 
+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.
@@ -13,7 +25,7 @@ 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 
+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
@@ -30,10 +42,10 @@ 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 
+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

java/build.xml java/build-samples.xml

@@ -1,67 +1,40 @@
 <!--
 
-    Ant script to generate the GData java libraries and samples.
+    Ant script to generate the GData API samples.
     To build, run 'ant -f <path-to-this-file>'.
 
 -->
 
-<project name="GData" default="build" basedir=".">
+<project name="gdata-samples" default="build" basedir=".">
 
   <!-- Include core build script -->
-  <import file="build/core.xml"/>
+  <import file="build-samples/core.xml"/>
 
   <!-- Include property specific build scripts -->
-  <import file="build/appsforyourdomain.xml"/>
-  <import file="build/authsub.xml"/>
-  <import file="build/blogger.xml"/>
-  <import file="build/calendar.xml"/>
-  <import file="build/codesearch.xml"/>
-  <import file="build/docs.xml"/>
-  <import file="build/gbase.xml"/>
-  <import file="build/photos.xml"/>
-  <import file="build/spreadsheet.xml"/>
-  <import file="build/youtube.xml"/>
-          
-
-<!--  ===================================================================== -->
-<!--                      Build Library                                     -->
-<!--  ===================================================================== -->   
-  
-  <!-- Build core and service specific libraries -->
-  <target name="build">
-    <antcall target="core.build.core"/>
-    <antcall target="appsforyourdomain.build.appsforyourdomain"/>
-    <antcall target="calendar.build.calendar"/>
-    <antcall target="codesearch.build.codesearch"/>
-    <antcall target="docs.build.docs"/>
-    <antcall target="gbase.build.gbase"/>
-    <antcall target="photos.build.photos"/>
-    <antcall target="spreadsheet.build.spreadsheet"/>     
-    <antcall target="youtube.build.youtube"/>     
-  </target>
-
-  <target name="clean">
-    <antcall target="core.clean.core"/>
-    <antcall target="appsforyourdomain.clean.appsforyourdomain"/>
-    <antcall target="calendar.clean.calendar"/>
-    <antcall target="codesearch.clean.codesearch"/>
-    <antcall target="docs.clean.docs"/>
-    <antcall target="gbase.clean.gbase"/>
-    <antcall target="photos.clean.photos"/>
-    <antcall target="youtube.clean.youtube"/>
-  </target>
+  <import file="build-samples/appsforyourdomain.xml"/>
+  <import file="build-samples/authsub.xml"/>
+  <import file="build-samples/blogger.xml"/>
+  <import file="build-samples/calendar.xml"/>
+  <import file="build-samples/codesearch.xml"/>
+  <import file="build-samples/contacts.xml"/>
+  <import file="build-samples/docs.xml"/>
+  <import file="build-samples/gbase.xml"/>
+  <import file="build-samples/photos.xml"/>
+  <import file="build-samples/spreadsheet.xml"/>
+  <import file="build-samples/youtube.xml"/>
 
 
 <!--  ===================================================================== -->
 <!--                      Build samples                                     -->
 <!--  ===================================================================== -->
 
-  <target name="samples.build">
+  <target name="build">
     <antcall target="appsforyourdomain.sample.appsforyourdomain.build"/>
     <antcall target="authsub.sample.authsub.build"/>
     <antcall target="blogger.sample.blogger.build"/>
     <antcall target="calendar.sample.calendar.build"/>
     <antcall target="codesearch.sample.codesearch.build"/>
+    <antcall target="contacts.sample.contacts.build"/>
     <antcall target="core.sample.core.build"/>
     <antcall target="docs.sample.docs.build"/>
     <antcall target="gbase.sample.gbase.build"/>
@@ -70,12 +43,13 @@
     <antcall target="youtube.sample.youtube.build"/>
   </target>
 
-  <target name="samples.clean">
+  <target name="clean">
     <antcall target="appsforyourdomain.sample.appsforyourdomain.clean"/>
     <antcall target="authsub.sample.authsub.clean"/>
     <antcall target="blogger.sample.blogger.clean"/>
     <antcall target="calendar.sample.calendar.clean"/>
     <antcall target="codesearch.sample.codesearch.clean"/>
+    <antcall target="contacts.sample.contacts.clean"/>
     <antcall target="core.sample.core.clean"/>
     <antcall target="docs.sample.docs.clean"/>
     <antcall target="gbase.sample.gbase.clean"/>
@@ -87,8 +61,8 @@
 
 <!--  ===================================================================== -->
 <!--                      Global target                                     -->
-<!--  ===================================================================== --> 
-  <target name="all" depends="clean,samples.clean,build,samples.build"
-   description="Clean build and dist directories, then build dist"/>   
+<!--  ===================================================================== -->
+  <target name="all" depends="clean,build"
+   description="Rebuild samples"/>
 
 </project>