Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/googleapis/google-api-java-client
Google APIs Client Library for Java
https://github.com/googleapis/google-api-java-client
Last synced: about 8 hours ago
JSON representation
Google APIs Client Library for Java
- Host: GitHub
- URL: https://github.com/googleapis/google-api-java-client
- Owner: googleapis
- License: apache-2.0
- Created: 2014-10-28T17:31:34.000Z (about 10 years ago)
- Default Branch: main
- Last Pushed: 2024-12-10T21:02:27.000Z (23 days ago)
- Last Synced: 2024-12-24T13:16:46.914Z (9 days ago)
- Language: Java
- Homepage:
- Size: 14 MB
- Stars: 1,352
- Watchers: 189
- Forks: 700
- Open Issues: 47
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Support: docs/support.md
Awesome Lists containing this project
README
# 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](https://github.com/googleapis/google-api-java-client/wiki/OAuth2) library with a consistent interface.
- Lightweight, efficient XML and JSON data models that support any data schema.
- Support for [protocol buffers](https://github.com/google/protobuf/).
- A set of [generated libraries for Google APIs](https://github.com/googleapis/google-api-java-client-services#supported-google-apis).
## Supported Java environments
- Java 7 (or higher)
- Android 1.6 (or higher)
- [Google App Engine](https://github.com/googleapis/google-api-java-client/wiki/App-Engine)
## Usage
For detailed instructions on usage, please visit the [guide](https://developers.google.com/api-client-library/java).
## Installation
The Google APIs Client Library for Java is easy to install.
To use Maven, add the following lines to your pom.xml file:
[//]: # ({x-version-update-start:google-api-client:released})
```maven
com.google.api-client
google-api-client
1.33.0
```
To use Gradle, add the following lines to your build.gradle file:
```gradle
repositories {
mavenCentral()
google()
}
dependencies {
compile 'com.google.api-client:google-api-client:1.33.0'
}
```
[//]: # ({x-version-update-end})
## 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 | [](https://storage.googleapis.com/cloud-devrel-public/java/badges/google-api-java-client/java7.html)
Java 8 | [](https://storage.googleapis.com/cloud-devrel-public/java/badges/google-api-java-client/java8.html)
Java 11 | [](https://storage.googleapis.com/cloud-devrel-public/java/badges/google-api-java-client/java11.html)
## 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](https://github.com/googleapis/google-http-java-client)
- [Google OAuth Client Library for Java](https://github.com/googleapis/google-oauth-java-client)
## 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](https://github.com/googleapis/google-api-java-client-services/)
- [JavaDoc](https://googleapis.dev/java/google-api-client/latest/)
## Contributing
Contributions to this library are always welcome and highly encouraged.
See [CONTRIBUTING](CONTRIBUTING.md) 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](CODE_OF_CONDUCT.md) for more
information.
For questions or concerns, please file an issue in the GitHub repository.