傳送要求

本主題說明如何將幾個簡單的要求傳送至 Cloud Billing API。

如需完整的方法清單，請參閱 REST 或 RPC 的參考說明文件。

事前準備

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Billing API.

    Enable the API

  5. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
    2. Select your project.

    3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

    4. Click Create and continue.

    5. Grant the Project > Owner role to the service account.

      To grant the role, find the Select a role list, then select Project > Owner.

    6. Click Continue.

    7. Click Done to finish creating the service account.

      Do not close your browser window. You will use it in the next step.

  6. Create a service account key:

    1. In the Google Cloud console, click the email address for the service account that you created.
    2. Click Keys.
    3. Click Add key, and then click Create new key.
    4. Click Create. A JSON key file is downloaded to your computer.
    5. Click Close.

  7. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

  8. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  9. Make sure that billing is enabled for your Google Cloud project.

  10. Enable the Cloud Billing API.

    Enable the API

  11. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
    2. Select your project.

    3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

    4. Click Create and continue.

    5. Grant the Project > Owner role to the service account.

      To grant the role, find the Select a role list, then select Project > Owner.

    6. Click Continue.

    7. Click Done to finish creating the service account.

      Do not close your browser window. You will use it in the next step.

  12. Create a service account key:

    1. In the Google Cloud console, click the email address for the service account that you created.
    2. Click Keys.
    3. Click Add key, and then click Create new key.
    4. Click Create. A JSON key file is downloaded to your computer.
    5. Click Close.

  13. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

    14. 取得 Cloud Billing 帳戶清單

    在 API 中，列出所有 Cloud 帳單帳戶的 API 方法 (REST、RPC) 最為簡單。這個方法不需要任何參數，因此非常容易上手。不過請注意，這個方法僅會傳回您有權查看的所有帳單帳戶。

    通訊協定

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

    Java

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

    擷取特定 Cloud Billing 帳戶

    如要擷取特定帳單帳戶 (REST、RPC)，您必須先取得該帳單帳戶的 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

    如要啟用 Google Cloud 專案的 Cloud Billing，您必須呼叫 Cloud Billing API，將 Google Cloud 專案與現有的 Cloud Billing 帳戶建立關聯 (REST、RPC)。下列程式碼範例會將 Google Cloud 專案 tokyo-rain-123 與 Cloud Billing 帳戶 012345-567890-ABCDEF 建立關聯。順帶一提，只要將 billingAccountName 設為空白，即可使用相同的 API 方法，在 Google Cloud 專案中停用 Cloud Billing。

    通訊協定

    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. In the Google Cloud console, go to the Manage resources page.

      Go to Manage resources

    2. In the project list, select the project that you want to delete, and then click Delete.
    3. In the dialog, type the project ID, and then click Shut down to delete the project.