设置说明

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

另请参阅 ProGuard 设置说明，它们是 Google HTTP 客户端库（Java 版）文档的一部分。

下载包含依赖项的库

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

Android

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

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

  • google-api-client-2.0.0.jar
  • google-api-client-android-2.0.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.0.0.jar
  • google-api-client-appengine-2.0.0.jar
  • google-api-client-servlet-2.0.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.0.0.jar
  • google-api-client-servlet-2.0.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.0.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 说明（见下文）。

模块

此库由九个模块组成：

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.0.0</version>
</dependency>

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

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client</artifactId>
  <version>2.0.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.0.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.0.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.0.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.0.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.0.0</version>
</dependency>

google-api-client-java6

Java 版 Google API 客户端库 (google-api-client-java6) 的 Java 6（及更高版本）扩展。 此模块依赖于 google-api-client 和 google-oauth-client-java6。

Maven 用法：

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-java6</artifactId>
  <version>2.0.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.0.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.0.0</version>
</dependency>