このトピックでは、簡単なリクエストを Cloud Billing API に送信する方法を説明します。
すべてのメソッドの一覧については、REST または RPC リファレンス ドキュメントをご覧ください。
始める前に
- Google アカウントにログインします。
Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。
-
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
-
Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する。
- Cloud Billing API を有効にします。
- 認証の設定:
-
Cloud Console で、[サービス アカウント キーの作成] ページに移動します。
[サービス アカウント キーの作成] ページに移動 - [サービス アカウント] リストから [新しいサービス アカウント] を選択します。
- [サービス アカウント名] フィールドに名前を入力します。
[ロール] リストから、プロジェクト > オーナー
- [作成] をクリックします。キーが含まれている JSON ファイルがパソコンにダウンロードされます。
-
-
環境変数
GOOGLE_APPLICATION_CREDENTIALS
を、サービス アカウント キーが含まれる JSON ファイルのパスに設定します。 この変数は現在のシェル セッションにのみ適用されるため、新しいセッションを開く場合は、変数を再度設定します。
Cloud 請求先アカウントのリストを取得する
すべての Cloud 請求先アカウントを一覧表示する API メソッド(REST、RPC)には必須パラメータがありません。API で最もシンプルなメソッドであり、リクエストの送信を試してみるのにちょうどよいものとなっています。このメソッドは、表示する権限を持っているすべての請求先アカウントを返します。
プロトコル
GET https://cloudbilling.googleapis.com/v1/billingAccounts
Java
ListBillingAccountsResponse result = service.billingAccounts().list().execute();
特定の Cloud 請求先アカウントを取得する
特定の請求先アカウントを取得する(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 を有効にする
Cloud プロジェクトに対して Cloud Billing を有効にするには、Cloud Billing API を呼び出し、Cloud プロジェクトを既存の Cloud 請求先アカウントに関連付ける必要があります(REST、RPC)。次のサンプルコードは、Cloud プロジェクト tokyo-rain-123
を Cloud 請求先アカウント 012345-567890-ABCDEF
に関連付けます。ちなみに、billingAccountName
の設定を空にしておくことで、同じ API メソッドを使って 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();
クリーンアップ
- Cloud Console で [リソースの管理] ページに移動します。
- プロジェクト リストで、削除するプロジェクトを選択し、[削除] をクリックします。
- ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックしてプロジェクトを削除します。