Instrucciones de configuración

Si no usas una biblioteca generada, puedes descargar la biblioteca cliente de la API de Google para Java y sus dependencias en un archivo ZIP, o puedes usar 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.

Descarga la biblioteca con dependencias

Descarga el último archivo ZIP que puedes encontrar en la página de descargas y extráelo en tu computadora. Este archivo ZIP contiene los archivos jar de la clase de la biblioteca cliente y los archivos fuente asociados para cada artefacto y sus dependencias. En la carpeta de dependencias, encontrarás las licencias y los gráficos de dependencia correspondientes. Para obtener más información sobre el contenido de la descarga, consulta el archivo readme.html.

Android

Si estás desarrollando una app para Android y la API de Google que quieres usar está incluida en la biblioteca de Servicios de Google Play, usa esa biblioteca para obtener el mejor rendimiento y la mejor experiencia.

Si usas la biblioteca cliente de la API 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 de Android requieren los siguientes archivos JAR o versiones compatibles más recientes de la carpeta 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

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.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

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

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.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 generadas para las API de Google

El repositorio de las bibliotecas generadas tiene instrucciones sobre cómo usar cada versión de las API.

Maven

La biblioteca cliente de la API 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 (más abajo).

Módulos

Esta biblioteca consta de nueve módulos:

google-api-client

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

Uso de Maven:

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

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

<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

Las extensiones de la biblioteca cliente de la API de Google para Java (google-api-client-android) admiten Java de Google Android (solo para aplicaciones >= 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.0.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) admiten aplicaciones web de 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.0.0</version>
</dependency>

google-api-client-appengine

Las extensiones de Google App Engine a la biblioteca cliente de la API de Google para Java (google-api-client-appengine) admiten aplicaciones Java de Google App Engine. 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.0.0</version>
</dependency>

google-api-client-gson

Extensiones de GSON a 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.0.0</version>
</dependency>

google-api-client-jackson2

Extensiones de Jackson2 a la biblioteca cliente de la 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.0.0</version>
</dependency>

google-api-client-java6

Extensiones de Java 6 (y versiones posteriores) a la biblioteca cliente de la API de Google para Java (google-api-client-java6) Este módulo depende de google-api-client y google-oauth-client-java6.

Uso de Maven:

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

google-api-client-protobuf

Extensiones de búfer de protocolo a 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.0.0</version>
</dependency>

google-api-client-xml.

Extensiones XML de la biblioteca cliente de la API 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.0.0</version>
</dependency>