Deals API for Suppliers¶
The BidSwitch Deals API integrates with Deal Management APIs of Buyers that are connected to BidSwitch, allowing BidSwitch connected Suppliers to push private or open deals to just one API. BidSwitch will then propogate the submitted Deals information to the specified Buyer and also ensure that all of the details are correct so that at time of delivery there should be no technically impediments to prevent the deal from running successfully.
Get your API Access Token, which will be passed in the request header. If you do not have an API token or user account, use the steps outlined in the API Authorization section. If you have Read Only permissions you may only user
GETqueries. Request an API Account to access all API methods.
Retrieve or update deal details from the relevant API depending on your integration, see either the V1 Deals API for Buyers or dpa-dsps-v2 section.
When you push deal updates, BidSwitch makes these available to your partner Buyers also using the API. The details are also made available in spreadsheet format for partners not using an API.
Your system should pull regularly from the Deals API to get updates from Suppliers.
For complete details of changes listed here, see either the V1 Deals API for Suppliers or dpa-v2 section. You should consider changes to field functionality or definitions applicable to both API versions unless explicitly stated.
Updated the details about which fields can be changed when trading with Google after a deal has been accepted, see the dv360-notes for full details.
Simplified working with
end_timeby removing some restrictions.
API V2 introduced with the concept of managing different active revisions of a deal, see the dpa-v2 section for details
deals.revision_idadded to track the number of revisions a deal has been through, see the V1 Deals API for Suppliers section for more details
rejectedadded as a possible deal status, see the field description for details.
dsp_note, see the field description for details.
publisher_idas a field name
inventory_sourcevalidation, see the field description for details.
Added support for Native inventory
deal_id validation, see the field description for details.