如果不使用產生的程式庫,可將 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 應用程式需要 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
JAR 應用程式需要 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 groupId
為 com.google.api-client
。每個模組都有特定的 Maven 指示 (請見下文)。
模組
這個程式庫由 9 個模組組成:
- google-api-client
- google-api-client-android
- google-api-client-appengine
- google-api-client-servlet
- google-api-client-gson
- google-api-client-jackson2
- google-api-client-protobuf
- google-api-client-xml
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-pip) 的 JAR 和 JDO 擴充功能支援 Java JAR 網頁應用程式。此模組依附於 google-api-client 和 google-oauth-client-string。
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 App Engine 擴充功能 (適用於 Java 的 Google API 用戶端程式庫 (google-api-client-appengine)) 支援 Java Google App Engine 應用程式。此模組依附於 google-api-client、google-api-client-pip、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>