Se você não estiver usando uma biblioteca gerada, faça o download da biblioteca de cliente das APIs do Google para Java e das dependências dela em um arquivo ZIP ou use o Maven.
Consulte também as instruções de configuração do ProGuard que fazem parte da documentação da biblioteca de cliente HTTP do Google para Java.
Fazer o download da biblioteca com dependências
Faça o download do arquivo ZIP mais recente, que pode ser encontrado na página de downloads, e o extraia no computador. Esse arquivo zip contém os arquivos jar da classe da biblioteca de cliente e os arquivos jar de origem associados a cada artefato e suas dependências. Na pasta de dependências, você encontra os gráficos de dependência e as licenças das diferentes bibliotecas. Para obter mais detalhes sobre o conteúdo do download, consulte o arquivo readme.html.
Android
Se você estiver desenvolvendo para Android e a API do Google que gostaria de usar está incluída na biblioteca do Google Play Services, use a biblioteca do Google Play Services para ter o melhor desempenho e a melhor experiência.
Se você está usando a biblioteca de cliente da API do Google para Java com o Android, é importante saber quais dependências são compatíveis com o Android, especificamente qual é o nível do SDK do Android. Os aplicativos Android exigem os seguintes arquivos jar ou versões compatíveis mais recentes da pasta libs:
- google-api-client-2.4.0.jar
- google-api-client-android-2.4.0.jar
- google-oauth-client-1.34.1.jar
- google-http-client-1.42.2.jar
- google-http-client-android-1.42.2.jar
- gson-2.9.0.jar
- "jackson-core-2.13.3.jar" (Jackson-core-2.13.3.jar).
- jsr305-3.0.2.jar
- protobuf-java-3.21.4.jar
Google App Engine
Os aplicativos do Google App Engine exigem os seguintes arquivos jar, ou versões compatíveis mais recentes, da pasta libs:
- google-api-client-2.4.0.jar
- google-api-client-appengine-2.4.0.jar
- google-api-client-servlet-2.4.0.jar
- google-oauth-client-1.34.1.jar
- google-oauth-client-appengine-1.34.1.jar
- google-oauth-client-servlet-1.34.1.jar
- google-http-client-1.42.2.jar
- google-http-client-appengine-1.39.2.jar
- gson-2.9.0.jar
- "jackson-core-2.13.3.jar" (Jackson-core-2.13.3.jar).
- jdo2-api-2.3-eb.jar
- jsr305-3.0.2.jar
- protobuf-java-3.21.4.jar
- transaction-api-1.1.jar.
- xpp3-1.1.4c.jar
Servlet
Os aplicativos servlet exigem os seguintes arquivos jar, ou versões compatíveis mais recentes, da pasta libs:
- google-api-client-2.4.0.jar
- google-api-client-servlet-2.4.0.jar
- google-oauth-client-1.34.1.jar
- google-oauth-client-servlet-1.34.1.jar
- google-http-client-1.42.2.jar
- commons-logging-1.2.jar
- gson-2.9.0.jar
- httpclient-4.5.13.jar
- httpcore-4.4.12.jar (link em inglês)
- "jackson-core-2.13.3.jar" (Jackson-core-2.13.3.jar).
- jdo2-api-2.3-eb.jar
- jsr305-3.0.2.jar
- protobuf-java-3.21.4.jar
- transaction-api-1.1.jar.
- xpp3-1.1.4c.jar
Java genérico
Aplicativos Java de uso geral exigem os seguintes arquivos jar ou versões compatíveis mais recentes da pasta libs:
- google-api-client-2.4.0.jar
- google-oauth-client-1.34.1.jar
- google-http-client-1.42.2.jar
- google-http-client-jackson2-1.39.2.jar
- commons-logging-1.2.jar
- gson-2.9.0.jar
- httpclient-4.5.13.jar
- httpcore-4.4.12.jar (link em inglês)
- "jackson-core-2.13.3.jar" (Jackson-core-2.13.3.jar).
- jsr305-3.0.2.jar
- protobuf-java-3.21.4.jar
- xpp3-1.1.4c.jar
Bibliotecas geradas para APIs do Google
O repositório das bibliotecas geradas tem instruções sobre como usar cada versão das APIs.
Maven
A biblioteca de cliente da API do Google para Java está no repositório Maven central.
O groupId
do Maven para todos os artefatos desta biblioteca é com.google.api-client
.
São fornecidas instruções específicas do Maven para cada módulo abaixo.
Módulos
Ela é composta por nove módulos:
- google-api-client
- google-api-client-android
- google-api-client-appengine
- google-api-client-servlet
- google-api-client-gson
- google-api-client-jackson2
- google-api-client-protobuf
- google-api-client-xml
google-api-client
A biblioteca de cliente da API do Google para Java (google-api-client) foi desenvolvida para ser compatível com todas as plataformas Java compatíveis, incluindo o Android.
Uso do Maven:
<dependency> <groupId>com.google.api-client</groupId> <artifactId>google-api-client</artifactId> <version>2.4.0</version> </dependency>
No Android, você precisará excluir explicitamente as dependências não utilizadas:
<dependency> <groupId>com.google.api-client</groupId> <artifactId>google-api-client</artifactId> <version>2.4.0</version> <exclusions> <exclusion> <artifactId>xpp3</artifactId> <groupId>xpp3</groupId> </exclusion> <exclusion> <artifactId>httpclient</artifactId> <groupId>org.apache.httpcomponents</groupId> </exclusion> <exclusion> <artifactId>junit</artifactId> <groupId>junit</groupId> </exclusion> <exclusion> <artifactId>android</artifactId> <groupId>com.google.android</groupId> </exclusion> </exclusions> </dependency>
google-api-client-android
As extensões da biblioteca de cliente da API do Google para Java (google-api-client-android) oferecem suporte a apps em Java do Google para Android (somente para apps com SDK >= 2.1). Esse módulo depende de google-api-client e google-http-client-android.
Uso do Maven:
<dependency> <groupId>com.google.api-client</groupId> <artifactId>google-api-client-android</artifactId> <version>2.4.0</version> </dependency>
google-api-client-servlet
As extensões servlet e WebP para a biblioteca de cliente de APIs do Google para Java (google-api-client-servlet) oferecem suporte a aplicativos da web servlet Java. Esse módulo depende de google-api-client e google-oauth-client-servlet.
Uso do Maven:
<dependency> <groupId>com.google.api-client</groupId> <artifactId>google-api-client-servlet</artifactId> <version>2.4.0</version> </dependency>
google-api-client-appengine
As extensões do Google App Engine para a biblioteca de cliente da API do Google para Java (google-api-client-appengine) oferecem suporte a aplicativos Java do Google App Engine. Esse módulo depende de google-api-client, google-api-client-servlet, google-oauth-client-appengine e google-http-client-appengine.
Uso do Maven:
<dependency> <groupId>com.google.api-client</groupId> <artifactId>google-api-client-appengine</artifactId> <version>2.4.0</version> </dependency>
google-api-client-gson
Extensões GSON para a biblioteca de cliente da API do Google para Java (google-api-client-gson). Este módulo depende de google-api-client e google-http-client-gson.
Uso do Maven:
<dependency> <groupId>com.google.api-client</groupId> <artifactId>google-api-client-gson</artifactId> <version>2.4.0</version> </dependency>
google-api-client-jackson2
Jackson2 à biblioteca de cliente da API do Google para Java (google-api-client-jackson2). Este módulo depende de google-api-client e google-http-client-jackson2.
Uso do Maven:
<dependency> <groupId>com.google.api-client</groupId> <artifactId>google-api-client-jackson2</artifactId> <version>2.4.0</version> </dependency>
google-api-client-protobuf
Extensões de buffer de protocolo para a biblioteca de cliente da API do Google para Java (google-api-client-protobuf). Este módulo depende de google-http-client-protobuf e google-api-client.
Uso do Maven:
<dependency> <groupId>com.google.api-client</groupId> <artifactId>google-api-client-protobuf</artifactId> <version>2.4.0</version> </dependency>
google-api-client-xml
Extensões XML para a biblioteca de cliente da API do Google para Java (google-api-client-xml). Esse módulo depende de google-api-client e google-http-client-xml.
Uso do Maven:
<dependency> <groupId>com.google.api-client</groupId> <artifactId>google-api-client-xml</artifactId> <version>2.4.0</version> </dependency>