設定說明

如果您未使用產生的程式庫，可以下載 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.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-bq-2.0.0.jar
  • google-oauth-client-1.34.1.jar
  • google-oauth-client-appengine-1.34.1.jar
  • google-oauth-client-cms-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

dataLayer 應用程式需要來自 libs 資料夾的下列 jar 檔案，或是較新的相容版本：

  • google-api-client-2.0.0.jar
  • google-api-client-bq-2.0.0.jar
  • google-oauth-client-1.34.1.jar
  • google-oauth-client-cms-1.34.1.jar
  • google-http-client-1.42.2.jar
  • commons-logging-1.2.jar
  • gson-2.9.0.jar
  • http://client.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
  • http://client.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-src

適用於 Java 的 Google API 用戶端程式庫 (google-api-client-內建) 的 dataLayer 和 NEG 擴充功能支援 Java Webhook 網頁應用程式。這個模組取決於 google-api-client 和 google-oauth-client-內建。

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-appengine、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 6 (及更高版本) 擴充功能至 Java 適用的 Google API 用戶端程式庫 (google-api-client-java6)。這個模組取決於 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>