Instruções de configuração

Se você não estiver usando uma biblioteca gerada, faça o download da biblioteca de cliente da API 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, localizado na página de downloads, e extraia-o 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 as respectivas dependências. Você pode encontrar gráficos de dependência e licenças para as diferentes bibliotecas na pasta de dependências. Para 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 você quer usar estiver incluída na biblioteca do Google Play Services, use a biblioteca do Google Play Services para ter a melhor performance e experiência.

Se você estiver 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 com qual 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
  • 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
  • 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 de 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
  • 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

Os 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
  • 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 central do Maven. O groupId do Maven para todos os artefatos dessa biblioteca é com.google.api-client. Confira abaixo instruções específicas do Maven para cada módulo.

Módulos

Essa biblioteca é composta por nove módulos:

google-api-client

A biblioteca de cliente da API do Google para Java (google-api-client) foi projetada para ser compatível com todas as plataformas Java com suporte, 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, é necessário excluir explicitamente as dependências não usadas:

<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) são compatíveis com aplicativos Java do Google Android (somente para SDK >= 2.1). Este 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 JDO para a Biblioteca de cliente da API do Google para Java (google-api-client-servlet) oferecem suporte a aplicativos da Web de servlets 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) são compatíveis com 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 do GSON para a biblioteca de cliente da API do Google para Java (google-api-client-gson). Esse 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

Extensões do Jackson2 para a biblioteca de cliente da API do Google para Java (google-api-client-jackson2). Esse 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 de APIs do Google para Java (google-api-client-protobuf). Esse 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). Este 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>