Cloud Billing Budget API 的前提条件

如果您尚未完成准备工作,请先完成,然后再开始编写您的第一个 Cloud Billing 预算应用。

在 Google Cloud Console 中试用 Cloud Billing 功能

此 API 文档假定您使用过 Google Cloud,并且您熟悉 Google Cloud Console 中的 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 项目。您还可以使用精细预算过滤条件来定义预算的范围,以监控特定费用切片。过滤条件包括 Google Cloud 项目、服务、预算时间段和适用于 Cloud Billing 账号的其他过滤条件。

了解 REST 基础知识

您可以通过以下两种方式调用 Cloud Billing Budget API:

  • 发送 HTTP 请求并解析响应。
  • 使用客户端库(推荐)。

如果您不打算使用客户端库,则需要了解 REST 的基础知识。

REST 是一种软件架构样式,可提供便捷且一致的方法用于请求和修改数据。

术语 REST 是“具象状态传输”的简称。在 Google API 的上下文中,指的是使用 HTTP 谓词来检索和修改由 Google 存储的数据的表示法。

在 RESTful 系统中,资源存储在数据存储区中;在客户端发送要求服务器执行特定操作(例如创建、检索、更新或删除资源)的请求之后,服务器便会执行该操作并发送响应,此响应的格式通常为所指定资源的表示法。

在 Google 的 RESTful API 中,客户端使用 HTTP 谓词(例如 POSTGETPUTDELETE)指定操作。它通过以下格式的全局唯一 URI 来指定资源:

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

由于所有 API 资源都具有 HTTP 可访问的唯一 URI,因此 REST 启用了数据缓存,而且经过优化以与网络的分布式基础架构一起使用。

您可能会发现 HTTP 1.1 标准文档中的方法定义十分有用;这些定义中包含了 GETPOSTPUTDELETE 的规范。

Cloud Billing Budget API 中的 REST

Cloud Billing Budget API 操作可直接映射到 REST HTTP 谓词。

Cloud Billing Budget API URI 的具体格式为:

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

Cloud Billing Budget API 参考文档(RESTRPC)总结了用于 API 中各项受支持操作的全套 URI)。

了解 JSON 基础知识

Cloud Billing Budget API 返回 JSON 格式的数据。

JSON(JavaScript 对象表示法)是一种与语言无关的常见数据格式,可通过简单的文本来表示任意数据结构。如需了解详情,请参阅 json.org