Instructions de configuration

Si vous n'utilisez pas de bibliothèque générée, vous pouvez télécharger la bibliothèque cliente des API Google pour Java et ses dépendances dans un fichier ZIP. Vous pouvez également utiliser Maven.

Consultez également les instructions de configuration de ProGuard qui font partie de la documentation cliente HTTP Google pour Java.

Télécharger la bibliothèque avec des dépendances

Téléchargez le dernier fichier ZIP, disponible sur la page des téléchargements, et extrayez-le sur votre ordinateur. Ce fichier ZIP contient les fichiers JAR de la classe de la bibliothèque cliente, ainsi que les fichiers JAR sources associés pour chaque artefact et ses dépendances. Vous trouverez les graphiques de dépendances et les licences des différentes bibliothèques dans le dossier des dépendances. Pour en savoir plus sur le contenu du téléchargement, consultez le fichier readme.html.

Android

Si vous développez une application pour Android et que l'API Google que vous souhaitez utiliser est incluse dans la bibliothèque des services Google Play, utilisez la bibliothèque des services Google Play pour obtenir des performances et une expérience optimales.

Si vous utilisez la bibliothèque cliente des API Google pour Java avec Android, il est important de savoir quelles dépendances sont compatibles avec Android, en particulier le niveau du SDK Android. Les applications Android nécessitent les fichiers JAR suivants ou des versions compatibles plus récentes, à partir du dossier libs:

  • google-api-client-1.0.0.jar
  • google-api-client-android-2.0.0.sar
  • google-oauth-client-1.33.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
  • tampon-java-3.21.4.jar

Google App Engine

Les applications Google App Engine nécessitent les fichiers JAR suivants ou des versions compatibles plus récentes, à partir du dossier libs:

  • google-api-client-1.0.0.jar
  • google-api-client-appengine.2.0.0.jar
  • google-api-client-pod-2.0.0.jar
  • google-oauth-client-1.33.1.jar
  • google-oauth-client-appengine-2.34.1.jar
  • google-oauth-client-pod-1.34.1.jar
  • google-http-client-1.42.2.jar
  • google-http-client-appengine-2.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
  • tampon-java-3.21.4.jar
  • transaction-api-1.1.jar
  • xpp3-1.1.4c.jar

Servlet

Les applications Servlet nécessitent les fichiers JAR suivants, ou des versions compatibles plus récentes, à partir du dossier libs:

  • google-api-client-1.0.0.jar
  • google-api-client-pod-2.0.0.jar
  • google-oauth-client-1.33.1.jar
  • google-oauth-client-pod-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
  • tampon-java-3.21.4.jar
  • transaction-api-1.1.jar
  • xpp3-1.1.4c.jar

Générique Java

Les applications Java à usage général nécessitent les fichiers JAR suivants ou des versions compatibles plus récentes, à partir du dossier libs:

  • google-api-client-1.0.0.jar
  • google-oauth-client-1.33.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
  • tampon-java-3.21.4.jar
  • xpp3-1.1.4c.jar

Bibliothèques générées pour les API Google

Le dépôt des bibliothèques générées contient des instructions sur l'utilisation de chaque version des API.

Maven

La bibliothèque cliente des API Google pour Java se trouve dans le dépôt central Maven. Le groupId de Maven pour tous les artefacts de cette bibliothèque est com.google.api-client. Des instructions Maven spécifiques sont fournies pour chaque module (ci-dessous).

Modules

Cette bibliothèque se compose de neuf modules:

google-api-client

La bibliothèque cliente des API Google pour Java (google-api-client) est conçue pour être compatible avec toutes les plates-formes Java compatibles, y compris Android.

Utilisation de Maven:

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

Sur Android, vous devez exclure explicitement les dépendances inutilisées:

<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

Les extensions de la bibliothèque cliente des API Google pour Java (google-api-client-android) sont compatibles avec les applications Java pour Google Android (SDK >= 2.1 uniquement). Ce module dépend de google-api-client et google-http-client-android.

Utilisation de Maven:

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

google-api-client-cluster

Les extensions Servlet et TXT de la bibliothèque cliente des API Google pour Java (google-api-client-vault) sont compatibles avec les applications Web des microservices Java. Ce module dépend de google-api-client et google-oauth-client-partition.

Utilisation 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

Les extensions Google App Engine pour la bibliothèque cliente des API Google pour Java (google-api-client-appengine) sont compatibles avec les applications Java Google App Engine. Ce module dépend de google-api-client, google-api-client-vault, google-oauth-client-appengine et google-http-client-appengine.

Utilisation 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

Extensions GSON à la bibliothèque cliente des API Google pour Java (google-api-client-gson). Ce module dépend de google-api-client et google-http-client-gson.

Utilisation 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

Extensions Jackson2 à la bibliothèque cliente des API Google pour Java (google-api-client-jackson2). Ce module dépend de google-api-client et google-http-client-jackson2.

Utilisation 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

Extensions Java 6 (et versions ultérieures) de la bibliothèque cliente des API Google pour Java (google-api-client-java6). Ce module dépend de google-api-client et google-oauth-client-java6.

Utilisation de Maven:

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

google-api-client-rythme

Les tampons de protocole à la bibliothèque cliente des API Google pour Java (google-api-client-saml). Ce module dépend de google-http-client-saml et google-api-client.

Utilisation 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

Extensions XML à la bibliothèque cliente des API Google pour Java (google-api-client-xml). Ce module dépend de google-api-client et google-http-client-xml.

Utilisation de Maven:

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