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:

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

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.

googleapis/google-api-java-client