Anleitung für die Einrichtung

Wenn Sie keine generierte Bibliothek verwenden, können Sie die Google API-Clientbibliothek für Java und die zugehörigen Abhängigkeiten in einer ZIP-Datei herunterladen oder Maven verwenden.

Lesen Sie auch die Anleitung zur Einrichtung von ProGuard, die Teil der Dokumentation zur Google-HTTP-Clientbibliothek für Java ist.

Bibliothek mit Abhängigkeiten herunterladen

Laden Sie die aktuelle ZIP-Datei, die Sie auf der Downloadseite finden, herunter und entpacken Sie sie auf Ihrem Computer. Diese ZIP-Datei enthält die JAR-Dateien der Clientbibliotheksklasse sowie die zugehörigen JAR-Quelldateien für jedes Artefakt und seine Abhängigkeiten. Sie finden Abhängigkeitsdiagramme und Lizenzen für die verschiedenen Bibliotheken im Abhängigkeiten-Ordner. Weitere Details zum Inhalt des Downloads finden Sie in der Datei readme.html.

Android

Wenn Sie für Android entwickeln und die gewünschte Google API in der Bibliothek der Google Play-Dienste enthalten ist, verwenden Sie die Bibliothek der Google Play-Dienste, um eine optimale Leistung und Nutzererfahrung zu erzielen.

Wenn Sie die Google API-Clientbibliothek für Java mit Android verwenden, ist es wichtig zu wissen, welche Abhängigkeiten mit Android kompatibel sind, insbesondere welche Android SDK-Ebene. Für Android-Anwendungen sind die folgenden JAR-Dateien oder neue kompatible Versionen aus dem Ordner „libs“ erforderlich:

  • 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

Google App Engine-Anwendungen benötigen die folgenden JAR-Dateien oder neue kompatible Versionen aus dem Ordner „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

Servlet-Anwendungen benötigen die folgenden JAR-Dateien oder neuere kompatible Versionen aus dem Ordner 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

Generisches Java

Für Java-Anwendungen für allgemeine Zwecke sind die folgenden JAR-Dateien oder neue kompatible Versionen aus dem Ordner „libs“ erforderlich:

  • 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

Generierte Bibliotheken für Google APIs

Im Repository der generierten Bibliotheken finden Sie Anleitungen zur Verwendung der einzelnen API-Versionen.

Maven

Die Google API-Clientbibliothek für Java befindet sich im zentralen Maven-Repository. Die Maven-groupId für alle Artefakte für diese Bibliothek ist com.google.api-client. Für jedes Modul finden Sie eine spezielle Anleitung zu Maven (unten).

Module

Diese Bibliothek besteht aus neun Modulen:

google-api-client

Die Google API-Clientbibliothek für Java (google-api-client) ist mit allen unterstützten Java-Plattformen kompatibel, einschließlich Android.

Maven-Nutzung:

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

Unter Android müssen Sie nicht verwendete Abhängigkeiten explizit ausschließen:

<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

Erweiterungen der Google API-Clientbibliothek für Java (google-api-client-android) unterstützen Java Google Android-Anwendungen (nur für SDK >= 2.1). Dieses Modul hängt von google-api-client und google-http-client-android ab.

Maven-Nutzung:

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

google-api-client-servlet

Servlet- und JDO-Erweiterungen der Google API-Clientbibliothek für Java (google-api-client-Servlet) unterstützen Java-Servlet-Webanwendungen. Dieses Modul hängt von google-api-client und google-oauth-client-Servlet ab.

Maven-Nutzung:

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

google-api-client-appengine

Google App Engine-Erweiterungen der Google API-Clientbibliothek für Java (google-api-client-appengine) unterstützen Java Google App Engine-Anwendungen. Dieses Modul hängt von google-api-client, google-api-client-Servlet, google-oauth-client-appengine und google-http-client-appengine ab.

Maven-Nutzung:

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

google-api-client-gson

GSON-Erweiterungen der Google API-Clientbibliothek für Java (google-api-client-gson) Dieses Modul hängt von google-api-client und google-http-client-gson ab.

Maven-Nutzung:

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

google-api-client-jackson2

Jackson2-Erweiterungen zur Google API-Clientbibliothek für Java (google-api-client-jackson2). Dieses Modul hängt von google-api-client und google-http-client-jackson2 ab.

Maven-Nutzung:

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

google-api-client-protobuf

Protokollzwischenspeicher-Erweiterungen zur Google API-Clientbibliothek für Java (google-api-client-protobuf). Dieses Modul hängt von google-http-client-protobuf und google-api-client ab.

Maven-Nutzung:

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

google-api-client-xml

XML-Erweiterungen der Google API-Clientbibliothek für Java (google-api-client-xml) Dieses Modul hängt von google-api-client und google-http-client-xml ab.

Maven-Nutzung:

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