Cloud Billing Budget API の前提条件

最初の Cloud Billing Budget アプリケーションのコーディングを開始する前に、行うことがいくつかあります。

Google Cloud Console で Cloud Billing の機能を試してみる

この API ドキュメントは、Google Cloud を使用していて、Google Cloud Console の Cloud Billing の機能とコンセプトについて理解していることが前提となります。まだ Cloud 請求先アカウント、Google Cloud プロジェクト、Google Cloud プロダクト、Cloud Billing の予算とアラートなどのコンセプトに慣れていない場合は、コーディングを開始する前に、これらのお支払いとご請求に関するドキュメントをお読みください。

Cloud Billing の機能とコンセプトを理解したら、Cloud Console のユーザー インターフェースをお試しください。

Cloud Billing の主なコンセプト

  • 1 つの Cloud 請求先アカウントに、多数の予算を関連付けることが可能です(一度に最大 5,000 件の予算が関連付けられます)。
  • 予算は一度に 1 つの Cloud 請求先アカウントのみにリンクされます。
  • 1 つの Cloud 請求先アカウントが 1 つ以上の Google Cloud プロジェクトにリンクされ、料金が発生します。
  • Google Cloud プロジェクトは、一度に 1 つの Cloud 請求先アカウントのみにリンクされます。
  • 予算を作成し、その請求アカウントで支払うすべての Google Cloud プロジェクトを含めて、Cloud 請求先アカウント全体の費用をモニタリングできます。また、きめ細かい予算のフィルタを使用して、Google Cloud のプロジェクトやサービスのグループにまたがって費用の特定のスライスを監視することもできます。

REST の基礎を学習する

Cloud Billing Budget API は次の 2 つの方法で呼び出すことが可能です。

近日提供予定: Google がサポートする Cloud Billing Budget API のクライアント ライブラリが、複数のよく使われている言語でご利用いただけるようになります。クライアント ライブラリでは、言語の統合性が高く、セキュリティも強化されています。また、ユーザーの承認が必要な呼び出しもサポートしています。

クライアント ライブラリをご利用いただけるようになるまで、REST の基礎を理解する必要があります。

REST は、データをリクエストして変更するための便利で一貫したアプローチを提供するソフトウェア アーキテクチャのスタイルです。

REST という用語は「Representational State Transfer」の省略形です。Google API のコンテキストでは、HTTP 動詞を使用して、Google が保存しているデータ表現を取得および変更することを表しています。

RESTful システムでは、リソースはデータストアに保存されており、クライアントはサーバーが特定のアクション(リソースの作成、取得、更新、削除など)を実行するようにリクエストを送信し、サーバーはそのアクションを実行し、多くの場合、指定されたリソースの表現形式でレスポンスを送信します。

Google の RESTful API では、クライアントは POSTGETPUTDELETE などの HTTP 動詞を使用してアクションを指定します。また、次の形式のグローバルに一意な URI でリソースを指定します。

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

すべての API リソースは HTTP でアクセス可能な一意の URI を持っているため、REST はデータ キャッシュを有効にし、ウェブの分散インフラストラクチャで動作するように最適化されています。

HTTP 1.1 標準のドキュメントのメソッド定義をご覧ください。GETPOSTPUTDELETE の仕様が記載されています。

Cloud Billing Budget API の REST

Cloud Billing Budget API オペレーションは REST の HTTP 動詞に直接マッピングされています。

Cloud Billing Budget API URI の特定の形式:

https://billingbudgets.googleapis.com/v1beta1/resourcePath?parameters

API でサポートされている各オペレーションで使用される URI の完全なセットは、Cloud Billing Budget API リファレンス ドキュメント(RESTRPC){: track-type="tasks" track-name="internalLink" track-metadata-position="body" } にまとめられています。

JSON の基礎を学習する

Cloud Billing Budget API では、データは JSON 形式で返されます。

JSON(JavaScript Object Notation)は言語に依存しない一般的なデータ フォーマットであり、任意のデータ構造を単純なテキスト形式で表示します。詳しくは json.org をご覧ください。