## ${project.name} ${project.version}

### Overview

High-level details about this library can be found at http://code.google.com/p/google-api-java-client

- Release Notes
- JavaDoc
- Developer's Guide
- Support

### Dependencies and Licenses

The license can be found here.
Dependent jars can be found in the libs folder and the corresponding source jars can be found in the libs-sources folder.
The dependency structure and licenses for the different libraries can be found here:

- google-api-client: google-api-client-dependencies.html
- google-api-client-android: google-api-client-android-dependencies.html
- google-api-client-appengine: google-api-client-appengine-dependencies.html
- google-api-client-servlet: google-api-client-servlet-dependencies.html
- google-api-client-java6: google-api-client-java6-dependencies.html
- google-oauth-client: google-oauth-client-dependencies.html
- google-oauth-client-appengine: google-oauth-client-appengine-dependencies.html
- google-oauth-client-servlet: google-oauth-client-servlet-dependencies.html
- google-oauth-client-java6: google-oauth-client-java6-dependencies.html
- google-oauth-client-java7: google-oauth-client-java7-dependencies.html
- google-oauth-client-jetty: google-oauth-client-jetty-dependencies.html
- google-http-client: google-http-client-dependencies.html
- google-http-client-android: google-http-client-android-dependencies.html
- google-http-client-appengine: google-http-client-appengine-dependencies.html
- google-http-client-protobuf: google-http-client-protobuf-dependencies.html
- google-http-client-gson: google-http-client-gson-dependencies.html
- google-http-client-jackson: google-http-client-jackson-dependencies.html
- google-http-client-jackson2: google-http-client-jackson2-dependencies.html

### Maven Usage

For information on how to add these libraries to your Maven project please see http://code.google.com/p/google-api-java-client/wiki/Setup#Maven.

### Eclipse

A .classpath file snippet that can be included in your project's .classpath has been provided here. Please only use the classpathentry's you actually need (see below for details).

### ProGuard

A ProGuard configuration file proguard-google-api-client.txt is included for common settings for using the library. On Android projects, you may want to add a reference to `proguard-google-api-client.txt` in the `project.properties` file under the `proguard.config` property.

Please read Setup ProGuard for more details.

### Dependencies for all Platforms

The following are the jars from the libs folder needed for applications on all platform:

- google-api-client-${project.version}.jar
- google-oauth-client-${project.oauth.version}.jar
- google-http-client-${project.http.version}.jar
- jsr305-${project.jsr305.version}.jar
- google-api-client-protobuf-${project.api.version}.jar (when using protobuf-java)
  - google-http-client-protobuf-${project.http.version}.jar
  - protobuf-java-${project.protobuf-java.version}.jar
- google-api-client-gson-${project.api.version}.jar (when using GSON)
  - google-http-client-gson-${project.http.version}.jar
  - gson-${project.gson.version}.jar
- google-api-client-jackson2-${project.api.version}.jar (when using Jackson 2)
  - google-http-client-jackson2-${project.http.version}.jar
  - jackson-core-${project.jackson-core2.version}.jar
- google-http-client-jackson-${project.http.version}.jar (when using Jackson 1)
  - jackson-core-asl-${project.jackson-core-asl.version}.jar
- google-api-client-xml-${project.version}.jar (when using XML)
  - google-http-client-xml-${project.version}.jar
  - xpp3-${project.xpp3.version}.jar (when NOT on Android)

### Android Dependencies

The following are the jars from the libs folder required for Android applications:

- google-api-client-android-${project.version}.jar (for SDK >= 2.1)
- google-http-client-android-${project.http.version}.jar

The libs folder also contains properties files that specify the location of source jars for Android projects in Eclipse.
Please see the Android wiki for the Android Developer's Guide.

### Google App Engine Dependencies

The following are the jars from the libs folder required for Google App Engine applications or a newer compatible version:

- google-api-client-appengine-${project.version}.jar
- google-api-client-servlet-${project.version}.jar
- google-oauth-client-appengine-${project.oauth.version}.jar
- google-oauth-client-servlet-${project.oauth.version}.jar
- google-http-client-appengine-${project.http.version}.jar
- jdo2-api-${project.jdo2-api.version}.jar
- transaction-api-${project.transaction-api.version}.jar

Please see the GoogleAppEngine wiki for the Google App Engine Developer's Guide.

### Servlet Dependencies

The following are the jars from the libs folder required for Servlet applications or a newer compatible version:

- google-api-client-servlet-${project.version}.jar
- google-oauth-client-servlet-${project.oauth.version}.jar
- commons-logging-${project.commons-logging.version}.jar
- httpclient-${project.httpclient.version}.jar
- httpcore-${project.httpcore.version}.jar
- jdo2-api-${project.jdo2-api.version}.jar
- transaction-api-${project.transaction-api.version}.jar

### General Purpose Java 5 Environment Dependencies

The following are the jars from the libs folder required for general purpose Java 5 applications or a newer compatible version:

- google-api-client-java6-${project.version}.jar
- google-oauth-client-java6-${project.oauth.version}.jar (for JDK >= 6)
  - google-oauth-client-jetty-${project.oauth.version}.jar (for Jetty 6)
    - jetty-${project.jetty.version}.jar
    - jetty-util-${project.jetty.version}.jar
- google-oauth-client-java7-${project.version}.jar (for JDK >= 7)
- commons-logging-${project.commons-logging.version}.jar
- httpclient-${project.httpclient.version}.jar
- httpcore-${project.httpcore.version}.jar