Istruzioni di configurazione

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

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

Scarica la libreria con dipendenze

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

Android

Se sviluppi per Android e l'API di Google che vuoi utilizzare è inclusa nella libreria di Google Play Services, utilizza quest'ultima per ottimizzare le prestazioni e l'esperienza.

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

Le applicazioni Google App Engine richiedono i seguenti file jar, o versioni compatibili più recenti, dalla cartella 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
  • transazione-api-1.1.jar
  • xpp3-1.1.4c.jar

Servlet

Le applicazioni Service richiedono i seguenti file jar, o versioni compatibili più recenti, dalla cartella 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
  • comuni-logging-1.2.jar
  • gson-2.9.0.jar
  • http://client-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
  • transazione-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.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
  • comuni-logging-1.2.jar
  • gson-2.9.0.jar
  • http://client-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

Il repository delle librerie generate contiene le istruzioni su come utilizzare ciascuna versione delle API.

Maven

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

Moduli

Questa libreria è composta da nove moduli:

client-api

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

Utilizzo Maven:

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

Su Android dovrai escludere esplicitamente le dipendenze non utilizzate:

<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

Le estensioni alla libreria client delle API di Google per le applicazioni 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 Maven:

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

google-api-client-servlet

Le estensioni Servlet e JDO alla libreria client delle 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 Maven:

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

google-api-client-appengine

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

Utilizzo Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-appengine</artifactId>
  <version>2.0.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 Maven:

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

google-api-client-jackson2

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

Utilizzo Maven:

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

google-api-client-java6

Estensioni Java 6 (e successive) alla libreria client delle API di Google per Java (google-api-client-java6). Questo modulo dipende da google-api-client e google-oauth-client-java6.

Utilizzo Maven:

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

google-api-client-protobuf

Estensioni buffer di protocollo alla 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.0.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.0.0</version>
</dependency>