Overview
The Deal Sync API leverages the Display & Video 360 negotiations pipeline. The API manages a one-way negotiation, where advertisers can accept or archive deals, but can't propose counter-changes in the UI.
Order
An Order is the top-level negotiation object; it can contain one or more products. The Order specifies the partner ID, which grants the DV360 partner access to view and manage the order in the DV360 UI.
Product
A Product represents a deal in its "proposed" stage. Each product has a 1:1
mapping with a deal identified by external_deal_id. An order can have one or
more products representing the set of deals proposed together. Sellers can't
directly create executable deals in Display & Video 360; instead, they create
an Order and Products using the Seller API.
Inventory Source
An Inventory Source represents the agreed deal object in Display & Video 360.
The deal is identified by external_deal_id during transaction time between
buy-side and sell-side platforms. An Inventory Source contains agreed terms
between advertisers and publishers, such as price, flight dates, and committed
impressions (for reservation deals). An Inventory Source is automatically
generated from the corresponding Product when the advertiser accepts the
negotiation pushed from the exchange.
Line Item
Line Items are the actual bidding and transacting objects. Line Items control which ads are served, when they are served, and to whom they are served. This is governed by settings configured at the Line Item level and prescribed by parent resources. Bidding on an Inventory Source is executed by the Line Items that target it. Line Items are managed by advertisers and aren't part of the Seller API offering.