Skip to content


Google APIs Client Library for Java


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:

Supported Java environments


For detailed instructions on usage, please visit the guide.


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

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


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

repositories {
dependencies {
    compile ''

Building locally

One time setup

mkdir /tmp/foo && cd /tmp/foo
unzip play-services-basement-8.3.0.aar
mvn install:install-file \
  -Dfile=classes.jar \ \
  -DartifactId=google-play-services \
  -Dversion=1 \
cd -

CI Status

Java Version Status
Java 7 Kokoro CI
Java 8 Kokoro CI
Java 11 Kokoro CI


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


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).


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.



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.