Istruzioni di configurazione

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

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

Scarica 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 della classe della libreria client e i file jar di origine associati per ogni artefatto e le sue dipendenze. Puoi trovare i grafici e le licenze delle dipendenze per le diverse librerie nella cartella delle dipendenze. Per ulteriori informazioni sui contenuti del download, vedi il file readme.html.

Android

Se stai sviluppando per Android e l'API di Google che vuoi utilizzare è inclusa nella libreria Google Play Services, utilizzala per ottenere prestazioni ed esperienza ottimali.

Se utilizzi la libreria client delle 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

Il repository delle librerie generate include istruzioni su come utilizzare ogni versione delle API.

Maven

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

Moduli

Questa libreria è composta da nove moduli:

google-api-client

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

Utilizzo 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 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 delle API di Google per Java (google-api-client-servlet) supportano le applicazioni web servlet Java. 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.4.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 Java di 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.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 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 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 del 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.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>