在開始編寫第一個 Cloud Billing 預算應用程式之前,您必須先完成幾件事。
在 Google Cloud 控制台試用 Cloud Billing 功能
這份 API 說明文件假設您先前使用過 Google Cloud,也熟悉 Google Cloud 控制台中的 Cloud Billing 功能和概念。如果您不熟悉 Cloud Billing 帳戶、 Google Cloud 專案、 Google Cloud產品,以及 Cloud Billing 預算和快訊等概念,請先閱讀下列內容,再開始編寫程式碼:
- Cloud Billing 概念總覽
- 管理 Cloud Billing 帳戶
- 查看連結至 Cloud Billing 帳戶的專案
- 預算和預算快訊規則總覽
- 管理支出上限預算
- Cloud Billing Budget API 的存取控管
熟悉 Cloud Billing 功能和概念後,請試用 Google Cloud 控制台使用者介面。
Cloud Billing 重要概念
- 每個 Cloud Billing 帳戶一次可連結數千個預算。如要瞭解目前的限制和更多資訊,請參閱「配額與限制」。
- 預算一次只能連結一個 Cloud Billing 帳戶。
- 單一 Cloud Billing 帳戶可連結至一或多個Google Cloud 專案,並支付相關費用。
- Google Cloud 專案一次只能連結一個 Cloud Billing 帳戶。
- 您可以建立無支出上限的預算,監控整個 Cloud Billing 帳戶的費用,包括由該帳單帳戶支付的所有 Google Cloud 專案。您也可以使用精細的預算篩選器,定義無支出上限預算的範圍,監控特定部分的費用。篩選條件包括 Google Cloud 專案、服務、預算的時間範圍,以及適用於 Cloud Billing 帳戶的其他篩選條件。
- 您可以建立支出上限預算,限制指定 Google Cloud 專案中符合資格服務的支出。強制執行支出上限後,指定專案中的服務會暫停使用,直到支出上限解除為止。
瞭解 REST 的基本概念
您可以透過下列兩種方式叫用 Cloud Billing Budget API:
- 傳送 HTTP 要求並剖析回應。
- 使用用戶端程式庫 (建議做法)。
如果您決定不使用用戶端程式庫,則必須瞭解 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 物件 Notation) 是一種與語言無關的常用資料格式,可透過簡單的文字方式來表示任意資料結構。詳情請參閱 json.org。