雖然您可以直接向伺服器發出原始要求來使用 Google Cloud API,但用戶端程式庫提供簡化功能,可大幅減少您需要編寫的程式碼量。
本文說明與 Google Cloud API 互動的方法:
- Cloud 用戶端程式庫 (建議)
- Google API 用戶端程式庫
- Firebase 行動版
- 您自己的用戶端程式碼
如要尋找特定 Google Cloud 產品的用戶端程式庫資訊,請參閱該產品說明文件中的「用戶端程式庫」部分。如要查看所有 Cloud 用戶端程式庫 (通常會依支援的語言分類),請參閱「Cloud 用戶端程式庫」。
Cloud 用戶端程式庫
Cloud 用戶端程式庫是透過程式輔助方式存取 Cloud API 的建議選項 (如適用)。Cloud 用戶端程式庫採用最新的用戶端程式庫模型,並具有下列優點:
- 提供各種語言版本的慣用程式碼,讓 API 簡單好用又符合直覺。 Google Cloud
- 在用戶端程式庫中提供一致的樣式,簡化使用多個 Google Cloud 服務的工作。
- 可處理所有低層級的伺服器通訊細節,包括向 Google 驗證。
- 可使用
npm
和pip
等熟悉的套件管理工具安裝。 - 在某些情況下可讓您使用 gRPC 以享有效能方面的優勢。詳情請參閱 gRPC API。
Cloud 用戶端程式庫的安裝說明和參考資料取決於您使用的特定 Google Cloud API 和程式設計語言。如要瞭解這項資訊,請參閱特定產品的 Google Cloud 說明文件。大多數產品的說明文件中都有「用戶端程式庫」一節,提供特定語言的指南、安裝步驟,以及詳細 API 參考資料的連結。
如要查看特定產品的說明文件,請瀏覽 Google Cloud API 程式庫。
Google API 用戶端程式庫
如果特定 API 沒有您慣用語言版本的 Cloud 用戶端程式庫,可以使用 Google API 用戶端程式庫。這是 Google 提供的早期用戶端程式庫類型。
如果您要升級已使用這些程式庫的專案,也可以使用這些程式庫。這類程式庫具有下列特性:
- 只可用來存取 API 的 REST 介面,而不支援 gRPC。
- 介面程式碼是自動產生,可能不像 Cloud 用戶端程式庫那麼慣用。
- 可處理所有低層級的伺服器通訊細節,包括向 Google 驗證。
- 可使用
npm
和pip
等熟悉的套件管理工具安裝。
使用 Firebase 行動平台
Firebase 是各項 Google 服務通用的解決方案,可用來在行動裝置上建構應用程式。這個平台提供包含用戶端程式碼的 SDK,可讓您透過 iOS、Android 和網路應用程式存取行動相關 Google Cloud API。如要瞭解支援的 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 的 API 同時具有 REST 和 RPC 介面,因此啟用 gRPC 的 API 用戶端除了可透過 HTTP 使用 JSON 與 REST 介面通訊,也能透過 HTTP2 使用 通訊協定緩衝區和 gRPC 與 RPC 介面通訊。 Google Cloud 如要瞭解 API 是否支援 gRPC,請參閱其「API 和參考資料」部分。
如果 Google Cloud API 支援 gRPC,您就能使用支援 gRPC 的任何語言產生自己的 gRPC 用戶端程式庫。為此,您需要 API 的通訊協定緩衝區服務定義 (通常可從 GitHub 上的存放區取得)。
接著,您可以依 grpc.io 中與您慣用語言相關的指示操作,以產生及使用您的用戶端。
如果您不想產生自己的 gRPC 程式碼,也仍可受惠於 gRPC:針對支援 gRPC 的 API,有越來越多這類 API 的 Cloud 用戶端程式庫會「暗中」使用 gRPC 與 Google 的服務通訊。就輸送量和 CPU 使用率而言,這項做法的效率大幅提升。與 JSON REST API 相比,使用 gRPC 存取 API 時,每個 CPU 的輸送量最多可增加 10 倍。Google 計畫盡可能將所有 Cloud 用戶端程式庫升級至 gRPC;在此期間,您仍可享有 Google 用戶端程式庫程式碼的所有其他優勢。
其他 Cloud API 存取方式
如果您不想以程式輔助的方式存取 API,可使用 Google Cloud CLI 中的工具或透過 Google Cloud 控制台存取部分相同的功能。