最初のクライアント アプリケーションのコーディングを開始する前に、行うことがいくつかあります。
Google アカウントを取得する
Google API Console でプロジェクトを作成するには、Google アカウントが必要です。すでにアカウントをお持ちの場合は、準備が整っています。
テスト用に別の Google アカウントを取得することもできます。
Google 広告に関する問題レポートをお試しください
この API ドキュメントは、Google 広告に関する問題レポートを使用し、ウェブ プログラミングの概念とウェブデータ形式に精通していることを前提としています。
Google 広告に関する問題レポートをまだ使用したことがない場合は、コーディングを開始する前に管理画面をお試しください。
クライアントのプロジェクトを作成する
Google 広告に関する問題レポートにリクエストを送信するには、クライアントについて Google に情報を送信し、API へのアクセス権を有効にする必要があります。これを行うには、Google API Console を使用してプロジェクト(設定と API アクセス情報の名前付きコレクション)を作成し、アプリケーションを登録します。
REST の基礎を学習する
API は次の 2 つの方法で呼び出すことができます。
- HTTP リクエストを送信し、レスポンスを解析する。
- クライアント ライブラリを使用する。
クライアント ライブラリを使用しない場合は、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
の仕様が記載されています。
Google Ad Experience Report API の REST
Google Ad Experience Report API のオペレーションは、REST HTTP 動詞に直接マッピングされます。
Google Ad Experience Report API の URI は、次のような形式になります。
https://adexperiencereport.googleapis.com/v1/resourcePath?parameters
API でサポートされている各オペレーションで使用される URI の一覧については、Google Ad Experience Report API リファレンス ドキュメントをご覧ください。
JSON の基礎を学習する
Google Ad Experience Report API は JSON 形式でデータを返します。
JSON(JavaScript Object Notation)は言語に依存しない一般的なデータ フォーマットで、任意のデータ構造を単純なテキスト形式で表すことができます。詳しくは json.org をご覧ください。