API ワークフロー

このガイドでは、ディスプレイ＆ビデオ 360 でオークション パッケージを作成、取得、更新するための一般的な API ワークフローについて説明します。

オークション パッケージのリストを取得する

LIST API を呼び出します。external_deal_idによるフィルタリングをサポートしています。

新しいオークション パッケージを作成する

  1. external_deal_id は一意である必要があります。ID が既に使用されているかどうかを確認するには、LIST 関数をexternal_deal_idを指定して呼び出してください。
  2. Create API を呼び出します。 一意の名前が割り当てられ、作成されたパッケージの取得に使用できます。
  3. Get API を呼び出して、作成したオークション パッケージの詳細を確認します。
  4. 必要に応じて、作成したパッケージのロゴをアップロードします。

オークション パッケージを更新する

  1. 作成したオークションパッケージ名を保存しない場合は、LIST API を呼び出し、external_deal_id でフィルタリングして、更新したいオークションパッケージを取得します。
  2. LIST API の結果に基づいてフィールドを更新します。
  3. Patch API を呼び出して、オークション パッケージを更新します。updateMask は必須です。更新を適用するフィールドを指定します。更新が許可されているフィールドのみをupdateMaskに設定できます。

ベータプロセス

ベータ版と GA 版の唯一の違いは、ベータ版では、作成されたオークション パッケージのステータスを DISCOVERY_OBJECT_STATUS_PAUSED に設定する必要があり、ステータスを更新できないことです。一時停止中のパッケージは、ディスプレイ＆ビデオ 360 の UI に表示されません。これにより、取引所はテスト パッケージを表示せずに API 統合をテストできます。

ベータ版の「実際の」パッケージをすべて PAUSED として作成し、GA で一度だけ有効にするのが一般的です。

割り当て

エクスチェンジごとに 2,000 個のアクティブなパッケージ。

エクスチェンジごとに 2,000 個のパッケージを一時停止できます。

前へ
概要