Istruzioni di configurazione

Se non utilizzi una libreria generata, puoi scaricare la libreria client delle API di Google per Java e le relative dipendenze in un file ZIP oppure utilizzare Maven.

Consulta anche le istruzioni di configurazione di ProGuard che fanno parte della documentazione della libreria client HTTP di Google per Java.

Scaricare la libreria con le dipendenze

Scarica il file ZIP più recente, che puoi trovare nella pagina dei download, ed estrailo sul computer. Questo file ZIP contiene i file JAR delle classi della libreria client e i file JAR di origine associati per ogni artefatto e le relative dipendenze. Puoi trovare i grafici di dipendenza e le licenze per le diverse librerie nella cartella delle dipendenze. Per ulteriori dettagli sui contenuti del download, vedi il file readme.html.

Android

Se stai sviluppando per Android e l'API Google che vuoi utilizzare è inclusa nella libreria Google Play Services, utilizza la libreria Google Play Services per ottenere le migliori prestazioni e l'esperienza migliore.

Se utilizzi la libreria client dell'API di Google per Java con Android, è importante sapere quali dipendenze sono compatibili con Android, in particolare a quale livello di SDK Android. Le applicazioni Android richiedono i seguenti file JAR o versioni compatibili più recenti dalla cartella 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

Le applicazioni Google App Engine richiedono i seguenti file JAR o versioni compatibili più recenti dalla cartella 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

Le applicazioni servlet richiedono i seguenti file JAR o versioni compatibili più recenti dalla cartella 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 generico

Le applicazioni Java per uso generico richiedono i seguenti file jar o versioni compatibili più recenti dalla cartella 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

Librerie generate per le API di Google

Nel repository delle librerie generate sono riportate le istruzioni su come utilizzare ogni versione delle API.

Maven

La libreria client dell'API di Google per Java si trova nel Repository Maven centrale. Il valore groupId Maven per tutti gli elementi di questa raccolta è com.google.api-client. Di seguito sono riportate istruzioni Maven specifiche per ciascun modulo.

Moduli

Questa libreria è composta da nove moduli:

client-api-google

La libreria client delle API di Google per Java (google-api-client) è progettata per essere compatibile con tutte le piattaforme Java supportate, incluso Android.

Utilizzo di Maven:

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

Su Android, dovrai escludere esplicitamente le dipendenze inutilizzate:

<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

Le estensioni alla libreria client dell'API di Google per Java (google-api-client-android) supportano le applicazioni Java Google Android (solo per SDK >= 2.1). Questo modulo dipende da google-api-client e google-http-client-android.

Utilizzo di Maven:

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

google-api-client-servlet

Le estensioni Servlet e JDO alla libreria client dell'API di Google per Java (google-api-client-servlet) supportano le applicazioni web Java servlet. Questo modulo dipende da google-api-client e google-oauth-client-servlet.

Utilizzo di Maven:

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

google-api-client-appengine

Le estensioni Google App Engine della libreria client delle API di Google per Java (google-api-client-appengine) supportano le applicazioni Java Google App Engine. Questo modulo dipende da google-api-client, google-api-client-servlet, google-oauth-client-appengine e google-http-client-appengine.

Utilizzo di Maven:

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

google-api-client-gson

Estensioni GSON alla libreria client delle API di Google per Java (google-api-client-gson). Questo modulo dipende da google-api-client e google-http-client-gson.

Utilizzo di Maven:

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

google-api-client-jackson2

Estensioni Jackson2 alla libreria client dell'API di Google per Java (google-api-client-jackson2). Questo modulo dipende da google-api-client e google-http-client-jackson2.

Utilizzo di Maven:

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

google-api-client-protobuf

Estensioni Protocol Buffer per la libreria client delle API di Google per Java (google-api-client-protobuf). Questo modulo dipende da google-http-client-protobuf e google-api-client.

Utilizzo Maven:

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

google-api-client-xml

Estensioni XML alla libreria client delle API di Google per Java (google-api-client-xml). Questo modulo dipende da google-api-client e google-http-client-xml.

Utilizzo Maven:

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