Instrucciones de configuración

Si no usas una biblioteca generada, puedes puedes descargar la biblioteca cliente de la API de Google para Java y sus dependencias en un ZIP o Maven.

Consulta también las instrucciones de configuración de ProGuard que forman parte de la documentación de la biblioteca cliente HTTP de Google para Java.

Cómo descargar la biblioteca con dependencias

Descarga el archivo ZIP más reciente, que puedes encontrar en la página de descargas, y extráelo en tu computadora. Este archivo ZIP contiene los archivos jar de clase de la biblioteca cliente y los archivos jar de origen asociados para cada artefacto y sus dependencias. Puedes encontrar los gráficos de dependencia y las licencias para las diferentes bibliotecas en la carpeta de dependencias. Para obtener más detalles sobre el contenido de la descarga, consulta el archivo readme.html.

Android

Si desarrollas contenido para Android y la API de Google que quieres usar se incluye en la biblioteca de Servicios de Google Play, úsala para obtener un rendimiento y una experiencia óptimos.

Si usas la biblioteca cliente de las APIs de Google para Java con Android, es importante que sepas qué dependencias son compatibles con Android, específicamente qué nivel de SDK de Android. Las aplicaciones para Android requieren los siguientes archivos JAR, o versiones compatibles más recientes, de la carpeta 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

Las aplicaciones de Google App Engine requieren los siguientes archivos JAR, o versiones compatibles más recientes, de la carpeta 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

Las aplicaciones de servlet requieren los siguientes archivos JAR, o versiones compatibles más recientes, de la carpeta 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

Las aplicaciones Java de uso general requieren los siguientes archivos JAR, o versiones compatibles más recientes, de la carpeta 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 generadas para APIs de Google

El repositorio de las bibliotecas generadas incluye instrucciones para usar cada versión de las APIs.

Maven

La biblioteca cliente de las APIs de Google para Java se encuentra en el repositorio central de Maven. El groupId de Maven para todos los artefactos de esta biblioteca es com.google.api-client. Se proporcionan instrucciones específicas de Maven para cada módulo (a continuación).

Módulos

Esta biblioteca se compone de nueve módulos:

google-api-client

La biblioteca cliente de las API de Google para Java (google-api-client) está diseñada para ser compatible con todas las plataformas de Java compatibles, incluido Android.

Uso de Maven:

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

En Android, deberás excluir de forma explícita las dependencias que no se usen:

<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

Extensiones de la biblioteca cliente de las APIs de Google para Java (google-api-client-android) Admitir aplicaciones de Google Android para Java (solo para SDK >= 2.1). Este módulo depende de google-api-client y google-http-client-android.

Uso de Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-android</artifactId>
  <version>2.4.0</version>
</dependency>

google-api-client-servlet

Las extensiones de servlet y JDO de la biblioteca cliente de la API de Google para Java (google-api-client-servlet) son compatibles con las aplicaciones web del servlet de Java. Este módulo depende de google-api-client y google-oauth-client-servlet.

Uso de Maven:

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

google-api-client-appengine

Las extensiones de Google App Engine para la biblioteca cliente de las API de Google para Java (google-api-client-appengine) son compatibles con las aplicaciones de Google App Engine para Java. Este módulo depende de google-api-client, google-api-client-servlet, google-oauth-client-appengine y google-http-client-appengine.

Uso de Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-appengine</artifactId>
  <version>2.4.0</version>
</dependency>

google-api-client-gson

Extensiones de GSON para la biblioteca cliente de la API de Google para Java (google-api-client-gson) Este módulo depende de google-api-client y google-http-client-gson.

Uso de Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-gson</artifactId>
  <version>2.4.0</version>
</dependency>

google-api-client-jackson2

Extensiones de Jackson2 a la biblioteca cliente de las API de Google para Java (google-api-client-jackson2) Este módulo depende de google-api-client y google-http-client-jackson2.

Uso de Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-jackson2</artifactId>
  <version>2.4.0</version>
</dependency>

google-api-client-protobuf

Búfer de protocolo en la biblioteca cliente de la API de Google para Java (google-api-client-protobuf). Este módulo depende de google-http-client-protobuf y google-api-client.

Uso de Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-protobuf</artifactId>
  <version>2.4.0</version>
</dependency>

google-api-client-xml

Extensiones XML para la biblioteca cliente de las APIs de Google para Java (google-api-client-xml) Este módulo depende de google-api-client y google-http-client-xml.

Uso de Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-xml</artifactId>
  <version>2.4.0</version>
</dependency>