查看設定操作說明

如果您未使用產生的程式庫，可以下載適用於 Java 的 Google API 用戶端程式庫及其相依項目的 ZIP 檔案，也可以使用 Maven。

另請參閱 Java 專用 Google HTTP 用戶端程式庫說明文件中的 ProGuard 設定操作說明。

下載具有依附元件的程式庫

請下載最新的 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.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 應用程式需要下列 jar 檔案或相容的較新版本，這些檔案位於 libs 資料夾中：

  • 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 應用程式需要下列 jar 檔案或相容的較新版本，這些檔案位於 libs 資料夾中：

  • 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 應用程式需要下列 jar 檔案或較新的相容版本，這些檔案位於 libs 資料夾中：

  • 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 指示 (如下所示)。

模組

這個程式庫是由九個模組所組成：

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

Google API 用戶端程式庫 (Java 適用) (google-api-client-servlet) 的 Servlet 和 JDO 擴充功能支援 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

Google API 用戶端程式庫 (Java 適用) 的 Google App Engine 擴充功能 (google-api-client-appengine) 支援 Java Google App Engine 應用程式。此模組依附於 google-api-client、google-api-client-runtime、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

Google API 用戶端程式庫 (Google API Client Library for Java，簡稱 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

Jackson2 擴充功能，適用於 Java 的 Google API 用戶端程式庫 (google-api-client-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

Google API 用戶端程式庫 (Google API Client Library for Java，簡稱 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>