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 as dependências dela em um arquivo ZIP ou use o Maven.

Veja também as instruções de configuração do ProGuard que fazem parte da biblioteca 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 você pode encontrar 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 dependências dele. É possível encontrar gráficos e dependências de dependência para cada biblioteca 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 o melhor desempenho e experiência.

Se você está usando a biblioteca de cliente da API do Google para Java com Android, é importante saber quais dependências são compatíveis com o Android, especificamente 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.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 mais recentes compatíveis 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-hyperparameter-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
  • transação-api-1.1.jar
  • xpp3-1.1.4c.jar

Servlet

Os aplicativos de servlet exigem os seguintes arquivos jar ou versões mais recentes compatíveis 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-hyperparameter-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
  • transação-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 da API do Google para Java está no repositório Maven central. O Maven groupId 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 de 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 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, é necessário excluir explicitamente as dependências não utilizadas:

<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) são compatíveis com aplicativos Java do Google para Android (apenas 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.0.0</version>
</dependency>

google-api-client-servlet

As extensões do servlet e da biblioteca da biblioteca de cliente da API do Google para Java (google-api-client- servlet) são compatíveis com aplicativos da Web do servlet do Java. Este 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.0.0</version>
</dependency>

google-api-client-appengine

As extensões do Google App Engine à biblioteca de cliente da API do Google para Java (google-api-client-appengine) são compatíveis com aplicativos Java do Google App Engine. Este 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.0.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.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 superiores) à biblioteca de cliente da API do Google para Java (google-api-client-java6). Este 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 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.0.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.0.0</version>
</dependency>