设置说明

如果您不使用生成的库，可以下载 Java 版 Google API 客户端库及其依赖项的 ZIP 文件，也可以使用 Maven。

另请参阅 Google HTTP 客户端库（适用于 Java）文档中的 ProGuard 设置说明。

下载包含依赖项的库

下载最新的 ZIP 文件（可在下载页面上找到），并将其解压到您的计算机中。此 zip 文件包含每个工件及其依赖项的客户端库类 jar 文件以及关联的源 jar 文件。您可以在“dependencies”文件夹中找到不同库的依赖图和许可。如需详细了解下载内容，请参阅 readme.html 文件。

Android

如果您正在为 Android 开发应用，并且您要使用的 Google API 包含在 Google Play 服务库中，请使用 Google Play 服务库以获得最佳性能和体验。

如果您将 Java 版 Google API 客户端库与 Android 搭配使用，请务必了解哪些依赖项与 Android 兼容，尤其是哪个 Android SDK 级别。Android 应用需要 libs 文件夹中的以下 jar 文件或更高兼容版本：

  • 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 应用需要 libs 文件夹中的以下 jar 文件或更高兼容版本：

  • 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 应用需要 libs 文件夹中的以下 jar 文件或更高兼容版本：

  • 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

通用 Java 应用需要 libs 文件夹中的以下 jar 文件或更高兼容版本：

  • 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

为 Google API 生成的库

生成的库的代码库提供了有关如何使用各个版本 API 的说明。

Maven

适用于 Java 的 Google API 客户端库位于中央 Maven 代码库中。此库的所有工件的 Maven groupId 均为 com.google.api-client。下面针对每个模块提供了具体的 Maven 说明。

模块

此库由 9 个模块组成：

google-api-client

Java 版 Google API 客户端库 (google-api-client) 旨在与所有受支持的 Java 平台（包括 Android）兼容。

Maven 的用法：

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

在 Android 上，您需要明确排除未使用的依赖项：

<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

适用于 Java 的 Google API 客户端库 (google-api-client-android) 的扩展支持 Java Google Android（仅适用于 SDK 2.1 或更高版本）应用。此模块依赖于 google-api-client 和 google-http-client-android。

Maven 的用法：

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

google-api-client-servlet

Java 版 Google API 客户端库 (google-api-client-servlet) 的 Servlet 和 JDO 扩展支持 Java servlet Web 应用。此模块依赖于 google-api-client 和 google-oauth-client-servlet。

Maven 用法：

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

google-api-client-appengine

适用于 Java 的 Google API 客户端库 (google-api-client-appengine) 的 Google App Engine 扩展支持 Java Google App Engine 应用。此模块依赖于 google-api-client、google-api-client-servlet、google-oauth-client-appengine 和 google-http-client-appengine。

Maven 用法：

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

google-api-client-gson

适用于 Java 的 Google API 客户端库 (google-api-client-gson) 的 GSON 扩展。此模块依赖于 google-api-client 和 google-http-client-gson。

Maven 用法：

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

google-api-client-jackson2

适用于 Java 的 Google API 客户端库 (google-api-client-jackson2) 的 Jackson2 扩展。此模块依赖于 google-api-client 和 google-http-client-jackson2。

Maven 用法：

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

google-api-client-protobuf

适用于 Java 的 Google API 客户端库 (google-api-client-protobuf) 的 Protocol Buffer 扩展。此模块依赖于 google-http-client-protobuf 和 google-api-client。

Maven 用法：

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

google-api-client-xml

适用于 Java 的 Google API 客户端库 (google-api-client-xml) 的 XML 扩展。此模块依赖于 google-api-client 和 google-http-client-xml。

Maven 的用法：

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