Anleitung für die Einrichtung

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

Weitere Informationen finden Sie in der Anleitung zur Einrichtung von ProGuard in der Dokumentation zur Google-HTTP-Clientbibliothek für Java.

Bibliothek mit Abhängigkeiten herunterladen

Laden Sie auf der Downloadseite die aktuelle ZIP-Datei herunter und entpacken 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. Im Ordner „Abhängigkeiten“ finden Sie Abhängigkeitsdiagramme und Lizenzen für die verschiedenen Bibliotheken. Weitere Informationen zum Inhalt des Downloads finden Sie in der Datei readme.html.

Android

Wenn Sie für Android entwickeln und die Google API, die Sie verwenden möchten, in der Bibliothek der Google Play-Dienste enthalten ist, verwenden Sie die Bibliothek der Google Play-Dienste, um eine optimale Leistung und Erfahrung 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

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

Generische Java

Java-Anwendungen für allgemeine Zwecke benötigen die folgenden JAR-Dateien oder neuere kompatible Versionen aus dem libs-Ordner:

  • 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

Bibliotheken für Google APIs generiert

Das Repository der generierten Bibliotheken enthält eine Anleitung 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 gibt es eine spezifische Maven-Anleitung (siehe unten).

Module

Diese Bibliothek besteht aus neun Modulen:

google-api-client

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

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 Google Android-Anwendungen (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

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

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

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

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

google-api-client-protobuf

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

Maven-Verwendung:

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

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