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 se incluyen en la documentación de la biblioteca cliente HTTP de Google para Java.
Descarga 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 gráficos de dependencias y licencias para las diferentes bibliotecas en la carpeta de dependencias. Para obtener más información sobre el contenido de la descarga, consulta el archivo readme.html.
Android
Si estás desarrollando contenido para Android, y la API de Google que quieres usar se incluye en la biblioteca de Servicios de Google Play, úsala para obtener el mejor rendimiento y la mejor experiencia posible.
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 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 de 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 las APIs de Google
El repositorio de las bibliotecas generadas contiene instrucciones para usar cada versión de las APIs.
Maven
La biblioteca cliente de las API de Google para Java se encuentra en el repositorio de Maven central.
El groupId
de Maven para todos los artefactos de esta biblioteca es com.google.api-client
.
A continuación, se proporcionan instrucciones específicas de Maven para cada módulo.
Módulos
Esta biblioteca consta de nueve módulos:
- google-api-client
- google-api-client-android
- google-api-client-appengine
- google-api-client-servlet
- google-api-client-gson
- google-api-client-jackson2
- google-api-client-protobuf
- google-api-client-xml
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 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 manera explícita las dependencias sin usar:
<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
Las extensiones de la biblioteca cliente de las APIs de Google para Java (google-api-client-android) admiten 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 para la biblioteca cliente de las 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.4.0</version> </dependency>
google-api-client-appengine
Las extensiones de Google App Engine para la biblioteca cliente de las APIs de Google para Java (google-api-client-appengine) admiten 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 en la biblioteca cliente de las 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 Jackson2 de 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
El búfer de protocolo se extiende a la biblioteca cliente de las APIs 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>