リクエストの送信

このトピックでは、簡単なリクエストを Cloud Billing API に送信する方法を説明します。

すべてのメソッドの一覧については、REST または RPC リファレンスドキュメントをご覧ください。

始める前に

Google Cloud アカウントにログインします。Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

注: この手順で作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。

プロジェクトセレクタに移動

Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する。

Cloud Billing API を有効にします。
API を有効にする

サービスアカウントを作成します。
1. Cloud Console で [サービスアカウントの作成] ページに移動します。
  [サービスアカウントの作成] に移動
2. プロジェクトを選択します。
3. [サービスアカウント名] フィールドに名前を入力します。Cloud Console は、この名前に基づいて [サービスアカウント ID] フィールドに入力します。
  
  [サービスアカウントの説明] フィールドに説明を入力します。例: Service account for quickstart
4. [作成] をクリックします。
5. [ロールを選択] フィールドをクリックします。
  
  [クイックアクセス] で [基本]、[オーナー] の順にクリックします。
  
  注: [ロール] フィールドは、プロジェクト内でサービスアカウントがアクセスできるリソースに影響します。これらのロールは後で取り消すことも、追加のロールを付与することもできます。本番環境では、オーナー、編集者、閲覧者のロールを付与しないでください。詳細については、リソースへのアクセス権の付与、変更、取り消しをご覧ください。
6. [続行] をクリックします。
7. [完了] をクリックして、サービスアカウントの作成を完了します。
  
  ブラウザウィンドウは閉じないでください。次のステップでこれを使用します。
サービスアカウントキーを作成します。
1. Cloud Console で、作成したサービスアカウントのメールアドレスをクリックします。
2. [キー] をクリックします。
3. [鍵を追加]、[新しい鍵を作成] の順にクリックします。
4. [作成] をクリックします。JSON キーファイルがパソコンにダウンロードされます。
5. [閉じる] をクリックします。

環境変数 GOOGLE_APPLICATION_CREDENTIALS を、サービスアカウントキーが含まれる JSON ファイルのパスに設定します。この変数は現在のシェルセッションにのみ適用されるため、新しいセッションを開く場合は、変数を再度設定します。
例: Linux または macOS
```
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
KEY_PATH をサービスアカウントキーが含まれる JSON ファイルのパスに置き換えます。

例:
```
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
```
例: Windows

PowerShell の場合:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
KEY_PATH をサービスアカウントキーが含まれる JSON ファイルのパスに置き換えます。

例:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
```
コマンドプロンプトの場合:
```
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
```
KEY_PATH をサービスアカウントキーが含まれる 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();

クリーンアップ

注意: プロジェクトを削除すると、次のような影響があります。

プロジェクト内のすべてのものが削除されます。このチュートリアルで既存のプロジェクトを使用した場合、それを削除すると、そのプロジェクトで行った他の作業もすべて削除されます。
カスタムプロジェクト ID が失われます。このプロジェクトを作成したときに、将来使用するカスタムプロジェクト ID を作成した可能性があります。そのプロジェクト ID を使用した URL（たとえば、appspot.com）を保持するには、プロジェクト全体ではなくプロジェクト内の選択したリソースだけを削除します。

複数のチュートリアルとクイックスタートを検討する予定がある場合は、プロジェクトを再利用すると、プロジェクトの割り当て制限を超えないようにできます。

Cloud Console で [リソースの管理] ページに移動します。
[リソースの管理] に移動
プロジェクトリストで、削除するプロジェクトを選択し、[削除] をクリックします。
ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックしてプロジェクトを削除します。