Google APIs Client Library for Java

Description

The Google APIs Client Library for Java is a flexible, efficient, and powerful Java client library
for accessing any HTTP-based API on the web, not just Google APIs.

The library has the following features:

• A powerful OAuth 2.0 library with a consistent interface.
• Lightweight, efficient XML and JSON data models that support any data schema.
• Support for protocol buffers.
• A set of generated libraries for Google APIs.

Supported Java environments

• Java 7 (or higher)
• Android 1.6 (or higher)
• Google App Engine

Usage

For detailed instructions on usage, please visit the guide.

Installation

The Google APIs Client Library for Java is easy to install.

To use Maven, add the following lines to your pom.xml file:

<project>
  <dependencies>
    <dependency>
      <groupId>com.google.api-client</groupId>
      <artifactId>google-api-client</artifactId>
      <version>1.33.0</version>
    </dependency>
  </dependencies>
</project>

To use Gradle, add the following lines to your build.gradle file:

repositories {
    mavenCentral()
    google()
}
dependencies {
    compile 'com.google.api-client:google-api-client:1.33.0'
}

Building locally

One time setup

mkdir /tmp/foo && cd /tmp/foo
wget https://dl.google.com/dl/android/maven2/com/google/android/gms/play-services-basement/8.3.0/play-services-basement-8.3.0.aar
unzip play-services-basement-8.3.0.aar
mvn install:install-file \
  -Dfile=classes.jar \
  -DgroupId=com.google.android.google-play-services \
  -DartifactId=google-play-services \
  -Dversion=1 \
  -Dpackaging=jar
cd -

CI Status

Java Version	Status
Java 7
Java 8
Java 11

Dependencies

This library is built on top of two common libraries, also built by Google, and also designed to
work with any HTTP service on the web:

• Google HTTP Client Library for Java
• Google OAuth Client Library for Java

Important Warnings

@Beta

Features marked with the @Beta annotation at the class or method level are subject to change. They
might be modified in any way, or even removed, in any major release. You should not use beta features
if your code is a library itself (that is, if your code is used on the CLASSPATH of users outside
your own control).

Deprecations

Deprecated non-beta features will be removed eighteen months after the release in which they are
first deprecated. You must fix your usages before this time. If you don’t, any type of breakage
might result, and you are not guaranteed a compilation error.

Documentation

• Libraries and Samples
• JavaDoc

Contributing

Contributions to this library are always welcome and highly encouraged.

See CONTRIBUTING documentation for more information on how to get started.

Please note that this project is released with a Contributor Code of Conduct. By participating in
this project you agree to abide by its terms. See Code of Conduct for more
information.

For questions or concerns, please file an issue in the GitHub repository.