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 utilizzare Maven.

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

Scarica la libreria con 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 relative 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 stai sviluppando per Android e l'API di Google che vuoi utilizzare è inclusa nella libreria Google Play Services, utilizzala per avere 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 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.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 di 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
  • 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.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
  • 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.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
  • 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 contiene 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 valore groupId di Maven per tutti gli artefatti di questa libreria è com.google.api-client. Per ogni modulo sono disponibili istruzioni specifiche per Maven (di seguito).

Moduli

Questa libreria è composta da nove moduli:

google-api-client

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

Utilizzo di Maven:

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

Su Android, devi escludere esplicitamente le dipendenze inutilizzate:

<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 della libreria client delle 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.0.0</version>
</dependency>

google-api-client-servlet

Le estensioni servlet e JDO della 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 di 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 App Engine Java. 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.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 di 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 di 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 dell'API di Google per Java (google-api-client-java6). Questo modulo dipende da google-api-client e google-oauth-client-java6.

Utilizzo di 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 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 di 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 di Maven:

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