リクエストの送信

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

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

始める前に

1. Google アカウントにログインします。

   Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。

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

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

   [プロジェクトの選択] ページに移動

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

4. Cloud Billing API を有効にします。

   API を有効にする

5. 認証の設定:

   1. Cloud Console で、[サービス アカウント キーの作成] ページに移動します。

      [サービス アカウント キーの作成] ページに移動
   2. [サービス アカウント] リストから [新しいサービス アカウント] を選択します。
   3. [サービス アカウント名] フィールドに名前を入力します。

   4. [ロール] リストから、プロジェクト > オーナー

      注: [ロール] フィールドは、サービス アカウントがプロジェクト内のどのリソースにアクセスできるかに影響します。これらのロールは後で取り消すことも、追加のロールを付与することもできます。本番環境では、オーナー、編集者、閲覧者のロールを付与しないでください。詳細については、リソースへのアクセス権の付与、変更、取り消しをご覧ください。
   5. [作成] をクリックします。キーが含まれている JSON ファイルがパソコンにダウンロードされます。

6. 環境変数 GOOGLE_APPLICATION_CREDENTIALS を、サービス アカウント キーが含まれる JSON ファイルのパスに設定します。 この変数は現在のシェル セッションにのみ適用されるため、新しいセッションを開く場合は、変数を再度設定します。

   例: Linux または macOS

   [PATH] をサービス アカウント キーが含まれる JSON ファイルのパスに置き換えます。

   export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

   例:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   例: Windows

   [PATH] をサービス アカウント キーが含まれる JSON ファイルのパスに置き換えます。

   PowerShell を使用する場合:

   $env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

   例:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\my-key.json"

   コマンド プロンプトを使用する場合:

   set GOOGLE_APPLICATION_CREDENTIALS=[PATH]

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）を保持するには、プロジェクト全体ではなくプロジェクト内の選択したリソースだけを削除します。

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

1. Cloud Console で [リソースの管理] ページに移動します。

   [リソースの管理] に移動

2. プロジェクト リストで、削除するプロジェクトを選択し、[削除] をクリックします。
3. ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックしてプロジェクトを削除します。