用戶端程式庫說明

如要使用 Google Cloud API,您可以直接向伺服器發出 HTTP 要求 (或在可用的情況下發出遠端程序呼叫 (RPC)),但我們針對所有 Cloud API 提供用戶端程式庫,方便您透過自己慣用的語言存取 API。本文件說明我們針對 Cloud API 提供的各種用戶端程式庫。如要進一步瞭解您的產品或所選語言可用的程式庫,請參閱該產品或語言的說明文件。

Google Cloud 用戶端程式庫

Google Cloud 用戶端程式庫採用我們最新的用戶端程式庫模型,且在可用的情況下,建議您使用這個選項,以程式輔助的方式存取 Cloud API。Cloud 用戶端程式庫具有下列特性:

  • 提供各種語言版本的慣用程式碼、系統產生程式碼或手動編寫程式碼,讓 Cloud API 簡單好用又符合直覺。
  • 可處理所有低層級的伺服器通訊細節,包括向 Google 驗證
  • 可使用 npmpip 等熟悉的套件管理工具安裝。
  • 在某些情況下可讓您使用 gRPC 以享有效能方面的優勢。詳情請參閱下方的 gRPC API 一節。

您可以在所選 Cloud API 的用戶端程式庫頁面查看適當 Cloud 用戶端程式庫的安裝指示和參考資料。

我們支援的語言幾乎全都有用戶端程式庫可下載,這個程式庫可為所有支援的 Cloud API 提供一個介面。您可以在 Cloud 用戶端程式庫頁面找到入門指南連結和相關參考文件。

Google API 用戶端程式庫

許多 Google Cloud API 目前只有部分語言版本的 Google Cloud 用戶端程式庫。如果您想使用其中一種 API,且該 API 沒有您慣用語言版本的 Cloud 用戶端程式庫,您仍然可使用稱為 Google API 用戶端程式庫的舊版用戶端程式庫。這類程式庫具有下列特性:

  • 只可用來存取 API 的 REST 介面,而不支援 gRPC。
  • 有自動產生的介面程式碼,但可能不如新版程式庫的程式碼符合慣例。
  • 可處理所有低層級的伺服器通訊細節,包括向 Google 驗證
  • 可使用 npmpip 等熟悉的套件管理工具安裝。

如有需要,您可以前往相關 Cloud API 的用戶端程式庫頁面找到這類程式庫的連結。

使用 Firebase 行動平台

Firebase 是各項 Google 服務通用的解決方案,可用來在行動裝置上建構應用程式。這個平台提供包含用戶端程式碼的 SDK,可讓您直接透過 iOS、Android 和網路應用程式存取行動相關 Cloud API。如要進一步瞭解支援的 Cloud API 和開始使用 Firebase 的方式,請參閱 Firebase 說明文件

使用您自己的用戶端程式碼

一般來說,建議您使用我們的用戶端程式庫存取 Cloud API。不過,如果您是經驗豐富的開發人員,而我們的用戶端程式庫無法滿足您的特定需求,您可以自行編寫自訂程式碼來直接存取服務的低階服務 API。

REST/HTTP API

所有 Cloud API 都提供簡單的傳統 JSON/REST 介面。如果您需要使用自選第三方 HTTP 用戶端程式庫,自行編寫自訂程式碼來直接存取 REST API,請參閱我們的 HTTP 規定,進一步瞭解 Cloud API 如何與不同 HTTP 版本和實作項目搭配運作。

gRPC API

gRPC 是各語言和平台通用的開放原始碼遠端程序呼叫 (RPC) 系統,最初是由 Google 開發:您可以前往 grpc.io 進一步瞭解 gRPC。支援 gRPC 的 Cloud API 通常同時具有 REST 和 RPC 介面,因此支援 gRPC 的 API 用戶端不只能使用 JSON 來透過 HTTP 與 REST 介面通訊,還可使用通訊協定緩衝區和 gRPC 來透過 HTTP2 與 RPC 介面通訊。如要瞭解 API 是否支援 gRPC,請參閱其「API 和參考資料」部分。

如果 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 倍。我們打算盡可能將所有 Cloud 用戶端程式庫升級至 gRPC;與此同時,您仍可享有我們的用戶端程式庫程式碼所帶來的所有其他好處。

其他 Cloud API 存取方式

如果您不想以程式輔助的方式存取 API,可使用 Google Cloud SDK 中的工具或透過 Google Cloud Platform 主控台存取相同的功能。

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud API