開始使用

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

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

建立 Google 帳戶

如要在應用程式中使用 Google Cloud API，您必須先擁有 Google 帳戶。這樣您就能使用 Google 開發人員產品，包括 Google Cloud 控制台、 gcloud CLI、Cloud Logging 和 Cloud Monitoring。如果您未曾使用過 Google Cloud，歡迎建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還可獲得價值 $300 美元的免費抵免額，用於執行、測試及部署工作負載。

建立 Google 專案

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

專案可擁有各種資源，包括 API 金鑰、OAuth 用戶端、服務帳戶、Compute Engine VM、Cloud Storage 值區和 BigQuery 資料集。應用程式呼叫 Cloud API 時，擁有應用程式憑證的專案稱為用戶端專案，擁有目標資源的專案則稱為資源專案。一個 API 要求可能會觸及多個資源，因此會涉及多個資源專案。

如要停止使用 Google Cloud，請前往 Google Cloud 控制台刪除專案。保留期限過後，系統會刪除專案和專案中的所有資源。請注意，不同類型的資料有不同的保留期限。

探索 API

使用任何 Cloud API 之前，請先使用 Google Cloud 控制台 API 程式庫瀏覽可用的 Cloud API，找出最符合您業務需求的 API。如要進一步瞭解特定 Cloud API，請前往公開說明文件網站，例如 Spanner API。

啟用 API

部分 Cloud API 預設為啟用。如要使用預設未啟用的 Cloud API，必須為專案啟用該 API。視應用程式涉及的服務和專案而定 (包括用戶端專案和資源專案)，您可能需要為多個專案啟用 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 的用戶端程式庫：

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

更多資訊