本主題說明如何將幾個簡單的要求傳送至 Cloud Billing API。
如需完整的方法清單,請參閱 REST 或 RPC 的參考說明文件。
事前準備
-
In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Cloud de Confiance project.
Enable the Cloud Billing API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.-
Create a service account:
-
Ensure that you have the Create Service Accounts IAM role
(
roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles. -
In the Cloud de Confiance console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Cloud de Confiance 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. - Click Create and continue.
-
Grant the Project > Owner role to the service account.
To grant the role, find the Select a role list, then select Project > Owner.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
Ensure that you have the Create Service Accounts IAM role
(
-
Create a service account key:
- In the Cloud de Confiance console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
-
Set the environment variable
GOOGLE_APPLICATION_CREDENTIALSto 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.
取得 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();
啟用 Cloud de Confiance 專案的 Cloud Billing
如要啟用 Cloud de Confiance 專案的 Cloud Billing,您必須呼叫 Cloud Billing API,將 Cloud de Confiance 專案與現有的 Cloud Billing 帳戶建立關聯 (REST、RPC)。下列程式碼範例會將專案 tokyo-rain-123 與 Cloud Billing 帳戶 012345-567890-ABCDEF 建立關聯。 Cloud de Confiance 順帶一提,只要將 billingAccountName 設為空白,即可使用相同的 API 方法在 Cloud de Confiance 專案中停用 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();清除所用資源
- 前往 Cloud de Confiance 控制台的「Manage resources」(管理資源) 頁面。
- 在專案清單中選取要刪除的專案,然後點選「Delete」(刪除)。
- 在對話方塊中輸入專案 ID,然後按一下 [Shut down] (關閉) 以刪除專案。