このページは Cloud Translation API によって翻訳されました。

背景

始める前に

アカウントに適切な権限を設定するよう、アカウント担当者に依頼してください指定する必要があります。
認定バイヤーの仕組みに詳しくない方は、認定バイヤーヘルプセンター管理画面でテストすることもできます。アプリケーションでリアルタイムビッダーを実行することを想定している場合は、 RTB プロトコルのドキュメントをご覧ください。
詳しくは、 API Console 新しいプロジェクトを設定します。デベロッパーの Google アカウントにログインするか、アカウントを作成その後、プロジェクトを作成して承認するように求められます。いくつかの利用規約が適用されます

親アカウントとお子様用アカウント

親と子を含むアカウント構造で作業している場合どのような仕組みになっているかを理解しておくと、より効果的な業務を行える可能性があります。やり取りできます。概要は次のとおりです。

子アカウント

お子様のアカウントへのアクセスを許可する認証情報を持つユーザーは、アカウントに関連付けられたリソースを表示および変更できます。お子様のアカウントでは他の子アカウントまたは親アカウントに属するリソースの表示や変更を行うことができます。

親アカウント

親アカウントへのアクセスを許可する認証情報を持つユーザーは、関連付けられているすべてのリソースに加え、親アカウントの子アカウント。特定のリソースのすべてを一覧表示するオペレーションの場合、このユーザーは応答が返されます。これには、各自のアカウントとすべての子アカウント。なお、チャイルドシートのリソースをターゲットとするその他のタイプのリクエストでは、親アカウントでは、子の accountId パスパラメータを指定する必要があります。独自のaccountIdではなく、異なるアカウントを使用できます。

REST API データモデル

リソースとは、一意の識別子を持つ個別のデータエンティティです。「アカウントリソースは、認定バイヤーアカウントのエントリを表し、 Ad Exchange Buyer API 用のデータクラスです。API のメソッドは個々の Accounts リソース、および Accounts リソースのコレクションに対する権限です。

アカウントリソースには、アカウント ID、Cookie マッチングに使用される情報、入札者のロケーション、入札リクエストの送信先 URL、リクエストを使用して、Ad Exchange から送信される 1 秒あたりの最大クエリ数を指定する。

Accounts リソースとコレクションに加えて、Ad Exchange Buyer API では次のデータ構造を定義します。

ビッダーの地域

ビッダーのロケーションは、アカウントリソースで返される構造です。 Ad Exchange からの入札リクエストの送信先 URL と、 Ad Exchange が 1 秒あたりに送信するクエリの最大数。こちらの JSON で表現されたビッダーの場所の例:

"bidderLocation": [
    {
      "url": "http://bid.url.com/bidder",
      "maximumQps": 1500
    }
  ],

アイテム

アイテムでは、アカウントのリストが表示されます。JSON で表現したアイテムの例を次に示します。

{
  "kind": "adexchangebuyer#accountsList",
  "items": [
    accounts Resource
  ]
}

サポートされているオペレーション

コレクションとリソースに対して、次の 3 種類のメソッドを呼び出すことができます。 Ad Exchange Buyer API を使用することは、次の表のとおりです。すべてのオペレーションで認証。

オペレーション	説明	REST HTTP マッピング
list	現在認証されているユーザーがアクセスできるすべてのアカウントの一覧を取得しますできます。	コレクション URI に対する `GET`。
get	特定の Accounts リソースを取得します。	リソース URI に対する `GET`。
update	特定の Accounts リソースを更新します。	リソース URI に対する `PUT`。ここでは、確認できます。

呼び出しのスタイル

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 の仕様が記載されています。

Ad Exchange Buyer API の REST

サポートされているオペレーションは REST の HTTP 動詞に直接マッピングされています。詳細は、 API オペレーション。

API URI の具体的な形式は次のとおりです。

https://www.googleapis.com/adexchangebuyer/v1.4/resourceID?parameters

ここで、resourceID は Cloud Storage のアカウントリソース、parameters は、パラメータを指定します。詳しくは、標準のクエリパラメータおよびリファレンスドキュメントをご覧ください。

resourceID パス拡張の形式を使用すると、現在操作しているリソースを特定できます。次に例を示します。

https://www.googleapis.com/adexchangebuyer/v1.4/accounts
https://www.googleapis.com/adexchangebuyer/v1.4/accounts/id

API でサポートされている各オペレーションで使用される URI の完全なセットは、まとめられていますリファレンスドキュメントをご覧ください。

Ad Exchange Buyer API での動作の例を次に示します。

認証されたユーザーのアカウントのリストを取得します。

GET https://www.googleapis.com/adexchangebuyer/v1.4/accounts

データ形式

JSON

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