前提条件

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

Google Cloud コンソールで Cloud Billing の機能を試してみる

この API ドキュメントは、Google Cloud を使用していて、Google Cloud コンソールの Cloud Billing の機能とコンセプトについて理解していることを前提としています。

まだ Cloud 請求先アカウントや Google Cloud プロジェクトなどのコンセプトに慣れていない場合は、コーディングを開始する前にユーザーインターフェースをお試しください。

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

クライアントライブラリを使用しない場合は、REST の基礎を理解する必要があります。

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

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

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

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

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

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

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

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

Cloud Billing API URI の特定の形式:

https://www.googleapis.com/billing/v1/resourcePath?parameters

API でサポートされている各オペレーションで使用される URI の完全なセットは、Cloud Billing API リファレンスドキュメント（REST、RPC）にまとめられています。

Cloud Billing API はデータを JSON 形式で返します。

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