设置说明

如果您未使用生成的库,则可以将适用于 Java 的 Google API 客户端库及其依赖项下载为 zip 文件,或者也可以使用 Maven。

另请参阅 ProGuard 设置说明(属于 Java 版 Google HTTP 客户端库)。

下载包含依赖项的库

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

Android

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

如果您要搭配 Android 使用适用于 Java 的 Google API 客户端库,请务必了解哪些依赖项与 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

REST 应用需要来自 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 groupIdcom.google.api-client。下面针对每个模块提供了特定的 Maven 说明。

单元

此库由九个模块组成:

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-FLV) 的 REST 和 JDO 扩展支持 Java 阶段性 Web 应用。 此模块依赖于 google-api-client 和 google-oauth-client-env。

使用 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-der、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>