開始使用

設定 Google Cloud 專案並設定驗證機制後，您就能從應用程式呼叫 Google Cloud API。本文將說明如何開始使用 Google Cloud API，包括建立專案、在 API 程式庫中探索及啟用服務、連結帳單帳戶、設定憑證，以及探索用戶端程式庫。

如果您是 Google Cloud新使用者，歡迎建立帳戶，親自體驗產品的實際應用成效。新客戶還可獲得價值 $300 美元的免費抵免額，用於執行、測試及部署工作負載。

建立 Google Cloud 專案

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

專案可擁有各種資源，包括 API 金鑰、OAuth 用戶端、服務帳戶、Compute Engine VM、Cloud Storage 值區和 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 的服務條款，並承擔相關費用。您必須具備專案的權限，才能啟用 API。serviceusage.services.enable 詳情請參閱「服務使用情形存取控管」。

此外，要啟用的服務必須是公開服務，否則服務擁有者必須授予使用者私人服務的 servicemanagement.services.bind 權限。詳情請參閱「服務管理存取控制」。

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

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

如要避免濫用及產生意外的計費費用，您可以在同一頁面停用專案的 API。您也可以使用 gcloud CLI 和 Service Usage API 啟用及停用 Cloud API：

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

正在啟用計費功能

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

如果沒有帳單帳戶，請前往Google Cloud 控制台帳單頁面，然後按照操作說明建立帳戶。然後將帳單帳戶連結至專案。

向 API 驗證

向 API 進行驗證的方法，取決於您的開發環境，以及 API 支援的驗證方法。

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

如要瞭解驗證的一般資訊，請參閱「Google 的驗證方式」。

建構應用程式

如果您要使用 Cloud API 建構應用程式，建議您盡可能使用Google Cloud 用戶端程式庫。用戶端程式庫可處理常見的 API 功能，例如驗證、錯誤處理、重試和酬載驗證，方便您使用。您需要在初始化期間將應用程式憑證傳遞至用戶端程式庫，這樣用戶端程式庫才能代表應用程式呼叫Google Cloud API。

請參閱下列逐步指南，瞭解如何使用熱門 API 的用戶端程式庫：

詳情請參閱「用戶端程式庫說明」。

更多資訊