開始使用

設定 Google Cloud 專案並設定驗證機制,即可從應用程式呼叫 Google Cloud API。在本文件中,您將建立專案、在 API 程式庫中探索及啟用服務、連結帳單帳戶、設定憑證,以及探索用戶端程式庫,開始使用 Google Cloud API。

建立 Google Cloud 專案

如要使用 Google Cloud API,您必須擁有使用者帳戶 (Google 帳戶或外部身分提供者帳戶) 和Google Cloud 專案。專案等同於開發人員帳戶。可做為 Google Cloud 資源的資源容器。此外,專案也為您使用的 Google Cloud 服務提供隔離邊界,讓您可以在專案層級獨立管理配額限制和帳單。用量遙測和資訊主頁也會依專案分組。如果尚未建立專案,可以使用 Google Cloud 控制台建立。

專案可以擁有多種資源,包括 API 金鑰、OAuth 用戶端、服務帳戶、Compute Engine VM、Cloud Storage bucket 和 BigQuery 資料集。當應用程式呼叫 Google Cloud API 時,擁有應用程式憑證的專案稱為「用戶端專案」,擁有目標資源的專案則稱為「資源專案」。部分 API 要求可能會涉及多項資源,在這種情況下,要求中可能會涉及多個資源專案。

如果因故想停止使用 Google Cloud ,可以透過Google Cloud 控制台刪除專案。保留期過後,專案和專案中的所有資源都會刪除。請注意,不同類型的資料有不同的保留期限。

探索 API

使用任何 Google Cloud API 之前,請先前往 Google Cloud 控制台的 API 程式庫,瀏覽可用的Google Cloud API,找出最符合業務需求的 API。

正在啟用 API

部分 Google Cloud API 預設為啟用。如要使用預設未啟用的 Google Cloud API,您必須為專案啟用該 API。視應用程式涉及的服務和專案 (包括用戶端專案和資源專案) 而定,您可能需要為多項專案啟用 API。啟用依附於其他 API 的 API 時,系統也會一併啟用這些 API。

啟用 API 時,您必須接受 API 的《服務條款》和帳單責任。您必須具備專案的 serviceusage.services.enable 權限,才能啟用 API。

如要透過控制台為專案啟用 API,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台 API 程式庫。
  2. 從專案清單中,選取要使用的專案。
  3. 在 API 程式庫中,選取您要啟用的 API。如需協助尋找 API,請使用搜尋欄位和篩選器。
  4. 在 API 頁面中,按一下 [ENABLE] (啟用)。

如果不再使用某個 API,您可以在同一個頁面停用該 API,以免遭到濫用及產生意外費用。您也可以使用 gcloud CLI 和 Service Usage API 啟用及停用 Cloud API:

gcloud services enable pubsub.googleapis.com
gcloud services disable pubsub.googleapis.com

正在啟用計費功能

部分 Cloud API 會依用量收費。您必須先為專案啟用計費功能,才能在專案中使用這些 API。專案中的 API 使用費會向與專案相關聯的帳單帳戶收取。

向 API 驗證

向 API 驗證的方法,取決於開發環境和 API 支援的驗證方式。

最常見的做法是設定應用程式預設憑證,以便在各種環境中使用,這也是大多數應用程式的建議做法。如果 API 支援 API 金鑰,則可做為另一種選擇。如果應用程式需要存取使用者擁有的 Cloud 資源,請建立 OAuth 2.0 用戶端 ID 並使用驗證程式庫。

如需驗證的一般資訊,請參閱「Google 的驗證方式」。

建構應用程式

如果您使用 Cloud API 建構應用程式,建議您使用 Google Cloud 用戶端程式庫 (如有)。用戶端程式庫可處理常見的 API 功能,例如驗證、錯誤處理、重試和酬載驗證,您必須在初始化期間將應用程式憑證傳遞至用戶端程式庫,用戶端程式庫才能代表應用程式呼叫Google Cloud API。

更多資訊