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.

Weitere Informationen finden Sie in der ProGuard-Einrichtungsanleitung, die Teil der Dokumentation der Google HTTP-Clientbibliothek für Java ist.

Bibliothek mit Abhängigkeiten herunterladen

Laden Sie die neueste ZIP-Datei von der Downloadseite herunter und extrahieren Sie sie auf Ihrem Computer. Diese ZIP-Datei enthält die JAR-Dateien der Clientbibliotheksklasse und die zugehörigen JAR-Quelldateien für jedes Artefakt und seine Abhängigkeiten. Abhängigkeitsdiagramme und Lizenzen für die verschiedenen Bibliotheken finden Sie im Ordner „dependencies“. Weitere Informationen 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 Google Play-Dienstbibliothek enthalten ist, sollten Sie die Google Play-Dienstbibliothek verwenden, um die beste Leistung und Nutzerfreundlichkeit 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, und insbesondere welche Android SDK-Ebene. Für Android-Anwendungen sind die folgenden JAR-Dateien oder neuere 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

Warnung:Unter Android MÜSSEN Sie die JAR-Dateien in einem Verzeichnis mit dem Namen „libs“ ablegen, damit der APK-Objekt-Manager sie finden kann. Andernfalls erhalten Sie bei der Laufzeit einen NoClassDefFoundError-Fehler.

Google App Engine

Für Google App Engine-Anwendungen sind die folgenden JAR-Dateien oder neuere kompatible Versionen aus dem Ordner libs erforderlich:

• 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

Für Servlet-Anwendungen sind die folgenden JAR-Dateien oder neuere kompatible Versionen aus dem Ordner "libs" erforderlich:

• 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

Generic Java

Für Java-Anwendungen mit allgemeinem Zweck sind die folgenden JAR-Dateien oder neuere 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 eine Anleitung zur Verwendung der einzelnen Versionen der APIs.

Maven

Die Google API-Clientbibliothek für Java befindet sich im zentralen Maven-Repository. Die Maven-groupId für alle Artefakte dieser Bibliothek ist com.google.api-client. Für jedes Modul gibt es eine spezifische Maven-Anleitung (siehe unten).

Module

Diese Bibliothek besteht aus neun Modulen:

• google-api-client
• google-api-client-android
• google-api-client-appengine
• google-api-client-servlet
• google-api-client-gson
• google-api-client-jackson2
• google-api-client-protobuf
• google-api-client-xml

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-Verwendung:

<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-Anwendungen für Google Android (nur für SDK >= 2.1). Dieses Modul hängt von google-api-client und google-http-client-android ab.

Maven-Verwendung:

<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 für die Google API-Client-Bibliothek 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-Verwendung:

<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 für die 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 für die Clientbibliothek für Google APIs 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

Protocol Buffers-Erweiterungen für die 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 für die Clientbibliothek für Google APIs 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>