用戶端程式庫可處理驗證和低層級伺服器通訊,讓您以程式輔助方式存取 Google Cloud API,並減少樣板程式碼。本文說明與Google Cloud API 互動的下列方法:
- Cloud 用戶端程式庫 (建議)
- Google API 用戶端程式庫
- Firebase 開發平台
- 您自己的用戶端程式碼
如要尋找特定 Google Cloud 產品的用戶端程式庫資訊,請參閱該產品說明文件中的用戶端程式庫部分。
Cloud 用戶端程式庫
雖然您可以直接向伺服器發出原始要求來使用 Google Cloud API,但 Cloud 用戶端程式庫提供簡化功能,可大幅減少需要編寫的程式碼數量。建議您使用 Cloud 用戶端程式庫,以程式輔助方式存取 Cloud API,因為這些程式庫採用最新的用戶端程式庫模型,且具備下列優點:
- 以每種語言提供慣用程式碼,讓 Google Cloud API 易於使用。
- 在用戶端程式庫中提供一致的樣式,簡化多項 Google Cloud 服務的使用方式。
- 處理所有低層級的伺服器通訊細節,包括向 Google 驗證。
- 可使用
npm和pip等熟悉的套件管理工具安裝。 - 在某些情況下,使用 gRPC 可提升效能。詳情請參閱「gRPC API」。
Cloud 用戶端程式庫的安裝說明和參考資料取決於您使用的特定 Google Cloud API 和程式設計語言。如要瞭解這項資訊,請參閱特定 Google Cloud 產品的說明文件。大多數產品的說明文件中都有「用戶端程式庫」一節,提供特定語言的指引、安裝步驟,以及詳細的 API 參考資料連結。
如要查看特定產品的說明文件,請瀏覽 Google Cloud API 程式庫。
Google API 用戶端程式庫
如果 Cloud 用戶端程式庫不支援您偏好的語言,您可以使用 Google API 用戶端程式庫。這是 Google 提供的早期用戶端程式庫類型。
如果您要升級已使用這些程式庫的專案,也可能會用到這些程式庫。這類程式庫具有下列特性:
- 僅提供 API 的 REST 介面存取權,不支援 gRPC。
- 自動產生的介面程式碼可能不如 Cloud 用戶端程式庫慣用。
- 處理所有低層級的伺服器通訊細節,包括向 Google 驗證。
- 可使用
npm和pip等熟悉的套件管理工具安裝。
使用 Firebase 開發平台
Firebase 是 Google 的服務平台,可支援整個應用程式開發生命週期。這項服務提供跨平台 SDK,協助您和 AI 代理程式建構及執行適用於 Apple 平台、Android、網頁、Flutter、Unity 和 C++ 的應用程式。
如要瞭解支援的 Google Cloud API 和如何開始使用 Firebase,請參閱 Firebase 說明文件。
使用自己的用戶端程式碼
如果您是經驗豐富的開發人員,且 Cloud 用戶端程式庫無法滿足特定需求,可以自行編寫自訂程式碼,直接存取服務的低階服務 API。
REST/HTTP API
所有 Google Cloud API 都會公開 JSON/REST 介面。如果您需要編寫自己的自訂程式碼,使用第三方程式庫 HTTP 用戶端程式庫直接存取 REST API,請參閱 HTTP 指南,進一步瞭解 API 如何搭配不同 HTTP 版本和實作方式運作。 Google Cloud
gRPC API
gRPC 是與語言和平台無關的開放原始碼遠端程序呼叫 (RPC) 系統,最初由 Google 開發。詳情請參閱 grpc.io。啟用 gRPC 的 Google Cloud API 通常同時具有 REST 和 RPC 介面,因此啟用 gRPC 的 API 用戶端除了能透過 HTTP 使用 JSON 與 REST 介面通訊,也能透過 HTTP2 使用 通訊協定緩衝區和 gRPC 與 RPC 介面通訊。如要確認 API 是否支援 gRPC,請查看 API 和參考資料部分。
如果 Google Cloud API 支援 gRPC,您可以用任何 gRPC 支援的語言,為該 API 產生自己的 gRPC 用戶端程式庫。為此,您需要 API 的通訊協定緩衝區服務定義 (通常可從 GitHub 上的存放區取得)。
接著,您可以依 grpc.io 中與您慣用語言相關的指示操作,產生及使用您的用戶端。
如果您不想自行產生 gRPC 程式碼,仍可享有 gRPC 的優點:越來越多適用於啟用 gRPC 的 API 的 Cloud Client Libraries,都使用 gRPC「在幕後」與 Google 的伺服器通訊。就處理量和 CPU 使用率而言,這項做法的效率大幅提升,與 JSON REST API 相比,使用 gRPC 存取 API 時,每個 CPU 的處理量最多可增加 10 倍。Google 計畫盡可能將所有 Cloud 用戶端程式庫升級至 gRPC;在此期間,您仍可享有 Google 用戶端程式庫程式碼的所有其他優勢。
其他 Cloud API 存取方式
如果您不想以程式輔助方式存取 API,可以使用 Google Cloud CLI 中的工具,或使用 Google Cloud 控制台,存取部分相同功能。