Google Cloud API 是程式輔助介面,可讓您將運算、網路、儲存空間和機器學習服務整合至應用程式。您可以透過 JSON HTTP 或 gRPC 端點呼叫這些網路 API,通常是使用用戶端程式庫或 Google Cloud CLI 等工具。
關於 Cloud API
Cloud API 會以網路 API 服務的形式提供給客戶,例如 Cloud Pub/Sub API。每個 Cloud API 通常會在 googleapis.com 的一或多個子網域上執行,例如 pubsub.googleapis.com,並透過公用網際網路和虛擬私有雲 (VPC) 網路,為用戶端提供 JSON HTTP 和 gRPC 介面。用戶端可以直接或透過用戶端程式庫,將 HTTP 和 gRPC 要求傳送至 Cloud API 端點。
Cloud API 屬於 Google Cloud 控制台API 程式庫中的 Google Enterprise API 類別。
Google Cloud API 有兩種:
依資源計算的 API:這類 API 會使用與所存取資源相關聯的專案,做為計費和配額依據。
用戶端 API:使用與用戶端相關聯的專案,存取資源以進行計費和配額。
存取 Cloud API
您可以透過多種常用程式設計語言的用戶端程式庫,從伺服器應用程式存取 Cloud API,也可以透過 Firebase SDK 或使用第三方用戶端,從行動應用程式存取 Cloud API。您也可以透過 Google Cloud CLI、Google Cloud 控制台或 Google Cloud MCP 伺服器存取 Cloud API。
如果您是 Cloud API 新手,請參閱「開始使用」一文,瞭解如何使用 Cloud API。
支援 HTTP 和 gRPC
所有 Cloud API 都提供簡單的 JSON HTTP 介面,可讓您直接呼叫或透過 Google API 用戶端程式庫呼叫。大多數 Cloud API 也提供 gRPC 介面,可透過 Google Cloud 用戶端程式庫呼叫,提供更佳的效能和可用性。您也可以使用第三方用戶端。
如要進一步瞭解用戶端程式庫,請參閱「用戶端程式庫說明」。
如要進一步瞭解如何驗證以使用 Google API,請參閱「Google 的驗證方式」和「進行驗證以使用用戶端程式庫」。
傳輸層安全標準 (TLS) 加密
所有 Cloud API 都只接受使用 TLS 加密的安全要求。
- 如果您使用我們的用戶端程式庫,程式庫會為您處理傳輸中加密。
- 如果您使用自己的 gRPC 用戶端,則必須按照 gRPC 驗證指南中的操作說明,向 Google 進行驗證 (需要 TLS)。
- 如果您要建立自己的 HTTP 用戶端,請參閱 HTTP 指南。
如要進一步瞭解 Google Cloud 服務的流量如何受到保護,請參閱傳輸中資料加密安全性指南。
Private Service Connect
基於安全性和法規遵循考量,企業客戶通常希望以私密方式存取 Cloud API。您可以使用 Private Service Connect,在虛擬私有雲網路中設定及管理這類存取權。
詳情請參閱「設定 Private Service Connect」。
逐步範例
請參閱下列逐步指南,瞭解如何使用熱門 API 的用戶端程式庫:
- 搭配使用 Cloud Billing Budget API 與 Node.js。
- 使用 Python 存取 Cloud Billing Budget API。
- 使用 Node.js 進行 Cloud Logging。
- 搭配使用 Cloud Logging 和 Python。
- 搭配使用 Cloud Logging 和 Go。
- Cloud Logging with Java。
- 搭配使用 Speech-to-Text 與 Node.js。
- 搭配使用 Speech-to-Text 與 Python。
- 搭配使用 Speech-to-Text 與 Go。
- 搭配 Java 使用 Speech-to-Text。
API 設計指南
無論介面類型為何,所有 Cloud API 都採用資源導向的設計原則,詳情請參閱 API 設計指南。這可確保 Cloud API 提供簡單一致的開發人員體驗。您可以參閱 API 設計指南,進一步瞭解 Cloud API。
如要研究 Cloud API 的介面定義,可以前往 GitHub 上的 Google APIs 存放區。
設定用量上限
數百萬名開發人員和使用者共用 Cloud API。為確保公平使用並盡可能降低濫用風險,所有 Cloud API 都會對用量實施頻率限制和資源配額,通常稱為配額。您也可以減少配額上限,藉此控管 Google Cloud 產品的支出。如果需要的配額超過預設上限,請提出配額提高要求。
詳情請參閱「限制 API 用量」一文。
監控您的使用情況
大部分的 Cloud API 都可針對專案使用的 API 提供相關詳細資訊,包括流量等級、錯誤率和延遲時間。可協助您快速將使用 Cloud API 的應用程式所發生的問題分類。您可以在 Google Cloud 控制台的 Google Cloud API 資訊主頁中查看這項資訊。您也可以在 Cloud Monitoring 中建立自訂資訊主頁和警告。
詳情請參閱「監控 API 用量」。
Google Enterprise API
Google Enterprise API 穩定性高,適用於各項企業用途,並提供支援選項。
詳情請參閱「Google Enterprise API」。