API ワークフロー

取引を作成する

1. 外部取引 ID フィルタを使用して商品を LIST し、商品がすでに作成されているかどうかを確認します。External_deal_id はすべての商品で一意である必要があります。

   GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
   

2. [Create Order]（注文を作成）をクリックします。名前は DV3 によって生成されます。この ID は、後で取得できるようにシステム内のどこかに保存しておくことをおすすめします。

3. 注文の下に商品を作成します。プロダクト名は DV3 によって生成されます。この ID は、後で取得できるように、システム内のどこかに保存しておくことをおすすめします。

   または、external_deal_id を使用して LIST を実行することもできます。名前フィールドには注文 ID と商品 ID の両方が含まれているため、この方法で親を簡単に識別できます。

取引をキャンセルする

1. 注文ステータスを [キャンセル] に更新 注文が承認されていない場合にのみキャンセルをサポートします。[Cancelled]（キャンセル済み）は最終状態です。注文をキャンセルすると、再度有効にすることはできません。

取引の詳細を取得する

1. 注文の詳細を取得します。ステータスは、ユーザーが注文を承認、アーカイブ、キャンセルすると更新されます。
2. プロダクトの詳細を取得します。

取引のリストを取得する

1. ステータス フィルタを使用して LIST 注文を行い、承認済みまたは承認待ちのすべての注文を取得します。
2. external_deal_id フィルタを使用して商品を一覧表示します。
3. 注文内のすべての商品を一覧表示します。

ディールを更新する

1. パブリッシャーの連絡先情報の注文を更新します。
   1. name は更新できません（field_mask で設定できません）。ステータスは API を介してのみ [Canceled] に設定できます。
   2. partner_id は更新できません。
2. 特定の取引条件の更新について、商品を更新します。
   1. name、externalDealId、transactionType、pricingType、updateTime は更新できません。
   2. displayName の更新にはユーザーの同意は必要ありません。
   3. rateDetails と creativeConfig を更新すると、親注文のステータスが [承認待ち] に変わります。DV3 広告主様には、以前の注文が承認されたかどうかに関係なく、交渉ページで新しい条件に同意していただくようお願いしています。

ユーザーが取引を承認したかどうかを確認する

1. 対応する注文 ID がわかっている場合は、Get Order を使用します。ステータス フィールドを確認します。
2. 注文 ID がトラッキングされていない場合: external_deal_id フィルタを使用して商品を一覧表示し、商品名から注文名を特定してから、注文を取得します。ステータス フィールドを確認します。

ユーザーがセール情報を設定しているかどうかを確認する（PG のみ）

1. 広告枠ソースを取得します。名前は「exchanges/{exchangeId}/inventorysources/{external_deal_id}」です。購入者のステータスを確認してください。
   1. 予約のお得情報
      1. BUYER_STATUS_ACTIVE は、取引が承認され、設定されていることを意味します。この状態では、DV360 が取引条件に一致する入札リクエストを受信すると、取引で費用が発生します。広告申込情報は、取引構成の手順で自動的に生成されます。詳しくは、取引の設定をご覧ください。
      2. BUYER_STATUS_PENDING は、注文は受け付けられたものの、取引がまだ設定されていないことを意味します。この状態では費用は発生しません。
      3. BUYER_STATUS_PAUSED は、広告主様によって取引が明示的に一時停止されたことを意味します。この状態では費用は発生しません。
   2. 予約以外の取引
      1. BUYER_STATUS_ACTIVE は、取引が承認されたことを意味します。この状態では、DV360 が取引条件に一致する入札リクエストを受け取り、この取引をターゲットに設定している有効な広告申込情報があり、入札リクエストが広告申込情報のターゲティング条件に一致する場合に、取引で費用が発生します。詳しくは、広告申込情報をご覧ください。** 広告申込情報で取引がターゲットに設定されているかどうかをクエリする Seller API はありません。**
      2. BUYER_STATUS_PENDINGの対象外です。
      3. BUYER_STATUS_PAUSED は、広告主様によって取引が明示的に一時停止されたことを意味します。この状態では費用は発生しません。

取引を一時停止または一時停止解除する

1. 広告枠ソースの更新販売者のステータス。
   1. 一時停止/一時停止の解除は、取引の配信には影響しません。販売者が取引を一時停止すると、広告主には参考情報として文字列メッセージのみが表示されます。これにより、広告主様は費用が発生していない取引のトラブルシューティングを行うことができます。

再交渉（承認後に取引を更新）

再交渉とは、購入者が取引を承認した後に取引に更新を加えることを指します。この機能は、エクスチェンジと購入者の両方が、承認済みのディールに新しい変更をプッシュする際に非常に便利です。たとえば、取引所は、承認済みの取引の終了時刻が正しくないことを検出し、取引がまだ開始されていない場合は、DV3 Update Product を使用して DV3 バイヤーに更新をプッシュできます。

許可される変更と許可されない変更。

取引の各段階で許可される変更と許可されない変更については、こちらをご覧ください。