设置说明

如果您没有使用生成的库，则 可以下载适用于 Java 的 Google API 客户端库及其依赖项， zip 文件，您也可以使用 Maven。

另请参阅 Google HTTP 客户端库 for Java 文档中的 ProGuard 设置说明。

下载包含依赖项的库

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

Android

如果您是针对 Android 进行开发，并且 Google Play 服务库中包含您要使用的 Google API，请使用 Google Play 服务库以获得最佳性能和体验。

如果您要将适用于 Android 的 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
  • 通用日志记录-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
  • 通用日志记录-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 客户端库的 Servlet 和 JDO 扩展 (google-api-client-servlet) 支持 Java servlet 网络应用。 此模块依赖于 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) 的扩展。 此模块依赖于 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>