发送请求

本主题介绍了如何向 Cloud Billing API 发送一些简单的请求。

如需查看完整的方法列表,请参阅 RESTRPC 参考文档。

准备工作

  1. 登录您的 Google 帐号。

    如果您还没有 Google 帐号,请注册一个新帐号

  2. 在 Cloud Console 的项目选择器页面上,选择或创建 Cloud 项目。

    转到项目选择器页面

  3. 确保您的 Google Cloud 项目已启用结算功能。 了解如何确认您的项目已启用结算功能

  4. 启用 Cloud Billing API。

    启用 API

  5. 设置身份验证:
    1. 在 Cloud Console 中,转到创建服务帐号密钥页面。

      转到“创建服务帐号密钥”页面
    2. 服务帐号列表中,选择新的服务帐号
    3. 服务帐号名称字段中,输入一个名称。
    4. 角色列表中,选择项目 > Owner

      注意角色字段会为您的服务帐号授予资源访问权限。您稍后可以使用 Cloud Console 查看和更改此字段。如果您开发的是正式版应用,请指定比项目 > Owner 更为精细的权限。如需了解详情,请参阅为服务帐号授予角色
    5. 点击创建。包含密钥的 JSON 文件就会下载到计算机。
  6. 将环境变量 GOOGLE_APPLICATION_CREDENTIALS 设置为包含您的服务帐号密钥的 JSON 文件的路径。 此变量仅适用于当前的 shell 会话,因此,如果您打开新的会话,请重新设置该变量。

获取 Cloud Billing 帐号列表

列出所有 Cloud Billing 帐号(RESTRPC)的 API 方法是 API 中最简单的方法,因为该方法无需设置参数,所以很适合用来入门。该方法会直接返回您有权查看的所有结算帐号。

协议

GET https://cloudbilling.googleapis.com/v1/billingAccounts

Java

    ListBillingAccountsResponse result = service.billingAccounts().list().execute();

检索特定的 Cloud Billing 帐号

若要检索特定的结算帐号(RESTRPC),您需要知道结算帐号 ID。本示例使用示例 ID 012345-567890-ABCDEF

协议

GET https://cloudbilling.googleapis.com/v1/billingAccounts/012345-567890-ABCDEF

Java

    BillingAccount result = service.billingAccounts()
        .get("billingAccounts/00C5EA-61187E-D842F2").execute();

在 Google Cloud 项目中启用 Cloud Billing

若要对 Cloud 项目启用 Cloud Billing 功能,您需要调用 Cloud Billing API 以将该 Cloud 项目与现有的 Cloud Billing 帐号相关联(RESTRPC)。下面的示例代码会将 Cloud 项目 tokyo-rain-123 与 Cloud Billing 帐号 012345-567890-ABCDEF 相关联。顺便提一下,若要对 Cloud 项目停用 Cloud Billing 功能,也可采用相同的 API 方法,只需将 billingAccountName 设置为空即可。

协议

PUT https://cloudbilling.googleapis.com/v1/projects/tokyo-rain-123/billingInfo

{
  "billingAccountName": "billingAccounts/012345-567890-ABCDEF"
}

Java

    service.projects().updateBillingInfo(
            "projects/tokyo-rain-123",
            new ProjectBillingInfo().setBillingAccountName("billingAccounts/012345-567890-ABCDEF"))
        .execute();

清理

  1. 在 Cloud Console 中,转到管理资源页面。

    转到“管理资源”页面

  2. 在项目列表中,选择要删除的项目,然后点击删除
  3. 在对话框中输入项目 ID,然后点击关闭以删除项目。