Cloud Billing Budget API 先決條件

在開始設計第一個 Cloud Billing 預算應用程式之前,您必須先做以下幾件事。

在 Google Cloud 控制台中試用 Cloud Billing 功能

這份 API 說明文件假設您先前使用過 Google Cloud,也熟悉 Google Cloud 控制台的 Cloud Billing 功能和概念。如果您還不熟悉 Cloud Billing 帳戶、 Google Cloud 專案、 Google Cloud 產品,以及 Cloud Billing 預算和快訊等概念,請先閱讀下列內容, 再開始編寫程式碼:

熟悉 Cloud Billing 的功能和概念後,請試用Google Cloud 控制台使用者介面。

Cloud Billing 重要概念

  • 每個 Cloud Billing 帳戶一次最多可連結數千個預算。如要瞭解目前的限制和其他資訊,請參閱「配額與限制」。
  • 預算一次只能連結至一個 Cloud Billing 帳戶。
  • 單一 Cloud Billing 帳戶會連結至一或多個專案,並支付相關費用。Google Cloud
  • 一個 Google Cloud 專案一次只能連結一個 Cloud Billing 帳戶。
  • 您可以建立僅限警告的預算,監控整個 Cloud Billing 帳戶的費用,包括該帳單帳戶支付的所有 Google Cloud 專案費用。您也可以使用精細的預算篩選器,定義僅限快訊的預算範圍,監控特定費用的切片。篩選條件包括專案、服務、預算的時間範圍,以及適用於 Cloud Billing 帳戶的其他篩選條件。 Google Cloud
  • 您可以建立支出上限預算,為指定 Google Cloud 專案中符合資格的服務設定支出上限。強制執行支出上限後,指定專案中服務的新用量會暫停,直到解除支出上限為止。

瞭解 REST 的基本概念

您可以透過下列 2 種方式叫用 Cloud Billing Budget API:

如果您決定不使用用戶端程式庫,則必須瞭解 REST 的基本概念。

REST 是一種軟體架構,可提供簡便且一致的資料要求及修改方法。

REST 這個詞是「Representational State Transfer (表現層狀態轉換)」的簡稱。在 Google API 中,這是指使用 HTTP 動詞來擷取及修改 Google 所儲存資料的表示法。

在符合 REST 樣式的系統中,資源會儲存在資料儲存庫中。用戶端向伺服器發出執行特定動作 (例如建立、擷取、更新或刪除資源) 的要求後,伺服器就會執行指定動作並傳回回應 (大多採用指定資源表示法的形式)。

在具備 REST 特性的各種 Google API 中,用戶端會使用 POST、GET、PUT 或 DELETE 等 HTTP 動詞來指定動作。接著,該動詞會透過全域唯一的 URI 來指定資源,格式如下:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

由於所有 API 資源都有可供 HTTP 存取的專屬 URI,因此 REST 不僅能夠支援資料快取,也非常適合與網路的分散式基礎架構搭配運作。

您可以在 HTTP 1.1 標準說明文件中找到相當實用的方法定義,其中包括 GET、POST、PUT 及 DELETE 的規格說明。

Cloud Billing Budget API 中的 REST

Cloud Billing Budget API 作業會直接對應至 REST HTTP 動詞。

Cloud Billing Budget API URI 的特定格式如下:

https://billingbudgets.googleapis.com/v1/resourcePath?parameters

如需 API 中各個支援的作業使用的完整 URI 組合摘要資訊,請參閱 Cloud Billing Budget API REST 參考文件。

瞭解 JSON 的基本概念

Cloud Billing Budget API 會以 JSON 格式傳回資料。

JSON (JavaScript 物件標記法) 是一種與語言無關的常用資料格式,可透過簡單的文字方式來表示任意資料結構。詳情請參閱 json.org。