Instruções de configuração

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

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>