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. Se preferir, 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 suas dependências. Na pasta de dependências, você encontra gráficos de dependência e licenças para as 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 você quer usar está incluída na biblioteca do Google Play Services, use essa biblioteca para ter o melhor desempenho e a melhor experiência.

Se você estiver usando a biblioteca de cliente das APIs do Google para Java com o Android, é importante saber quais dependências são compatíveis com o Android, especificamente qual nível de 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.0.0.jar
  • google-api-client-android-2.0.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.0.0.jar
  • google-api-client-appengine-2.0.0.jar
  • google-api-client-servlet-2.0.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

Esses aplicativos exigem os seguintes arquivos jar, ou versões compatíveis mais recentes, da pasta libs:

  • google-api-client-2.0.0.jar
  • google-api-client-servlet-2.0.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.0.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 das APIs do Google para Java está no repositório Maven central. O groupId do Maven para todos os artefatos dessa biblioteca é com.google.api-client. Instruções específicas do Maven são fornecidas para cada módulo (abaixo).

Módulos

Essa biblioteca é composta por nove módulos:

google-api-client

A biblioteca de cliente das APIs do Google para Java (google-api-client) foi projetada 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.0.0</version>
</dependency>

No Android, será necessário excluir explicitamente as dependências não usadas:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client</artifactId>
  <version>2.0.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 ao Java para Google Android (apenas para apps do 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.0.0</version>
</dependency>

google-api-client-servlet

As extensões ndk e JavaScript para a biblioteca de cliente de APIs do Google para Java (google-api-client- inclui) são compatíveis com aplicativos da Web de json para Java. Esse módulo depende de google-api-client e google-oauth-client- inclui.

Uso do Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-servlet</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-appengine

As extensões do Google App Engine para a biblioteca de cliente das APIs 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- inclui, 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.0.0</version>
</dependency>

google-api-client-gson

GSON para a biblioteca de cliente das APIs 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.0.0</version>
</dependency>

google-api-client-jackson2

Jackson2 para a 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.0.0</version>
</dependency>

google-api-client-java6

Extensões Java 6 (e posteriores) para a biblioteca de cliente de APIs do Google para Java (google-api-client-java6). Esse módulo depende de google-api-client e google-oauth-client-java6.

Uso do Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-java6</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-protobuf

Extensões de buffer de protocolo para a biblioteca de cliente das 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.0.0</version>
</dependency>

google-api-client-xml

Extensões XML para a biblioteca de cliente das APIs 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.0.0</version>
</dependency>