開始使用

本頁說明開發人員如何開始使用 Google Cloud API。

如果您是 Google Cloud 第一次使用 API，可以按照本指南的步驟，使用 curl 指令呼叫 API。您可以在開發應用程式前，使用 curl 指令試用 API。

如果您未曾使用過 Google Cloud，歡迎建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還可獲得價值 $300 美元的免費抵免額，用於執行、測試及部署工作負載。

建立 Google 專案

如要使用 Google Cloud API，您必須擁有使用者帳戶 (Google 帳戶或外部身分識別提供者的帳戶) 和Google 專案。專案等同於開發人員帳戶。做為 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 預設為啟用。如要使用預設未啟用的 API，您必須為專案啟用該 API。 Google Cloud視應用程式涉及的服務和專案 (包括用戶端專案和資源專案) 而定，您可能需要為多個專案啟用 API。啟用相依於其他 API 的 API 時，這些 API 也會一併啟用。

啟用 API 時，您必須接受該 API 的服務條款，並承擔相關費用。您必須具備專案的 serviceusage.services.enable 權限，才能啟用 API。詳情請參閱「服務用量存取權控管」。

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

如要使用主控台為專案啟用 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 使用費會向與該專案相關聯的帳單帳戶收取。

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

通過 API 驗證

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

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

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

建構應用程式

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

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

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

更多資訊